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,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://claridoc.local/schemas/review.schema.json",
+  "title": "ClariDoc model review response",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "score",
+    "dimension_scores",
+    "issues",
+    "strengths",
+    "questions"
+  ],
+  "properties": {
+    "score": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "dimension_scores": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "reader_goal_alignment",
+        "information_architecture",
+        "logical_flow",
+        "cognitive_load",
+        "evidence_traceability",
+        "example_verifiability",
+        "scannability",
+        "operational_safety",
+        "completeness_and_limits"
+      ],
+      "properties": {
+        "reader_goal_alignment": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "information_architecture": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "logical_flow": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "cognitive_load": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "evidence_traceability": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "example_verifiability": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "scannability": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "operational_safety": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "completeness_and_limits": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "section",
+          "problem",
+          "why_it_matters",
+          "fix",
+          "severity"
+        ],
+        "properties": {
+          "section": {
+            "type": "string"
+          },
+          "problem": {
+            "type": "string",
+            "minLength": 1
+          },
+          "why_it_matters": {
+            "type": "string",
+            "minLength": 1
+          },
+          "fix": {
+            "type": "string",
+            "minLength": 1
+          },
+          "severity": {
+            "type": "string",
+            "enum": [
+              "blocker",
+              "error",
+              "warning",
+              "info"
+            ]
+          }
+        }
+      }
+    },
+    "strengths": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "questions": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  }
+}