Add documentation guidance hierarchy for AI agents

Author: m-prosper-10

src/agent/composer.ts

@@ -541,6 +541,11 @@ export function composeCursorPrinciples(config: ProjectConfig): string[] {
     "",
     "# AI Working Rules",
     "",
+    "Before making changes:",
+    "1. Read `docs/AGENTS.md` for project rules and constraints.",
+    "2. Read `docs/instructions.md` for setup, verification, and extension workflow.",
+    "3. Treat these documents as the source of truth for repository-specific agent behavior.",
+    "",
     "Act like: Senior Engineer + Pragmatic Architect + Fast Implementer.",
     "",
     "Prioritize:",

src/utils/agentRules.ts

@@ -75,6 +75,13 @@ function buildAgentsGuide(config: ProjectConfig): string {
     "- Dribbble designer",
     "- Framework collector",
     "",
+    "## Guidance Order",
+    "",
+    "When working in this repository:",
+    "1. Follow `.cursorrules` for concise working behavior.",
+    "2. Follow this `AGENTS.md` for engineering policy and constraints.",
+    "3. Use `docs/instructions.md` for setup, verification, and extension workflow.",
+    "",
     ...composeSharedConstitution(),
     "",
     "## Current Project Profile",