@clearlydev/nx-archweave 0.0.0-stage → 0.1.0

package/dist/generators/add-agent-rules/generator.js

@@ -0,0 +1,550 @@
+// ../templates/dist/agents/agent-sections.js
+var UNIVERSAL_AGENT_SECTION_IDS = [
+  "think-before-coding",
+  "simplicity-first",
+  "surgical-changes",
+  "goal-driven-execution",
+  "code-structure"
+];
+var PLACEHOLDER_AGENT_SECTION_IDS = ["project-goal", "architecture-boundary"];
+var TEAM_AGENT_SECTION_ID = "team-rules";
+var FSD_AGENT_SECTION_ID = "fsd-structure";
+var DEFAULT_AGENT_SECTION_IDS = [
+  ...UNIVERSAL_AGENT_SECTION_IDS,
+  "safety-rules",
+  "language-policy",
+  ...PLACEHOLDER_AGENT_SECTION_IDS
+];
+var EN_SECTIONS = {
+  "think-before-coding": {
+    id: "think-before-coding",
+    heading: "Think Before Coding",
+    body: [
+      "Before writing any code, restate the problem in your own words and identify what could go wrong.",
+      "Read the surrounding code and existing patterns before introducing new ones \u2014 consistency beats",
+      "personal preference. When a request is ambiguous, make the most reasonable interpretation and say",
+      "what you assumed, rather than guessing silently or blocking on a question you could answer yourself.",
+      "Prefer understanding the root cause of a problem over patching its symptoms."
+    ].join("\n")
+  },
+  "simplicity-first": {
+    id: "simplicity-first",
+    heading: "Simplicity First",
+    body: [
+      "Choose the simplest design that solves the actual problem in front of you, not the one you might",
+      "have tomorrow. Avoid speculative abstraction, unnecessary configuration, and generic frameworks",
+      "built for requirements nobody has asked for yet. A straightforward, slightly duplicated solution",
+      "that is easy to read beats a clever, general one that is hard to follow. Add complexity only when",
+      "a concrete, current need demands it."
+    ].join("\n")
+  },
+  "surgical-changes": {
+    id: "surgical-changes",
+    heading: "Surgical Changes",
+    body: [
+      "Change only what the task requires. Do not reformat, rename, or refactor unrelated code while",
+      "fixing something else \u2014 unrelated changes make review harder and hide the actual fix in noise.",
+      "Keep diffs small and focused so a reviewer can see exactly what changed and why. If you notice an",
+      "unrelated problem while working, note it separately instead of folding it into the current change."
+    ].join("\n")
+  },
+  "goal-driven-execution": {
+    id: "goal-driven-execution",
+    heading: "Goal-Driven Execution",
+    body: [
+      "Keep the actual goal in view, not just the literal instruction. If a requested step turns out to",
+      "be unnecessary, harmful, or based on a wrong assumption once you're in the code, say so and propose",
+      "the better path instead of executing it mechanically. Finish what you start: a task is done when it",
+      "actually works, not when the obvious-looking code has been written. Verify before declaring success."
+    ].join("\n")
+  },
+  "code-structure": {
+    id: "code-structure",
+    heading: "Code Structure and Abstraction",
+    body: [
+      "Keep functions and modules focused on one responsibility; split a file or function when it starts",
+      "accumulating unrelated concerns rather than letting it grow into a god object. Name things after",
+      "what they do or represent, not after their implementation detail. Extract an abstraction only after",
+      "a pattern has actually repeated \u2014 not in anticipation of a repetition that may never come."
+    ].join("\n")
+  },
+  "safety-rules": {
+    id: "safety-rules",
+    heading: "Safety Rules",
+    body: [
+      "Never force-push to shared branches, never bypass required status checks, and never disable or",
+      "delete CI/CD configuration just to make a failing check pass.",
+      "Do not read, print, or commit the contents of secret files (`.env`, credential files, private",
+      "keys) \u2014 treat anything matching a common secret pattern as off-limits unless the user has already",
+      "shared its contents with you directly.",
+      "Do not run destructive commands (`rm -rf`, `git reset --hard`, `git clean -f`, force pushes)",
+      "without explicit confirmation, and check for uncommitted work first.",
+      "Do not send repository contents, credentials, or user data to any external service.",
+      "When you are unsure whether an action is safe, stop and ask instead of proceeding.",
+      "",
+      "<!-- TODO: list project-specific protected resources (e.g. production config files, protected",
+      "branches, restricted directories, external services this project must never call in tests). -->"
+    ].join("\n")
+  },
+  "language-policy": {
+    id: "language-policy",
+    heading: "Language Policy",
+    body: [
+      "Communicate with the user in English. Write code, identifiers, comments, commit messages, and",
+      "documentation in English as well, unless the user explicitly asks for another language for a",
+      "specific piece of content."
+    ].join("\n")
+  },
+  "team-rules": {
+    id: "team-rules",
+    heading: "Team Rules",
+    body: [
+      "This repository is shared by a team: optimize for the reviewer, not for yourself.",
+      "Keep each pull request small and about one thing, fill in the pull request template, and link",
+      "the issue it closes.",
+      "Treat review findings as work, not opinions: address every P0/P1 finding before asking for",
+      "another look, answer each comment, and never merge your own pull request or dismiss a review",
+      "to get it through.",
+      "Respect module ownership: a change that crosses a module or layer boundary needs that",
+      "module's owner in the review. Never weaken a module-boundary lint rule, add an eslint-disable",
+      "for one, or retag a project to get an import past the boundary \u2014 propose the boundary change",
+      "in the pull request description instead.",
+      "Changes to shared code (the `shared` layer, `shared-types`, root configuration) affect every",
+      "team member: keep them backward compatible, call them out in the pull request, and keep them",
+      "separate from feature work.",
+      "Never commit directly to a protected branch; work on a branch and bring it up to date with",
+      "its base before requesting review.",
+      "",
+      "<!-- TODO: list team-specific conventions (module owners / CODEOWNERS, required reviewers,",
+      "branch naming, release process). -->"
+    ].join("\n")
+  },
+  "fsd-structure": {
+    id: "fsd-structure",
+    heading: "Frontend Structure (FSD Lite)",
+    body: [
+      'The frontend app follows canonical Feature-Sliced Design. "Lite" means only that the default scope',
+      "is `app`, `pages`, `features`, `entities` and `shared` (`widgets` only on request) and that Solo",
+      "workspaces get warnings instead of errors \u2014 the rules themselves are the canonical ones:",
+      "- A layer imports only layers below it: app > pages > widgets > features > entities > shared.",
+      "- Slices on one layer (pages, widgets, features, entities) never import each other; move the",
+      "  shared part one layer down, or expose it through the other slice's `@x/<consumer>` public API.",
+      "- Import a slice only through its `index.ts`; never reach into its `ui/`, `model/` or `api/` files.",
+      "- `app` and `shared` hold segments, not slices; shared segments are named by purpose (`ui`, `api`,",
+      "  `model`, `lib`, `config`), never by essence (`components`, `hooks`, `utils`, `types`).",
+      "Create slices with the generators (`nx g @clearlydev/nx-archweave:page|widget|feature|entity|shared --name=\u2026`,",
+      "`--segments=ui,api` for extra segments).",
+      "The `archweave/fsd-boundaries` ESLint rule reports violations: fix the import, never disable the",
+      "rule or add an eslint-disable for it. On Next.js the pages layer is the `_pages/` directory."
+    ].join("\n")
+  },
+  "project-goal": {
+    id: "project-goal",
+    heading: "Project Goal",
+    body: "<!-- TODO: describe this project's goal, target users, and what success looks like. -->"
+  },
+  "architecture-boundary": {
+    id: "architecture-boundary",
+    heading: "Architecture Boundary",
+    body: "<!-- TODO: describe this project's module boundaries, ownership rules, and which modules may or may not depend on which. -->"
+  }
+};
+var KO_SECTIONS = {
+  "think-before-coding": {
+    id: "think-before-coding",
+    heading: "\uCF54\uB529 \uC804\uC5D0 \uBA3C\uC800 \uC0DD\uAC01\uD558\uAE30",
+    body: [
+      "\uCF54\uB4DC\uB97C \uC791\uC131\uD558\uAE30 \uC804\uC5D0 \uBB38\uC81C\uB97C \uC2A4\uC2A4\uB85C\uC758 \uB9D0\uB85C \uB2E4\uC2DC \uC815\uB9AC\uD558\uACE0 \uBB34\uC5C7\uC774 \uC798\uBABB\uB420 \uC218 \uC788\uB294\uC9C0 \uD30C\uC545\uD55C\uB2E4.",
+      "\uC0C8 \uD328\uD134\uC744 \uB3C4\uC785\uD558\uAE30 \uC804\uC5D0 \uC8FC\uBCC0 \uCF54\uB4DC\uC640 \uAE30\uC874 \uAD00\uB840\uB97C \uBA3C\uC800 \uC77D\uB294\uB2E4 \u2014 \uAC1C\uC778 \uCDE8\uD5A5\uBCF4\uB2E4 \uC77C\uAD00\uC131\uC774 \uC6B0\uC120\uC774\uB2E4.",
+      "\uC694\uCCAD\uC774 \uBAA8\uD638\uD560 \uB54C\uB294 \uAC00\uC7A5 \uD569\uB9AC\uC801\uC778 \uD574\uC11D\uC744 \uD0DD\uD558\uACE0 \uBB34\uC5C7\uC744 \uAC00\uC815\uD588\uB294\uC9C0 \uBC1D\uD78C\uB2E4. \uC2A4\uC2A4\uB85C \uB2F5\uD560 \uC218 \uC788\uB294",
+      "\uC9C8\uBB38\uC73C\uB85C \uC791\uC5C5\uC744 \uB9C9\uC9C0 \uB9D0\uACE0, \uC870\uC6A9\uD788 \uCD94\uCE21\uB9CC \uD558\uC9C0\uB3C4 \uC54A\uB294\uB2E4. \uC99D\uC0C1\uC744 \uB55C\uC9C8\uD558\uAE30\uBCF4\uB2E4 \uADFC\uBCF8 \uC6D0\uC778\uC744 \uC774\uD574\uD558\uB294",
+      "\uCABD\uC744 \uC6B0\uC120\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "simplicity-first": {
+    id: "simplicity-first",
+    heading: "\uB2E8\uC21C\uD568 \uC6B0\uC120",
+    body: [
+      "\uC9C0\uAE08 \uB208\uC55E\uC758 \uBB38\uC81C\uB97C \uD574\uACB0\uD558\uB294 \uAC00\uC7A5 \uB2E8\uC21C\uD55C \uC124\uACC4\uB97C \uC120\uD0DD\uD55C\uB2E4 \u2014 \uB0B4\uC77C \uD544\uC694\uD560\uC9C0\uB3C4 \uBAA8\uB974\uB294 \uAC83\uAE4C\uC9C0 \uB300\uBE44\uD558\uC9C0",
+      "\uC54A\uB294\uB2E4. \uC544\uBB34\uB3C4 \uC694\uCCAD\uD558\uC9C0 \uC54A\uC740 \uC694\uAD6C\uC0AC\uD56D\uC744 \uC704\uD55C \uCD94\uCE21\uC131 \uCD94\uC0C1\uD654, \uBD88\uD544\uC694\uD55C \uC124\uC815, \uBC94\uC6A9 \uD504\uB808\uC784\uC6CC\uD06C\uB97C",
+      "\uD53C\uD55C\uB2E4. \uC77D\uAE30 \uC26C\uC6B4 \uC57D\uAC04\uC758 \uC911\uBCF5\uC774 \uC788\uB294 \uD574\uBC95\uC774, \uC774\uD574\uD558\uAE30 \uC5B4\uB824\uC6B4 \uC601\uB9AC\uD558\uACE0 \uBC94\uC6A9\uC801\uC778 \uD574\uBC95\uBCF4\uB2E4 \uB0AB\uB2E4.",
+      "\uAD6C\uCCB4\uC801\uC774\uACE0 \uD604\uC7AC \uC874\uC7AC\uD558\uB294 \uD544\uC694\uAC00 \uC788\uC744 \uB54C\uB9CC \uBCF5\uC7A1\uB3C4\uB97C \uCD94\uAC00\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "surgical-changes": {
+    id: "surgical-changes",
+    heading: "\uC678\uACFC\uC801 \uBCC0\uACBD",
+    body: [
+      "\uC791\uC5C5\uC5D0 \uD544\uC694\uD55C \uBD80\uBD84\uB9CC \uBCC0\uACBD\uD55C\uB2E4. \uB2E4\uB978 \uBB38\uC81C\uB97C \uACE0\uCE58\uB294 \uAE40\uC5D0 \uAD00\uB828 \uC5C6\uB294 \uCF54\uB4DC\uB97C \uC7AC\uD3EC\uB9F7\uD558\uAC70\uB098, \uC774\uB984\uC744",
+      "\uBC14\uAFB8\uAC70\uB098, \uB9AC\uD329\uD130\uB9C1\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uAD00\uB828 \uC5C6\uB294 \uBCC0\uACBD\uC740 \uB9AC\uBDF0\uB97C \uC5B4\uB835\uAC8C \uB9CC\uB4E4\uACE0 \uC2E4\uC81C \uC218\uC815 \uB0B4\uC6A9\uC744 \uB178\uC774\uC988",
+      "\uC18D\uC5D0 \uC228\uAE34\uB2E4. diff\uB97C \uC791\uACE0 \uC9D1\uC911\uB418\uAC8C \uC720\uC9C0\uD574 \uB9AC\uBDF0\uC5B4\uAC00 \uBB34\uC5C7\uC774, \uC65C \uBC14\uB00C\uC5C8\uB294\uC9C0 \uC815\uD655\uD788 \uBCFC \uC218 \uC788\uAC8C \uD55C\uB2E4.",
+      "\uC791\uC5C5 \uC911 \uAD00\uB828 \uC5C6\uB294 \uBB38\uC81C\uB97C \uBC1C\uACAC\uD558\uBA74 \uD604\uC7AC \uBCC0\uACBD\uC5D0 \uC11E\uC9C0 \uB9D0\uACE0 \uBCC4\uB3C4\uB85C \uC54C\uB9B0\uB2E4."
+    ].join("\n")
+  },
+  "goal-driven-execution": {
+    id: "goal-driven-execution",
+    heading: "\uBAA9\uD45C \uC9C0\uD5A5 \uC2E4\uD589",
+    body: [
+      "\uBB38\uC790 \uADF8\uB300\uB85C\uC758 \uC9C0\uC2DC\uAC00 \uC544\uB2C8\uB77C \uC2E4\uC81C \uBAA9\uD45C\uB97C \uACC4\uC18D \uC5FC\uB450\uC5D0 \uB454\uB2E4. \uCF54\uB4DC\uB97C \uC0B4\uD3B4\uBCF4\uB2C8 \uC694\uCCAD\uBC1B\uC740 \uB2E8\uACC4\uAC00",
+      "\uBD88\uD544\uC694\uD558\uAC70\uB098, \uD574\uB86D\uAC70\uB098, \uC798\uBABB\uB41C \uAC00\uC815\uC5D0 \uAE30\uBC18\uD55C \uAC83\uC73C\uB85C \uB4DC\uB7EC\uB098\uBA74 \uAE30\uACC4\uC801\uC73C\uB85C \uC2E4\uD589\uD558\uC9C0 \uB9D0\uACE0 \uADF8\uB807\uB2E4\uACE0",
+      "\uB9D0\uD55C \uB4A4 \uB354 \uB098\uC740 \uACBD\uB85C\uB97C \uC81C\uC548\uD55C\uB2E4. \uC2DC\uC791\uD55C \uC77C\uC740 \uB05D\uB0B8\uB2E4 \u2014 \uADF8\uB7F4\uB4EF\uD574 \uBCF4\uC774\uB294 \uCF54\uB4DC\uB97C \uC791\uC131\uD588\uC744 \uB54C\uAC00 \uC544\uB2C8\uB77C",
+      "\uC2E4\uC81C\uB85C \uB3D9\uC791\uD560 \uB54C\uAC00 \uC644\uB8CC\uB2E4. \uC131\uACF5\uC744 \uC120\uC5B8\uD558\uAE30 \uC804\uC5D0 \uBC18\uB4DC\uC2DC \uAC80\uC99D\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "code-structure": {
+    id: "code-structure",
+    heading: "\uCF54\uB4DC \uAD6C\uC870\uC640 \uCD94\uC0C1\uD654",
+    body: [
+      "\uD568\uC218\uC640 \uBAA8\uB4C8\uC744 \uD558\uB098\uC758 \uCC45\uC784\uC5D0 \uC9D1\uC911\uC2DC\uD0A8\uB2E4. God object\uB85C \uCEE4\uC9C0\uB3C4\uB85D \uB450\uC9C0 \uB9D0\uACE0, \uAD00\uB828 \uC5C6\uB294 \uAD00\uC2EC\uC0AC\uAC00",
+      "\uC313\uC774\uAE30 \uC2DC\uC791\uD558\uBA74 \uD30C\uC77C\uC774\uB098 \uD568\uC218\uB97C \uBD84\uB9AC\uD55C\uB2E4. \uAD6C\uD604 \uC138\uBD80\uC0AC\uD56D\uC774 \uC544\uB2C8\uB77C \uD558\uB294 \uC77C\uC774\uB098 \uB098\uD0C0\uB0B4\uB294 \uB300\uC0C1\uC744",
+      "\uAE30\uC900\uC73C\uB85C \uC774\uB984\uC744 \uC9D3\uB294\uB2E4. \uD328\uD134\uC774 \uC2E4\uC81C\uB85C \uBC18\uBCF5\uB41C \uB4A4\uC5D0\uB9CC \uCD94\uC0C1\uD654\uB97C \uCD94\uCD9C\uD55C\uB2E4 \u2014 \uC5B8\uC820\uAC00 \uBC18\uBCF5\uB420\uC9C0\uB3C4 \uBAA8\uB978\uB2E4\uB294",
+      "\uC608\uCE21\uB9CC\uC73C\uB85C \uBBF8\uB9AC \uCD94\uCD9C\uD558\uC9C0 \uC54A\uB294\uB2E4."
+    ].join("\n")
+  },
+  "safety-rules": {
+    id: "safety-rules",
+    heading: "\uC548\uC804 \uADDC\uCE59",
+    body: [
+      "\uACF5\uC720 \uBE0C\uB79C\uCE58\uC5D0 force-push\uD558\uC9C0 \uC54A\uACE0, \uD544\uC218 \uC0C1\uD0DC \uAC80\uC0AC\uB97C \uC6B0\uD68C\uD558\uC9C0 \uC54A\uC73C\uBA70, \uC2E4\uD328\uD558\uB294 \uAC80\uC0AC\uB97C \uD1B5\uACFC\uC2DC\uD0A4\uAE30",
+      "\uC704\uD574 CI/CD \uC124\uC815\uC744 \uBE44\uD65C\uC131\uD654\uD558\uAC70\uB098 \uC0AD\uC81C\uD558\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uBE44\uBC00 \uD30C\uC77C(`.env`, \uC790\uACA9 \uC99D\uBA85 \uD30C\uC77C, \uAC1C\uC778 \uD0A4)\uC758 \uB0B4\uC6A9\uC744 \uC77D\uAC70\uB098 \uCD9C\uB825\uD558\uAC70\uB098 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00",
+      "\uBA3C\uC800 \uC9C1\uC811 \uB0B4\uC6A9\uC744 \uACF5\uC720\uD558\uC9C0 \uC54A\uB294 \uD55C, \uC77C\uBC18\uC801\uC778 \uBE44\uBC00 \uD30C\uC77C \uD328\uD134\uC5D0 \uD574\uB2F9\uD558\uB294 \uAC83\uC740 \uC811\uADFC \uAE08\uC9C0 \uB300\uC0C1\uC73C\uB85C",
+      "\uCDE8\uAE09\uD55C\uB2E4.",
+      "\uBA85\uC2DC\uC801 \uD655\uC778 \uC5C6\uC774 \uD30C\uAD34\uC801 \uBA85\uB839(`rm -rf`, `git reset --hard`, `git clean -f`, force-push)\uC744 \uC2E4\uD589\uD558\uC9C0",
+      "\uC54A\uC73C\uBA70, \uC2E4\uD589 \uC804 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC740 \uC791\uC5C5\uC774 \uC788\uB294\uC9C0 \uBA3C\uC800 \uD655\uC778\uD55C\uB2E4.",
+      "\uC800\uC7A5\uC18C \uB0B4\uC6A9, \uC790\uACA9 \uC99D\uBA85, \uC0AC\uC6A9\uC790 \uB370\uC774\uD130\uB97C \uC678\uBD80 \uC11C\uBE44\uC2A4\uB85C \uC804\uC1A1\uD558\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uC5B4\uB5A4 \uB3D9\uC791\uC774 \uC548\uC804\uD55C\uC9C0 \uD655\uC2E0\uC774 \uC11C\uC9C0 \uC54A\uC73C\uBA74 \uC9C4\uD589\uD558\uC9C0 \uB9D0\uACE0 \uBA3C\uC800 \uC9C8\uBB38\uD55C\uB2E4.",
+      "",
+      // The marker itself stays in English, matching the Language Policy's "code/comments in
+      // English" rule and giving tooling a single locale-invariant string to check for.
+      "<!-- TODO: list project-specific protected resources (e.g. production config files, protected",
+      "branches, restricted directories, external services this project must never call in tests). -->"
+    ].join("\n")
+  },
+  "language-policy": {
+    id: "language-policy",
+    heading: "\uC5B8\uC5B4 \uC815\uCC45",
+    body: [
+      "\uC0AC\uC6A9\uC790\uC640\uC758 \uB300\uD654\uB294 \uD55C\uAD6D\uC5B4\uB85C \uC9C4\uD589\uD55C\uB2E4. \uCF54\uB4DC, \uC2DD\uBCC4\uC790, \uC8FC\uC11D, \uCEE4\uBC0B \uBA54\uC2DC\uC9C0, \uBB38\uC11C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uD2B9\uC815",
+      "\uD56D\uBAA9\uC5D0 \uB300\uD574 \uB2E4\uB978 \uC5B8\uC5B4\uB97C \uBA85\uC2DC\uC801\uC73C\uB85C \uC694\uCCAD\uD558\uC9C0 \uC54A\uB294 \uD55C \uC601\uC5B4\uB85C \uC791\uC131\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "team-rules": {
+    id: "team-rules",
+    heading: "\uD300 \uADDC\uCE59",
+    body: [
+      "\uC774 \uC800\uC7A5\uC18C\uB294 \uD300\uC774 \uD568\uAED8 \uC4F4\uB2E4 \u2014 \uC790\uC2E0\uC774 \uC544\uB2C8\uB77C \uB9AC\uBDF0\uC5B4\uB97C \uC704\uD574 \uCD5C\uC801\uD654\uD55C\uB2E4.",
+      "PR\uC740 \uC791\uAC8C, \uD55C \uAC00\uC9C0 \uC8FC\uC81C\uB9CC \uB2E4\uB8E8\uBA70, PR \uD15C\uD50C\uB9BF\uC744 \uCC44\uC6B0\uACE0 \uB2EB\uB294 \uC774\uC288\uB97C \uB9C1\uD06C\uD55C\uB2E4.",
+      "\uB9AC\uBDF0 finding\uC740 \uC758\uACAC\uC774 \uC544\uB2C8\uB77C \uC791\uC5C5\uC774\uB2E4 \u2014 \uC7AC\uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uAE30 \uC804\uC5D0 P0/P1 finding\uC744 \uBAA8\uB450 \uD574\uACB0\uD558\uACE0,",
+      "\uCF54\uBA58\uD2B8\uB9C8\uB2E4 \uB2F5\uD558\uBA70, \uC790\uAE30 PR\uC744 \uC2A4\uC2A4\uB85C \uBA38\uC9C0\uD558\uAC70\uB098 \uB9AC\uBDF0\uB97C dismiss\uD574\uC11C \uD1B5\uACFC\uC2DC\uD0A4\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uBAA8\uB4C8 \uC18C\uC720\uAD8C\uC744 \uC874\uC911\uD55C\uB2E4 \u2014 \uBAA8\uB4C8\uC774\uB098 \uB808\uC774\uC5B4 \uACBD\uACC4\uB97C \uB118\uB294 \uBCC0\uACBD\uC740 \uD574\uB2F9 \uBAA8\uB4C8 \uC624\uB108\uC758 \uB9AC\uBDF0\uAC00 \uD544\uC694\uD558\uB2E4.",
+      "import\uB97C \uACBD\uACC4 \uB108\uBA38\uB85C \uD1B5\uACFC\uC2DC\uD0A4\uAE30 \uC704\uD574 module-boundary \uB9B0\uD2B8 \uADDC\uCE59\uC744 \uC57D\uD654\uD558\uAC70\uB098, eslint-disable\uC744",
+      "\uCD94\uAC00\uD558\uAC70\uB098, \uD504\uB85C\uC81D\uD2B8 \uD0DC\uADF8\uB97C \uBC14\uAFB8\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uACBD\uACC4 \uBCC0\uACBD\uC740 PR \uBCF8\uBB38\uC5D0\uC11C \uC81C\uC548\uD55C\uB2E4.",
+      "\uACF5\uC720 \uCF54\uB4DC(`shared` \uB808\uC774\uC5B4, `shared-types`, \uB8E8\uD2B8 \uC124\uC815) \uBCC0\uACBD\uC740 \uD300 \uC804\uC6D0\uC5D0\uAC8C \uC601\uD5A5\uC744 \uC900\uB2E4 \u2014 \uD558\uC704",
+      "\uD638\uD658\uC744 \uC720\uC9C0\uD558\uACE0, PR\uC5D0 \uBA85\uC2DC\uD558\uBA70, \uAE30\uB2A5 \uC791\uC5C5\uACFC \uBD84\uB9AC\uD55C\uB2E4.",
+      "\uBCF4\uD638 \uBE0C\uB79C\uCE58\uC5D0 \uC9C1\uC811 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uBE0C\uB79C\uCE58\uC5D0\uC11C \uC791\uC5C5\uD558\uACE0 \uB9AC\uBDF0 \uC694\uCCAD \uC804\uC5D0 \uBCA0\uC774\uC2A4\uC640 \uB3D9\uAE30\uD654\uD55C\uB2E4.",
+      "",
+      // The marker stays in English, matching the Safety Rules precedent (one locale-invariant
+      // string for tooling to check).
+      "<!-- TODO: list team-specific conventions (module owners / CODEOWNERS, required reviewers,",
+      "branch naming, release process). -->"
+    ].join("\n")
+  },
+  "fsd-structure": {
+    id: "fsd-structure",
+    heading: "\uD504\uB860\uD2B8\uC5D4\uB4DC \uAD6C\uC870 (FSD Lite)",
+    body: [
+      '\uD504\uB860\uD2B8\uC5D4\uB4DC \uC571\uC740 \uC815\uC2DD Feature-Sliced Design\uC744 \uB530\uB978\uB2E4. "Lite"\uB294 \uAE30\uBCF8 \uBC94\uC704\uAC00 `app`, `pages`, `features`,',
+      "`entities`, `shared`\uC774\uACE0(`widgets`\uB294 \uC694\uCCAD\uD560 \uB54C\uB9CC), Solo \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0\uC11C\uB294 \uC704\uBC18\uC744 \uC5D0\uB7EC\uAC00 \uC544\uB2CC",
+      "\uACBD\uACE0\uB85C \uC54C\uB9B0\uB2E4\uB294 \uB73B\uC77C \uBFD0\uC774\uB2E4 \u2014 \uADDC\uCE59 \uC790\uCCB4\uB294 \uC815\uC2DD FSD \uADF8\uB300\uB85C\uB2E4:",
+      "- \uB808\uC774\uC5B4\uB294 \uC790\uAE30\uBCF4\uB2E4 \uC544\uB798 \uB808\uC774\uC5B4\uB9CC import\uD55C\uB2E4: app > pages > widgets > features > entities > shared.",
+      "- \uAC19\uC740 \uB808\uC774\uC5B4\uC758 \uC2AC\uB77C\uC774\uC2A4\uB07C\uB9AC(pages, widgets, features, entities)\uB294 import\uD558\uC9C0 \uC54A\uB294\uB2E4. \uACF5\uC720\uD560 \uCF54\uB4DC\uB294",
+      "  \uD55C \uB808\uC774\uC5B4 \uC544\uB798\uB85C \uB0B4\uB9AC\uAC70\uB098, \uC0C1\uB300 \uC2AC\uB77C\uC774\uC2A4\uC758 `@x/<consumer>` \uACF5\uAC1C API\uB85C\uB9CC \uB178\uCD9C\uD55C\uB2E4.",
+      "- \uC2AC\uB77C\uC774\uC2A4\uB294 `index.ts`\uB97C \uD1B5\uD574\uC11C\uB9CC import\uD55C\uB2E4. `ui/`, `model/`, `api/` \uB0B4\uBD80 \uD30C\uC77C\uC5D0 \uC9C1\uC811 \uB2FF\uC9C0 \uC54A\uB294\uB2E4.",
+      "- `app`\uACFC `shared`\uB294 \uC2AC\uB77C\uC774\uC2A4\uAC00 \uC544\uB2C8\uB77C \uC138\uADF8\uBA3C\uD2B8\uB97C \uAC00\uC9C4\uB2E4. shared \uC138\uADF8\uBA3C\uD2B8 \uC774\uB984\uC740 \uBAA9\uC801\uD615(`ui`, `api`,",
+      "  `model`, `lib`, `config`)\uC73C\uB85C \uC9D3\uACE0, \uBCF8\uC9C8\uD615(`components`, `hooks`, `utils`, `types`)\uC740 \uC4F0\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uC2AC\uB77C\uC774\uC2A4\uB294 generator\uB85C \uB9CC\uB4E0\uB2E4(`nx g @clearlydev/nx-archweave:page|widget|feature|entity|shared --name=\u2026`,",
+      "\uCD94\uAC00 \uC138\uADF8\uBA3C\uD2B8\uB294 `--segments=ui,api`).",
+      "`archweave/fsd-boundaries` ESLint \uADDC\uCE59\uC774 \uC704\uBC18\uC744 \uC54C\uB824 \uC900\uB2E4: import\uB97C \uACE0\uCE58\uB418, \uADDC\uCE59\uC744 \uB044\uAC70\uB098 eslint-disable\uB85C",
+      "\uB118\uAE30\uC9C0 \uC54A\uB294\uB2E4. Next.js\uC5D0\uC11C\uB294 pages \uB808\uC774\uC5B4\uAC00 `_pages/` \uD3F4\uB354\uB2E4."
+    ].join("\n")
+  },
+  "project-goal": {
+    id: "project-goal",
+    heading: "\uD504\uB85C\uC81D\uD2B8 \uBAA9\uD45C",
+    body: "<!-- TODO: \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBAA9\uD45C, \uB300\uC0C1 \uC0AC\uC6A9\uC790, \uC131\uACF5 \uAE30\uC900\uC744 \uC791\uC131\uD558\uC138\uC694. -->"
+  },
+  "architecture-boundary": {
+    id: "architecture-boundary",
+    heading: "\uC544\uD0A4\uD14D\uCC98 \uACBD\uACC4",
+    body: "<!-- TODO: \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBAA8\uB4C8 \uACBD\uACC4, \uC18C\uC720 \uADDC\uCE59, \uC5B4\uB5A4 \uBAA8\uB4C8\uC774 \uC5B4\uB5A4 \uBAA8\uB4C8\uC5D0 \uC758\uC874\uD560 \uC218 \uC788\uB294\uC9C0\uB97C \uC791\uC131\uD558\uC138\uC694. -->"
+  }
+};
+var AGENT_RULE_SECTIONS = {
+  en: EN_SECTIONS,
+  ko: KO_SECTIONS
+};
+
+// ../template-engine/dist/ai-hosts/ai-hosts.js
+var AI_HOSTS = [
+  { id: "claude-code", label: "Claude Code", nxAgent: "claude", rulesFile: "CLAUDE.md", reviewProvider: "claude" },
+  { id: "codex", label: "Codex", nxAgent: "codex", rulesFile: "AGENTS.md", reviewProvider: "gpt" },
+  { id: "cursor", label: "Cursor", nxAgent: "cursor", rulesFile: "AGENTS.md", reviewProvider: "cursor" },
+  { id: "gemini-cli", label: "Gemini CLI", nxAgent: "gemini", rulesFile: "AGENTS.md", reviewProvider: "gemini" }
+];
+var AI_HOST_IDS = AI_HOSTS.map((host) => host.id);
+var DEFAULT_AI_HOSTS = ["claude-code"];
+function isAiHost(value) {
+  return typeof value === "string" && AI_HOST_IDS.includes(value);
+}
+function definitionOf(id) {
+  const host = AI_HOSTS.find((candidate) => candidate.id === id);
+  if (!host)
+    throw new Error(`Unknown AI host "${id}"`);
+  return host;
+}
+function rulesFilesFor(hosts) {
+  const picked = hosts.length > 0 ? hosts : DEFAULT_AI_HOSTS;
+  const files = new Set(picked.map((id) => definitionOf(id).rulesFile));
+  return ["CLAUDE.md", "AGENTS.md"].filter((file) => files.has(file));
+}
+
+// ../template-engine/dist/agent-rules/compose-agent-rules.js
+function resolveDefaultAgentSectionIds(teamRules, fsdStructure = false) {
+  let ids = [...DEFAULT_AGENT_SECTION_IDS];
+  const insertAfter = (anchorId, id) => {
+    const anchor = ids.indexOf(anchorId);
+    if (anchor === -1) {
+      throw new Error(`composeAgentRules: the default composition no longer contains ${anchorId}`);
+    }
+    ids = [...ids.slice(0, anchor + 1), id, ...ids.slice(anchor + 1)];
+  };
+  if (fsdStructure)
+    insertAfter("code-structure", FSD_AGENT_SECTION_ID);
+  if (teamRules)
+    insertAfter("language-policy", TEAM_AGENT_SECTION_ID);
+  return ids;
+}
+function renderSections(sections) {
+  return `${sections.map((section) => `## ${section.heading}
+
+${section.body}`).join("\n\n")}
+`;
+}
+function composeAgentRules(input) {
+  const sectionIds = input.sections ?? resolveDefaultAgentSectionIds(input.teamRules ?? false, input.fsdStructure ?? false);
+  const sections = sectionIds.map((id) => AGENT_RULE_SECTIONS[input.locale][id]);
+  const content = renderSections(sections);
+  return input.files.map((filePath) => ({ filePath, content }));
+}
+
+// ../template-engine/dist/agent-rules/validate-agent-rules.js
+var LOCALES = ["en", "ko"];
+function headingsFor(id) {
+  return LOCALES.map((locale) => `## ${AGENT_RULE_SECTIONS[locale][id].heading}`);
+}
+var REQUIRED_SECTION_IDS = ["safety-rules", "language-policy"];
+function validateAgentRules(content, extraRequired = []) {
+  return [...REQUIRED_SECTION_IDS, ...extraRequired].every((id) => headingsFor(id).some((heading) => content.includes(heading)));
+}
+
+// ../template-engine/dist/agent-rules/marker-block.js
+var AGENT_RULES_BLOCK_START = "<!-- nx-archweave:agent-rules start -->";
+var AGENT_RULES_BLOCK_END = "<!-- nx-archweave:agent-rules end -->";
+function renderAgentRulesBlock(body, eol = "\n") {
+  const lines = `${AGENT_RULES_BLOCK_START}
+${body.endsWith("\n") ? body : `${body}
+`}${AGENT_RULES_BLOCK_END}`;
+  return eol === "\n" ? lines : lines.replace(/\r?\n/g, eol);
+}
+function countOf(text, needle) {
+  return text.split(needle).length - 1;
+}
+function applyAgentRulesBlock(existing, body) {
+  if (existing === null || existing.length === 0)
+    return { kind: "create", text: `${renderAgentRulesBlock(body)}
+` };
+  const eol = existing.includes("\r\n") ? "\r\n" : "\n";
+  const block = renderAgentRulesBlock(body, eol);
+  const starts = countOf(existing, AGENT_RULES_BLOCK_START);
+  const ends = countOf(existing, AGENT_RULES_BLOCK_END);
+  if (starts === 0 && ends === 0) {
+    const head = existing.endsWith("\n") ? existing : `${existing}${eol}`;
+    return { kind: "append", text: `${head}${eol}${block}${eol}` };
+  }
+  if (starts !== 1 || ends !== 1) {
+    return {
+      kind: "unrecognized",
+      reason: `expected one ${AGENT_RULES_BLOCK_START} \u2026 ${AGENT_RULES_BLOCK_END} pair, found ${starts} start and ${ends} end marker(s)`
+    };
+  }
+  const start = existing.indexOf(AGENT_RULES_BLOCK_START);
+  const end = existing.indexOf(AGENT_RULES_BLOCK_END);
+  if (end < start)
+    return { kind: "unrecognized", reason: "the end marker comes before the start marker" };
+  const text = existing.slice(0, start) + block + existing.slice(end + AGENT_RULES_BLOCK_END.length);
+  return text === existing ? { kind: "unchanged" } : { kind: "replace", text };
+}
+
+// src/generators/shared/dry-run.ts
+function resolveDryRun(options) {
+  return process.env["NX_DRY_RUN"] === "true" || (options.dryRun ?? false);
+}
+
+// src/generators/shared/toolkit-config-file.ts
+var TOOLKIT_CONFIG_PATH = "toolkit.config.json";
+function detectIndent(raw) {
+  for (const line of raw.split("\n")) {
+    const match = /^(\t+| +)/.exec(line);
+    if (match) return match[1];
+  }
+  return "  ";
+}
+function readToolkitConfigFile(tree) {
+  const raw = tree.read(TOOLKIT_CONFIG_PATH, "utf-8");
+  if (raw === null) return { raw: null, parsed: null };
+  try {
+    const parsed = JSON.parse(raw);
+    return {
+      raw,
+      parsed: typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null
+    };
+  } catch {
+    return { raw, parsed: null };
+  }
+}
+function readToolkitConfig(tree) {
+  return readToolkitConfigFile(tree).parsed;
+}
+function resolveLocaleOption(option, config) {
+  if (option) return option;
+  const locale = config?.["locale"];
+  return locale === "ko" || locale === "en" ? locale : "en";
+}
+function resolveAiHostsOption(option, config) {
+  if (option !== void 0 && option.length > 0) return [...new Set(option)];
+  const recorded = config?.["aiHosts"];
+  const fromConfig = Array.isArray(recorded) ? [...new Set(recorded.filter(isAiHost))] : [];
+  return fromConfig.length > 0 ? fromConfig : [...DEFAULT_AI_HOSTS];
+}
+function recordAiHosts(tree, hosts, write) {
+  const { raw, parsed } = readToolkitConfigFile(tree);
+  if (raw !== null && parsed === null) return "unrecognized";
+  const existing = parsed ?? {};
+  const recorded = existing["aiHosts"];
+  if (Array.isArray(recorded) && recorded.length === hosts.length && recorded.every((id, index) => id === hosts[index])) {
+    return "unchanged";
+  }
+  if (write) {
+    const indent = raw === null ? "  " : detectIndent(raw);
+    const body = JSON.stringify({ ...existing, aiHosts: [...hosts] }, null, indent);
+    tree.write(TOOLKIT_CONFIG_PATH, raw === null || raw.endsWith("\n") ? `${body}
+` : body);
+  }
+  return raw === null ? "created" : "updated";
+}
+
+// src/generators/add-agent-rules/render.ts
+var ACTION_LINE = {
+  created: (result) => `${result.filePath}: created`,
+  appended: (result) => `${result.filePath}: nx-archweave block added after the existing content (nothing else changed)`,
+  updated: (result) => `${result.filePath}: nx-archweave block updated (nothing outside it changed)`,
+  unchanged: (result) => `${result.filePath}: unchanged`,
+  unrecognized: (result) => `${result.filePath}: not written \u2014 ${result.reason ?? "the nx-archweave markers could not be placed"}`
+};
+function renderAddAgentRulesReport(report) {
+  const lines = [];
+  lines.push(report.dryRun ? "add-agent-rules dry-run \u2014 no files were written." : "add-agent-rules:");
+  lines.push(`  hosts: ${report.hosts.join(", ")}`);
+  lines.push(`  locale: ${report.locale}`);
+  lines.push(`  teamRules: ${report.teamRules}`);
+  lines.push("");
+  for (const file of report.files) {
+    lines.push(`  ${ACTION_LINE[file.action](file)}`);
+  }
+  const RECORD_LINE = {
+    created: "toolkit.config.json: aiHosts recorded (file created)",
+    updated: "toolkit.config.json: aiHosts recorded",
+    unchanged: "toolkit.config.json: aiHosts already recorded",
+    unrecognized: "toolkit.config.json: not a JSON object \u2014 aiHosts not recorded (fix the file, then rerun)",
+    "not-applied": "toolkit.config.json: aiHosts not recorded \u2014 a file above was not written",
+    "not-requested": null
+  };
+  const recordLine = RECORD_LINE[report.hostsRecord];
+  if (recordLine !== null) lines.push(`  ${recordLine}`);
+  if (report.files.some((file) => file.action === "unrecognized")) {
+    lines.push("");
+    lines.push('Manual fix needed: keep exactly one "<!-- nx-archweave:agent-rules start -->" \u2026 "<!-- nx-archweave:agent-rules end -->"');
+    lines.push("pair in the file (or remove both markers), then rerun add-agent-rules.");
+  }
+  if (report.dryRun) {
+    lines.push("");
+    lines.push("Generated content preview:");
+    for (const file of report.files) {
+      if (file.content === null) continue;
+      lines.push("");
+      lines.push(`--- ${file.filePath} ---`);
+      lines.push(file.content);
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/generators/add-agent-rules/generator.ts
+function resolveTeamRules(option, config) {
+  if (option !== void 0) return option;
+  const agentRules = config?.["agentRules"];
+  const teamRules = typeof agentRules === "object" && agentRules !== null ? agentRules["teamRules"] : void 0;
+  return typeof teamRules === "boolean" ? teamRules : false;
+}
+function resolveFsdStructure(config) {
+  const fsd = config?.["fsd"];
+  const enabled = typeof fsd === "object" && fsd !== null ? fsd["enabled"] : void 0;
+  if (typeof enabled === "boolean") return enabled;
+  const frontend = config?.["frontend"];
+  return typeof frontend === "string" && frontend !== "none";
+}
+function runAddAgentRules(tree, options, { recordHosts = true, fsdStructure } = {}) {
+  const config = readToolkitConfig(tree);
+  const hosts = resolveAiHostsOption(options.hosts, config);
+  const files = rulesFilesFor(hosts);
+  const locale = resolveLocaleOption(options.locale, config);
+  const teamRules = resolveTeamRules(options.teamRules, config);
+  const dryRun = options.dryRun ?? false;
+  const composed = composeAgentRules({ files, locale, teamRules, fsdStructure: fsdStructure ?? resolveFsdStructure(config) });
+  const results = composed.map(({ filePath, content }) => {
+    if (!validateAgentRules(content, teamRules ? ["team-rules"] : [])) {
+      throw new Error(
+        `Generated ${filePath} is missing a required section (Safety Rules, Language Policy${teamRules ? ", Team Rules" : ""})`
+      );
+    }
+    const existing = tree.read(filePath, "utf-8");
+    const outcome = applyAgentRulesBlock(existing, content);
+    switch (outcome.kind) {
+      case "unchanged":
+        return { filePath, action: "unchanged", reason: null, content: null };
+      case "unrecognized":
+        return { filePath, action: "unrecognized", reason: outcome.reason, content: null };
+      case "create":
+      case "append":
+      case "replace": {
+        if (!dryRun) tree.write(filePath, outcome.text);
+        const action = outcome.kind === "create" ? "created" : outcome.kind === "append" ? "appended" : "updated";
+        return { filePath, action, reason: null, content: dryRun ? outcome.text : null };
+      }
+    }
+  });
+  const explicit = options.hosts !== void 0 && options.hosts.length > 0;
+  const allApplied = results.every((file) => file.action !== "unrecognized");
+  const hostsRecord = explicit && recordHosts ? allApplied ? recordAiHosts(tree, hosts, !dryRun) : "not-applied" : "not-requested";
+  return { dryRun, locale, hosts, teamRules, files: results, hostsRecord };
+}
+async function addAgentRulesGenerator(tree, options) {
+  console.log(renderAddAgentRulesReport(runAddAgentRules(tree, { ...options, dryRun: resolveDryRun(options) })));
+}
+var generator_default = addAgentRulesGenerator;
+export {
+  addAgentRulesGenerator,
+  generator_default as default,
+  runAddAgentRules
+};

package/dist/generators/add-agent-rules/render.js

@@ -0,0 +1,46 @@
+const ACTION_LINE = {
+    created: (result) => `${result.filePath}: created`,
+    appended: (result) => `${result.filePath}: nx-archweave block added after the existing content (nothing else changed)`,
+    updated: (result) => `${result.filePath}: nx-archweave block updated (nothing outside it changed)`,
+    unchanged: (result) => `${result.filePath}: unchanged`,
+    unrecognized: (result) => `${result.filePath}: not written — ${result.reason ?? 'the nx-archweave markers could not be placed'}`,
+};
+export function renderAddAgentRulesReport(report) {
+    const lines = [];
+    lines.push(report.dryRun ? 'add-agent-rules dry-run — no files were written.' : 'add-agent-rules:');
+    lines.push(`  hosts: ${report.hosts.join(', ')}`);
+    lines.push(`  locale: ${report.locale}`);
+    lines.push(`  teamRules: ${report.teamRules}`);
+    lines.push('');
+    for (const file of report.files) {
+        lines.push(`  ${ACTION_LINE[file.action](file)}`);
+    }
+    const RECORD_LINE = {
+        created: 'toolkit.config.json: aiHosts recorded (file created)',
+        updated: 'toolkit.config.json: aiHosts recorded',
+        unchanged: 'toolkit.config.json: aiHosts already recorded',
+        unrecognized: 'toolkit.config.json: not a JSON object — aiHosts not recorded (fix the file, then rerun)',
+        'not-applied': 'toolkit.config.json: aiHosts not recorded — a file above was not written',
+        'not-requested': null,
+    };
+    const recordLine = RECORD_LINE[report.hostsRecord];
+    if (recordLine !== null)
+        lines.push(`  ${recordLine}`);
+    if (report.files.some((file) => file.action === 'unrecognized')) {
+        lines.push('');
+        lines.push('Manual fix needed: keep exactly one "<!-- nx-archweave:agent-rules start -->" … "<!-- nx-archweave:agent-rules end -->"');
+        lines.push('pair in the file (or remove both markers), then rerun add-agent-rules.');
+    }
+    if (report.dryRun) {
+        lines.push('');
+        lines.push('Generated content preview:');
+        for (const file of report.files) {
+            if (file.content === null)
+                continue;
+            lines.push('');
+            lines.push(`--- ${file.filePath} ---`);
+            lines.push(file.content);
+        }
+    }
+    return lines.join('\n');
+}