init: document-haness 하네스 설계

2026-07-24 13:58:08 +09:00
parent d6f78f92a0
commit c39406bbdd
219 changed files with 7010 additions and 20052 deletions
@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://claridoc.local/schemas/brief.schema.json",
+  "title": "ClariDoc document brief",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["title", "document_type", "audience", "reader_goal", "core_message", "scope"],
+  "properties": {
+    "title": {"type": "string", "minLength": 1},
+    "document_type": {
+      "type": "string",
+      "enum": ["technical_blog", "tutorial", "how_to", "explanation", "reference", "troubleshooting", "design_doc"]
+    },
+    "language": {"type": "string", "minLength": 1, "default": "ko-KR"},
+    "audience": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["roles"],
+      "properties": {
+        "roles": {"$ref": "#/$defs/nonEmptyStringArray"},
+        "prior_knowledge": {"$ref": "#/$defs/stringArray"},
+        "needs": {"$ref": "#/$defs/stringArray"}
+      }
+    },
+    "reader_goal": {"type": "string", "minLength": 1},
+    "core_message": {"type": "string", "minLength": 1},
+    "scope": {"$ref": "#/$defs/nonEmptyStringArray"},
+    "non_scope": {"$ref": "#/$defs/stringArray"},
+    "prerequisites": {"$ref": "#/$defs/stringArray"},
+    "required_topics": {"$ref": "#/$defs/stringArray"},
+    "constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "target_words": {"type": "integer", "minimum": 200, "maximum": 30000, "default": 1600},
+        "tone": {"type": "string", "minLength": 1, "default": "professional and direct"},
+        "version_context": {"type": "string"},
+        "max_heading_depth": {"type": "integer", "minimum": 2, "maximum": 6, "default": 3},
+        "require_citations": {"type": "boolean", "default": true},
+        "allow_external_knowledge": {"type": "boolean", "default": false}
+      }
+    },
+    "forbidden_claims": {"$ref": "#/$defs/stringArray"},
+    "metadata": {"type": "object"}
+  },
+  "$defs": {
+    "stringArray": {"type": "array", "items": {"type": "string", "minLength": 1}, "uniqueItems": true},
+    "nonEmptyStringArray": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}, "uniqueItems": true}
+  }
+}