docs(schema): document type/description frontmatter in AGENTS_MD

Author: KylinMountain

openkb/schema.py

@@ -48,7 +48,13 @@
 - Use [[wikilink]] to link other wiki pages (e.g., [[concepts/attention]])
 - Standard Markdown heading hierarchy
 - Keep each page focused on a single topic
-- Do not include YAML frontmatter (---) in generated content; it is managed by code
+
+## Frontmatter (managed by code — do NOT emit it in generated content)
+- Every summary/concept/entity page carries a non-empty `type:` — `Summary`,
+  `Concept`, or a capitalized entity subtype (e.g. `Organization`). This is the
+  one field OKF requires; consumers use it for routing/filtering/presentation.
+- `description:` — a single-sentence one-liner (the field formerly named `brief`).
+- Do not include YAML frontmatter (---) in generated content; it is managed by code.
 """
 
 # Backward compat alias

tests/test_schema.py

@@ -0,0 +1,10 @@
+"""Tests for openkb.schema constants (wiki AGENTS_MD schema doc)."""
+from openkb.schema import AGENTS_MD
+
+
+def test_agents_md_documents_type_and_description():
+    # The new OKF-aligned frontmatter fields must be documented.
+    assert "type:" in AGENTS_MD
+    assert "description:" in AGENTS_MD
+    # The code-manages-frontmatter contract must remain intact.
+    assert "managed by code" in AGENTS_MD