feat(#1135): migrate planning hooks to capabilities (#1141)

* feat(#1135): migrate planning hooks to capabilities

* chore(#1135): add phase 6 planning capabilities changeset

* fix(#1135): satisfy lint for agent hook rendering

capabilities/ai-integration/capability.json

@@ -0,0 +1,35 @@
+{
+  "id": "ai-integration",
+  "role": "feature",
+  "title": "AI design contract",
+  "description": "AI-SPEC design contract workflow for phases that build AI systems; owns the AI integration command, agents, and workflow.ai_integration_phase activation key.",
+  "tier": "full",
+  "requires": [],
+  "skills": ["ai-integration-phase"],
+  "agents": [
+    "gsd-framework-selector",
+    "gsd-ai-researcher",
+    "gsd-domain-researcher",
+    "gsd-eval-planner"
+  ],
+  "hooks": [],
+  "config": {
+    "workflow.ai_integration_phase": {
+      "type": "boolean",
+      "default": true,
+      "description": "Prompt for an AI-SPEC design contract before planning phases that involve AI systems."
+    }
+  },
+  "steps": [
+    {
+      "point": "plan:pre",
+      "ref": { "skill": "ai-integration-phase" },
+      "produces": ["AI-SPEC.md"],
+      "consumes": ["CONTEXT.md"],
+      "when": "workflow.ai_integration_phase",
+      "onError": "skip"
+    }
+  ],
+  "contributions": [],
+  "gates": []
+}

capabilities/pattern-mapper/capability.json

@@ -0,0 +1,31 @@
+{
+  "id": "pattern-mapper",
+  "role": "feature",
+  "title": "Pattern mapping",
+  "description": "Optional codebase-pattern mapping before planning; owns the pattern mapper agent and workflow.pattern_mapper activation key.",
+  "tier": "full",
+  "requires": ["research"],
+  "skills": [],
+  "agents": ["gsd-pattern-mapper"],
+  "hooks": [],
+  "config": {
+    "workflow.pattern_mapper": {
+      "type": "boolean",
+      "default": true,
+      "description": "Run the pattern mapper before planning when context or research is available."
+    }
+  },
+  "steps": [
+    {
+      "point": "plan:pre",
+      "ref": { "agent": "gsd-pattern-mapper" },
+      "fragment": { "path": "fragments/plan-pre.md" },
+      "produces": ["PATTERNS.md"],
+      "consumes": ["RESEARCH.md"],
+      "when": "workflow.pattern_mapper",
+      "onError": "skip"
+    }
+  ],
+  "contributions": [],
+  "gates": []
+}

capabilities/pattern-mapper/fragments/plan-pre.md

@@ -0,0 +1,14 @@
+<pattern_mapping_context>
+**Phase:** {phase_number} - {phase_name}
+**Phase directory:** {phase_dir}
+**Padded phase:** {padded_phase}
+
+<files_to_read>
+- {context_path} (USER DECISIONS from /gsd:discuss-phase)
+- {research_path} (Technical Research)
+</files_to_read>
+
+**Output file:** {phase_dir}/{padded_phase}-PATTERNS.md
+
+Extract the list of files to be created/modified from CONTEXT.md and RESEARCH.md. For each file, classify by role and data flow, find the closest existing analog in the codebase, extract concrete code excerpts, and produce PATTERNS.md.
+</pattern_mapping_context>

capabilities/research/capability.json

@@ -0,0 +1,31 @@
+{
+  "id": "research",
+  "role": "feature",
+  "title": "Phase research",
+  "description": "Optional phase research before planning; owns the phase researcher agent and workflow.research activation key.",
+  "tier": "standard",
+  "requires": [],
+  "skills": [],
+  "agents": ["gsd-phase-researcher"],
+  "hooks": [],
+  "config": {
+    "workflow.research": {
+      "type": "boolean",
+      "default": true,
+      "description": "Run phase research before planning when research artifacts are missing or explicitly refreshed."
+    }
+  },
+  "steps": [
+    {
+      "point": "plan:pre",
+      "ref": { "agent": "gsd-phase-researcher" },
+      "fragment": { "path": "fragments/plan-pre.md" },
+      "produces": ["RESEARCH.md"],
+      "consumes": ["CONTEXT.md"],
+      "when": "workflow.research",
+      "onError": "skip"
+    }
+  ],
+  "contributions": [],
+  "gates": []
+}

capabilities/research/fragments/plan-pre.md

@@ -0,0 +1,24 @@
+<objective>
+Research how to implement Phase {phase_number}: {phase_name}
+Answer: "What do I need to know to PLAN this phase well?"
+</objective>
+
+<files_to_read>
+- {context_path} (USER DECISIONS from /gsd:discuss-phase)
+- {requirements_path} (Project requirements)
+- {state_path} (Project decisions and history)
+</files_to_read>
+
+${AGENT_SKILLS_RESEARCHER}
+
+<additional_context>
+**Phase description:** {phase_description}
+**Phase requirement IDs (MUST address):** {phase_req_ids}
+
+**Project instructions:** Read ./CLAUDE.md or ./.claude/CLAUDE.md if either exists; follow project-specific guidelines.
+**Project skills:** Check .claude/skills/ or .agents/skills/ directory if either exists. Read SKILL.md files and account for project skill patterns.
+</additional_context>
+
+<output>
+Write to: {phase_dir}/{phase_num}-RESEARCH.md
+</output>