chore: 문서를 작성할 때 한국어의 표현 작성 스킬 추가 및 1인칭 관점의 글 작성 검증 테스트 추가

2026-07-29 16:48:03 +09:00
parent c39406bbdd
commit 41501b5d06
520 changed files with 95494 additions and 2231 deletions
@@ -4,47 +4,156 @@
  "title": "ClariDoc document brief",
  "type": "object",
  "additionalProperties": false,
-  "required": ["title", "document_type", "audience", "reader_goal", "core_message", "scope"],
+  "required": [
+    "title",
+    "document_type",
+    "audience",
+    "reader_goal",
+    "core_message",
+    "scope"
+  ],
  "properties": {
-    "title": {"type": "string", "minLength": 1},
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
    "document_type": {
      "type": "string",
-      "enum": ["technical_blog", "tutorial", "how_to", "explanation", "reference", "troubleshooting", "design_doc"]
+      "enum": [
+        "technical_blog",
+        "tutorial",
+        "how_to",
+        "explanation",
+        "reference",
+        "troubleshooting",
+        "design_doc"
+      ]
+    },
+    "language": {
+      "type": "string",
+      "minLength": 1,
+      "default": "ko-KR"
    },
-    "language": {"type": "string", "minLength": 1, "default": "ko-KR"},
    "audience": {
      "type": "object",
      "additionalProperties": false,
-      "required": ["roles"],
+      "required": [
+        "roles"
+      ],
      "properties": {
-        "roles": {"$ref": "#/$defs/nonEmptyStringArray"},
-        "prior_knowledge": {"$ref": "#/$defs/stringArray"},
-        "needs": {"$ref": "#/$defs/stringArray"}
+        "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"},
+    "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}
+        "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
+        },
+        "citation_style": {
+          "type": "string",
+          "enum": [
+            "hidden",
+            "footnote",
+            "inline_link",
+            "source_id"
+          ],
+          "default": "hidden"
+        },
+        "date_policy": {
+          "type": "string",
+          "enum": [
+            "only_when_material",
+            "always",
+            "never"
+          ],
+          "default": "only_when_material"
+        },
+        "style_profile": {
+          "type": "string",
+          "minLength": 1,
+          "default": "auto"
+        }
      }
    },
-    "forbidden_claims": {"$ref": "#/$defs/stringArray"},
-    "metadata": {"type": "object"}
+    "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}
+    "stringArray": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    },
+    "nonEmptyStringArray": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    }
  }
 }
@@ -4,12 +4,27 @@
  "title": "ClariDoc outline contract",
  "type": "object",
  "additionalProperties": false,
-  "required": ["title", "document_type", "sections"],
+  "required": [
+    "title",
+    "document_type",
+    "sections"
+  ],
  "properties": {
-    "title": {"type": "string", "minLength": 1},
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
    "document_type": {
      "type": "string",
-      "enum": ["technical_blog", "tutorial", "how_to", "explanation", "reference", "troubleshooting", "design_doc"]
+      "enum": [
+        "technical_blog",
+        "tutorial",
+        "how_to",
+        "explanation",
+        "reference",
+        "troubleshooting",
+        "design_doc"
+      ]
    },
    "sections": {
      "type": "array",
@@ -17,19 +32,67 @@
      "items": {
        "type": "object",
        "additionalProperties": false,
-        "required": ["id", "intent", "title", "reader_question", "purpose"],
+        "required": [
+          "id",
+          "intent",
+          "title",
+          "reader_question",
+          "purpose"
+        ],
        "properties": {
-          "id": {"type": "string", "minLength": 1},
-          "intent": {"type": "string", "minLength": 1},
-          "title": {"type": "string", "minLength": 1},
-          "reader_question": {"type": "string", "minLength": 1},
-          "purpose": {"type": "string", "minLength": 1},
-          "must_include": {"type": "array", "items": {"type": "string", "minLength": 1}},
-          "evidence_ids": {"type": "array", "items": {"type": "string", "pattern": "^[A-Za-z0-9_-]+$"}},
-          "transition_to_next": {"type": "string"}
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "intent": {
+            "type": "string",
+            "minLength": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reader_question": {
+            "type": "string",
+            "minLength": 1
+          },
+          "purpose": {
+            "type": "string",
+            "minLength": 1
+          },
+          "must_include": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "evidence_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9_-]+$"
+            }
+          },
+          "transition_to_next": {
+            "type": "string"
+          },
+          "decision_requirements": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
        }
      }
    },
-    "planning_notes": {"type": "array", "items": {"type": "string", "minLength": 1}}
+    "planning_notes": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
  }
 }
@@ -24,6 +24,9 @@
        "reader_goal_alignment",
        "information_architecture",
        "logical_flow",
+        "reader_facing_prose",
+        "source_usefulness",
+        "decision_rationale",
        "cognitive_load",
        "evidence_traceability",
        "example_verifiability",
@@ -76,6 +79,21 @@
          "type": "number",
          "minimum": 0,
          "maximum": 100
+        },
+        "decision_rationale": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "source_usefulness": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "reader_facing_prose": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
        }
      }
    },
@@ -4,22 +4,93 @@
  "title": "ClariDoc source pack",
  "type": "object",
  "additionalProperties": false,
-  "required": ["sources"],
+  "required": [
+    "sources"
+  ],
  "properties": {
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
-        "required": ["id", "title", "url"],
+        "required": [
+          "id",
+          "title",
+          "url"
+        ],
        "properties": {
-          "id": {"type": "string", "pattern": "^[A-Za-z0-9_-]+$", "minLength": 1},
-          "title": {"type": "string", "minLength": 1},
-          "url": {"type": "string", "minLength": 1},
-          "publisher": {"type": "string"},
-          "accessed": {"type": "string"},
-          "facts": {"type": "array", "items": {"type": "string", "minLength": 1}},
-          "notes": {"type": "string"}
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9_-]+$",
+            "minLength": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "url": {
+            "type": "string",
+            "minLength": 1
+          },
+          "publisher": {
+            "type": "string"
+          },
+          "accessed": {
+            "type": "string"
+          },
+          "facts": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "notes": {
+            "type": "string"
+          },
+          "source_type": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "heading": {
+            "type": "string"
+          },
+          "line_start": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "minimum": 1
+          },
+          "line_end": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "minimum": 1
+          },
+          "claim_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "decision_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "priority": {
+            "type": "number"
+          }
        }
      }
    }