docs: apply Korean prose contract to README

tests/test_cli.py

@@ -45,6 +45,48 @@ class CliTests(unittest.TestCase):
                 "raw/branch-notes/feature-application-port-usecase-contract.md",
             )
 
+    def test_readme_brief_validates_and_outlines(self) -> None:
+        root = Path(__file__).resolve().parents[1]
+        brief = root / "examples" / "briefs" / "claridoc-readme.json"
+        sources = root / "examples" / "sources" / "retry-policy-sources.json"
+        expected_intents = [
+            "problem_value",
+            "principles",
+            "workflow",
+            "installation",
+            "quickstart",
+            "configuration",
+            "verification",
+            "limits_next",
+        ]
+
+        with tempfile.TemporaryDirectory() as temp:
+            output = Path(temp) / "outline.json"
+            with redirect_stdout(StringIO()):
+                validate_code = main(
+                    ["validate", "--brief", str(brief), "--sources", str(sources)]
+                )
+                outline_code = main(
+                    [
+                        "outline",
+                        "--brief",
+                        str(brief),
+                        "--sources",
+                        str(sources),
+                        "--output",
+                        str(output),
+                    ]
+                )
+
+            self.assertEqual(validate_code, 0)
+            self.assertEqual(outline_code, 0)
+            outline = json.loads(output.read_text(encoding="utf-8"))
+            self.assertEqual(outline["document_type"], "readme")
+            self.assertEqual(
+                [section["intent"] for section in outline["sections"]],
+                expected_intents,
+            )
+
 
 if __name__ == "__main__":
     unittest.main()