diff --git a/.github/prompts/feature-backlog.prompt.md b/.github/prompts/feature-backlog.prompt.md new file mode 100644 index 00000000..aaba9f1c --- /dev/null +++ b/.github/prompts/feature-backlog.prompt.md @@ -0,0 +1,33 @@ +--- +agent: feature-orchestrator +description: "Create approved PBIs as work items in Azure DevOps" +--- + +# Backlog Phase + +Read the PBI creator skill from #file:.github/skills/pbi-creator/SKILL.md + +## Your Task + +You are in the **Backlog** phase. The plan has been approved and you need to create PBIs in ADO. + +**Step 1**: Read the feature state: +```powershell +node .github/hooks/state-utils.js get-feature "" +``` + +**Step 2**: Follow the **Creation Phase** instructions from the orchestrator agent: +1. Pass the FULL plan to the `pbi-creator` subagent +2. The pbi-creator will discover ADO defaults, present options via `askQuestion`, and create work items +3. Present the creation summary with AB# IDs +4. Use `askQuestion` to gate the next stage + +**Pipeline**: ✅ Design → ✅ Plan → 📝 **Backlog** → ○ Dispatch → ○ Monitor + +After PBIs are created, update state for EACH PBI: +```powershell +node .github/hooks/state-utils.js set-step "" backlog_review +node .github/hooks/state-utils.js add-pbi "" '{"adoId":,"title":"...","module":"...","status":"Committed","dependsOn":[]}' +``` + +**IMPORTANT**: Use single quotes for JSON args in PowerShell. diff --git a/.github/prompts/feature-continue.prompt.md b/.github/prompts/feature-continue.prompt.md new file mode 100644 index 00000000..6c805315 --- /dev/null +++ b/.github/prompts/feature-continue.prompt.md @@ -0,0 +1,41 @@ +--- +agent: feature-orchestrator +description: "Resume working on a feature from its current pipeline step" +--- + +# Continue Feature + +## Your Task + +Resume working on a feature. The user will provide the feature name below. + +**Step 1**: Read the feature state: +```powershell +node .github/hooks/state-utils.js get-feature "" +``` + +**Step 2**: Determine the current step from the `step` field and resume from there: + +| Step | What to do | +|------|-----------| +| `designing` | Continue writing the design spec | +| `design_review` | Design is done — ask user if they want to plan PBIs. Use `askQuestion`. | +| `planning` | Continue planning PBIs | +| `plan_review` | Plan is done — ask user if they want to backlog in ADO. Use `askQuestion`. | +| `backlogging` | Continue creating PBIs in ADO | +| `backlog_review` | PBIs created — ask user if they want to dispatch. Use `askQuestion`. | +| `dispatching` | Continue dispatching | +| `monitoring` | Check PR status (follow Monitor phase instructions) | + +**Step 3**: Show the pipeline progress header: +``` +## 🚀 Feature Orchestration: [Phase Name] + +**Feature**: [feature name] +**Pipeline**: [show ✅/📋/○ for each stage based on current step] +``` + +Read `.github/copilot-instructions.md` for project context. + +**IMPORTANT**: Use single quotes for JSON args in PowerShell. +Always update state after completing a phase step. diff --git a/.github/prompts/feature-design.prompt.md b/.github/prompts/feature-design.prompt.md new file mode 100644 index 00000000..8ce891f0 --- /dev/null +++ b/.github/prompts/feature-design.prompt.md @@ -0,0 +1,31 @@ +--- +agent: feature-orchestrator +description: "Start a new feature: research the codebase and write a design spec" +--- + +# Design Phase + +## Your Task + +You are in the **Design** phase. The user will describe a feature below. + +**Step 0**: Register the feature in state: +```powershell +node .github/hooks/state-utils.js add-feature '{"name": "", "step": "designing"}' +``` + +Then follow the **Full Flow** instructions from the orchestrator agent: +1. Run the `codebase-researcher` subagent with a detailed prompt +2. Pass the FULL research output to the `design-writer` subagent +3. Present the design summary and use `askQuestion` to offer next steps + +**Pipeline**: 📝 **Design** → ○ Plan → ○ Backlog → ○ Dispatch → ○ Monitor + +Read `.github/copilot-instructions.md` for project context. + +**IMPORTANT**: Use single quotes for JSON args in PowerShell. +After the design is complete, update state: +```powershell +node .github/hooks/state-utils.js set-step "" design_review +node .github/hooks/state-utils.js set-design "" '{"docPath":"","status":"approved"}' +``` diff --git a/.github/prompts/feature-dispatch.prompt.md b/.github/prompts/feature-dispatch.prompt.md new file mode 100644 index 00000000..c04487b7 --- /dev/null +++ b/.github/prompts/feature-dispatch.prompt.md @@ -0,0 +1,32 @@ +--- +agent: feature-orchestrator +description: "Dispatch PBIs to GitHub Copilot coding agent for implementation" +--- + +# Dispatch Phase + +Read the dispatcher skill from #file:.github/skills/pbi-dispatcher/SKILL.md + +## Your Task + +You are in the **Dispatch** phase. PBIs have been created in ADO and you need to dispatch them. + +**Step 1**: Read the feature state to get PBI details: +```powershell +node .github/hooks/state-utils.js get-feature "" +``` + +**Step 2**: Follow the **Dispatch Phase** instructions from the orchestrator agent: +1. Run the `agent-dispatcher` subagent to dispatch PBIs to Copilot coding agent +2. Record each dispatched PR in state +3. Use `askQuestion` to gate the next stage + +**Pipeline**: ✅ Design → ✅ Plan → ✅ Backlog → 🚀 **Dispatch** → ○ Monitor + +After dispatch, update state: +```powershell +node .github/hooks/state-utils.js set-step "" monitoring +node .github/hooks/state-utils.js add-agent-pr "" '{"repo":"