codex-workflows 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/.agents/skills/ai-development-guide/SKILL.md +283 -0
  2. package/.agents/skills/ai-development-guide/agents/openai.yaml +7 -0
  3. package/.agents/skills/ai-development-guide/references/frontend.md +135 -0
  4. package/.agents/skills/coding-rules/SKILL.md +98 -0
  5. package/.agents/skills/coding-rules/agents/openai.yaml +7 -0
  6. package/.agents/skills/coding-rules/references/typescript.md +220 -0
  7. package/.agents/skills/documentation-criteria/SKILL.md +127 -0
  8. package/.agents/skills/documentation-criteria/agents/openai.yaml +7 -0
  9. package/.agents/skills/documentation-criteria/references/adr-template.md +64 -0
  10. package/.agents/skills/documentation-criteria/references/design-template.md +327 -0
  11. package/.agents/skills/documentation-criteria/references/plan-template.md +131 -0
  12. package/.agents/skills/documentation-criteria/references/prd-template.md +119 -0
  13. package/.agents/skills/documentation-criteria/references/task-template.md +38 -0
  14. package/.agents/skills/documentation-criteria/references/ui-spec-template.md +145 -0
  15. package/.agents/skills/implementation-approach/SKILL.md +145 -0
  16. package/.agents/skills/implementation-approach/agents/openai.yaml +7 -0
  17. package/.agents/skills/integration-e2e-testing/SKILL.md +125 -0
  18. package/.agents/skills/integration-e2e-testing/agents/openai.yaml +7 -0
  19. package/.agents/skills/integration-e2e-testing/references/e2e-design.md +86 -0
  20. package/.agents/skills/recipe-add-integration-tests/SKILL.md +128 -0
  21. package/.agents/skills/recipe-add-integration-tests/agents/openai.yaml +7 -0
  22. package/.agents/skills/recipe-build/SKILL.md +119 -0
  23. package/.agents/skills/recipe-build/agents/openai.yaml +7 -0
  24. package/.agents/skills/recipe-design/SKILL.md +90 -0
  25. package/.agents/skills/recipe-design/agents/openai.yaml +7 -0
  26. package/.agents/skills/recipe-diagnose/SKILL.md +187 -0
  27. package/.agents/skills/recipe-diagnose/agents/openai.yaml +7 -0
  28. package/.agents/skills/recipe-front-build/SKILL.md +127 -0
  29. package/.agents/skills/recipe-front-build/agents/openai.yaml +7 -0
  30. package/.agents/skills/recipe-front-design/SKILL.md +90 -0
  31. package/.agents/skills/recipe-front-design/agents/openai.yaml +7 -0
  32. package/.agents/skills/recipe-front-plan/SKILL.md +68 -0
  33. package/.agents/skills/recipe-front-plan/agents/openai.yaml +7 -0
  34. package/.agents/skills/recipe-front-review/SKILL.md +101 -0
  35. package/.agents/skills/recipe-front-review/agents/openai.yaml +7 -0
  36. package/.agents/skills/recipe-fullstack-build/SKILL.md +139 -0
  37. package/.agents/skills/recipe-fullstack-build/agents/openai.yaml +7 -0
  38. package/.agents/skills/recipe-fullstack-implement/SKILL.md +151 -0
  39. package/.agents/skills/recipe-fullstack-implement/agents/openai.yaml +7 -0
  40. package/.agents/skills/recipe-implement/SKILL.md +125 -0
  41. package/.agents/skills/recipe-implement/agents/openai.yaml +7 -0
  42. package/.agents/skills/recipe-plan/SKILL.md +73 -0
  43. package/.agents/skills/recipe-plan/agents/openai.yaml +7 -0
  44. package/.agents/skills/recipe-reverse-engineer/SKILL.md +212 -0
  45. package/.agents/skills/recipe-reverse-engineer/agents/openai.yaml +7 -0
  46. package/.agents/skills/recipe-review/SKILL.md +115 -0
  47. package/.agents/skills/recipe-review/agents/openai.yaml +7 -0
  48. package/.agents/skills/recipe-task/SKILL.md +74 -0
  49. package/.agents/skills/recipe-task/agents/openai.yaml +7 -0
  50. package/.agents/skills/recipe-update-doc/SKILL.md +156 -0
  51. package/.agents/skills/recipe-update-doc/agents/openai.yaml +7 -0
  52. package/.agents/skills/subagents-orchestration-guide/SKILL.md +354 -0
  53. package/.agents/skills/subagents-orchestration-guide/agents/openai.yaml +7 -0
  54. package/.agents/skills/subagents-orchestration-guide/references/monorepo-flow.md +124 -0
  55. package/.agents/skills/task-analyzer/SKILL.md +142 -0
  56. package/.agents/skills/task-analyzer/agents/openai.yaml +7 -0
  57. package/.agents/skills/task-analyzer/references/skills-index.yaml +162 -0
  58. package/.agents/skills/testing/SKILL.md +324 -0
  59. package/.agents/skills/testing/agents/openai.yaml +7 -0
  60. package/.agents/skills/testing/references/typescript.md +224 -0
  61. package/.codex/agents/acceptance-test-generator.toml +310 -0
  62. package/.codex/agents/code-reviewer.toml +228 -0
  63. package/.codex/agents/code-verifier.toml +231 -0
  64. package/.codex/agents/design-sync.toml +265 -0
  65. package/.codex/agents/document-reviewer.toml +367 -0
  66. package/.codex/agents/integration-test-reviewer.toml +178 -0
  67. package/.codex/agents/investigator.toml +197 -0
  68. package/.codex/agents/prd-creator.toml +250 -0
  69. package/.codex/agents/quality-fixer-frontend.toml +356 -0
  70. package/.codex/agents/quality-fixer.toml +249 -0
  71. package/.codex/agents/requirement-analyzer.toml +172 -0
  72. package/.codex/agents/rule-advisor.toml +186 -0
  73. package/.codex/agents/scope-discoverer.toml +248 -0
  74. package/.codex/agents/solver.toml +212 -0
  75. package/.codex/agents/task-decomposer.toml +262 -0
  76. package/.codex/agents/task-executor-frontend.toml +312 -0
  77. package/.codex/agents/task-executor.toml +314 -0
  78. package/.codex/agents/technical-designer-frontend.toml +492 -0
  79. package/.codex/agents/technical-designer.toml +474 -0
  80. package/.codex/agents/ui-spec-designer.toml +150 -0
  81. package/.codex/agents/verifier.toml +228 -0
  82. package/.codex/agents/work-planner.toml +251 -0
  83. package/README.md +365 -0
  84. package/bin/cli.js +249 -0
  85. package/package.json +35 -0
@@ -0,0 +1,68 @@
1
+ ---
2
+ name: recipe-front-plan
3
+ description: "Create frontend work plan from design document with test skeleton generation."
4
+ ---
5
+
6
+ **Context**: Dedicated to the frontend planning phase.
7
+
8
+ ## Required Skills [LOAD BEFORE EXECUTION]
9
+
10
+ 1. [LOAD IF NOT ACTIVE] `documentation-criteria` -- document quality standards
11
+ 2. [LOAD IF NOT ACTIVE] `implementation-approach` -- implementation methodology
12
+ 3. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` -- agent coordination and workflow flows
13
+
14
+ ## Orchestrator Definition
15
+
16
+ **Core Identity**: "I am not a worker. I am an orchestrator."
17
+
18
+ **Execution Method**:
19
+ - Test skeleton generation -> performed by acceptance-test-generator
20
+ - Work plan creation -> performed by work-planner
21
+
22
+ Orchestrator spawns agents and passes structured data between them.
23
+
24
+ ## Scope Boundaries
25
+
26
+ **Included in this skill**:
27
+ - Design document selection
28
+ - Test skeleton generation with acceptance-test-generator
29
+ - Work plan creation with work-planner
30
+ - Plan approval obtainment
31
+
32
+ **Responsibility Boundary**: This skill completes with work plan approval.
33
+
34
+ Create frontend work plan with the following process:
35
+
36
+ ## Execution Process
37
+
38
+ ### Step 1: Design Document Selection
39
+ Check for existence of design documents in docs/design/.
40
+ - Present options if multiple exist (can be specified with $ARGUMENTS)
41
+
42
+ **[STOP -- BLOCKING]** If no design documents exist, notify user and halt.
43
+ **CANNOT proceed without a design document.**
44
+
45
+ ### Step 2: Test Skeleton Generation
46
+ Spawn acceptance-test-generator agent: "Generate test skeletons from Design Doc at [path]. [UI Spec at [ui-spec path] if exists.]"
47
+
48
+ ### Step 3: Work Plan Creation
49
+ Spawn work-planner agent: "Create work plan from Design Doc at [path]. Integration test file: [path from step 2]. E2E test file: [path from step 2]. Integration tests are created simultaneously with each phase implementation, E2E tests are executed only in final phase."
50
+
51
+ **[STOP -- BLOCKING]** Interact with user to complete plan and obtain approval for plan content. Clarify specific implementation steps and risks.
52
+ **CANNOT proceed until user explicitly approves the work plan.**
53
+
54
+ ENFORCEMENT: Plan content MUST be approved before declaring completion. Unapproved plans are invalid.
55
+
56
+ ## Completion Criteria
57
+
58
+ - [ ] Design document selected
59
+ - [ ] Test skeletons generated
60
+ - [ ] Work plan created
61
+ - [ ] User approved plan content
62
+
63
+ ## Output Example
64
+ Frontend planning phase completed.
65
+ - Work plan: docs/plans/[plan-name].md
66
+ - Status: Approved
67
+
68
+ Please provide separate instructions for implementation.
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "recipe-front-plan"
3
+ short_description: "Frontend design doc to work plan with tests"
4
+ default_prompt: "Use $recipe-front-plan to plan frontend work: "
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -0,0 +1,101 @@
1
+ ---
2
+ name: recipe-front-review
3
+ description: "Frontend Design Doc compliance validation with optional auto-fixes using React-specific quality checks."
4
+ ---
5
+
6
+ **Context**: Post-implementation quality assurance for React/TypeScript frontend
7
+
8
+ ## Required Skills [LOAD BEFORE EXECUTION]
9
+
10
+ 1. [LOAD IF NOT ACTIVE] `coding-rules` -- coding standards
11
+ 2. [LOAD IF NOT ACTIVE] `testing` -- test strategy and quality gates
12
+ 3. [LOAD IF NOT ACTIVE] `ai-development-guide` -- AI development patterns
13
+
14
+ ## Execution Method
15
+
16
+ - Compliance validation -> performed by code-reviewer
17
+ - Rule analysis -> performed by rule-advisor
18
+ - Fix implementation -> performed by task-executor-frontend
19
+ - Quality checks -> performed by quality-fixer-frontend
20
+ - Re-validation -> performed by code-reviewer
21
+
22
+ Orchestrator spawns agents and passes structured data between them.
23
+
24
+ Design Doc (uses most recent if omitted): $ARGUMENTS
25
+
26
+ ## Execution Flow
27
+
28
+ ### 1. Prerequisite Check
29
+ Identify the Design Doc in docs/design/ and check implementation files changed from the default branch (detect via `git symbolic-ref refs/remotes/origin/HEAD` or fall back to current branch diff).
30
+
31
+ **[STOP -- BLOCKING]** If no Design Doc or implementation files found, notify user and halt.
32
+ **CANNOT proceed without both a Design Doc and implementation files.**
33
+
34
+ ### 2. Execute code-reviewer
35
+ Spawn code-reviewer agent: "Validate Design Doc compliance for [design-doc-path]. Check: acceptance criteria fulfillment, code quality, implementation completeness."
36
+
37
+ ### 3. Verdict and Response
38
+
39
+ **Criteria (considering project stage)**:
40
+ - Prototype: Pass at 70%+
41
+ - Production: 90%+ recommended
42
+ - Critical items (security, etc.): Required regardless of rate
43
+
44
+ **Compliance-based response**:
45
+
46
+ For low compliance (production <90%):
47
+ ```
48
+ Validation Result: [X]% compliance
49
+ Unfulfilled items:
50
+ - [item list]
51
+
52
+ Execute fixes? (y/n):
53
+ ```
54
+
55
+ **[STOP -- BLOCKING]** Wait for user response on whether to execute fixes.
56
+ **CANNOT proceed with auto-fixes without user approval.**
57
+
58
+ If user selects `y`:
59
+
60
+ ## Pre-fix Metacognition
61
+ **Required flow**: rule-advisor -> task registration -> task-executor-frontend -> quality-fixer-frontend
62
+
63
+ 1. **Spawn rule-advisor agent**: "Analyze fixes needed for [unfulfilled items]. Determine root solutions vs symptomatic treatments."
64
+ 2. **Register tasks**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity". Create task file -> `docs/plans/tasks/review-fixes-YYYYMMDD.md`
65
+ 3. **Spawn task-executor-frontend agent**: "Execute staged auto-fixes for [task-file-path]. Stop at 5 files."
66
+ 4. **Spawn quality-fixer-frontend agent**: "Execute all frontend quality checks and confirm quality gate passage"
67
+ 5. **Re-validate**: Spawn code-reviewer agent: "Re-validate compliance for [design-doc-path]. Measure improvement."
68
+
69
+ ENFORCEMENT: Auto-fixes MUST go through quality-fixer-frontend before re-validation. Skipping quality checks invalidates fixes.
70
+
71
+ ### 4. Final Report
72
+ ```
73
+ Initial compliance: [X]%
74
+ Final compliance: [Y]% (if fixes executed)
75
+ Improvement: [Y-X]%
76
+
77
+ Remaining issues:
78
+ - [items requiring manual intervention]
79
+ ```
80
+
81
+ ## Auto-fixable Items
82
+ - Simple unimplemented acceptance criteria
83
+ - Error handling additions
84
+ - Contract definition fixes
85
+ - Function splitting (length/complexity improvements)
86
+
87
+ ## Non-fixable Items
88
+ - Fundamental business logic changes
89
+ - Architecture-level modifications
90
+ - Design Doc deficiencies
91
+
92
+ ## Completion Criteria
93
+
94
+ - [ ] Design Doc compliance validated
95
+ - [ ] Compliance percentage calculated
96
+ - [ ] User informed of results
97
+ - [ ] Fixes executed if requested and approved
98
+ - [ ] Quality gates passed for all fixes
99
+ - [ ] Final compliance re-measured
100
+
101
+ **Scope**: Design Doc compliance validation and auto-fixes.
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "recipe-front-review"
3
+ short_description: "Frontend Design Doc compliance with React-specific checks"
4
+ default_prompt: "Use $recipe-front-review to validate frontend: "
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -0,0 +1,139 @@
1
+ ---
2
+ name: recipe-fullstack-build
3
+ description: "Execute decomposed fullstack tasks with layer-aware agent routing between backend and frontend executors."
4
+ ---
5
+
6
+ ## Required Skills [LOAD BEFORE EXECUTION]
7
+
8
+ 1. [LOAD IF NOT ACTIVE] `coding-rules` -- coding standards
9
+ 2. [LOAD IF NOT ACTIVE] `testing` -- test strategy and quality gates
10
+ 3. [LOAD IF NOT ACTIVE] `ai-development-guide` -- AI development patterns
11
+ 4. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` -- agent coordination and workflow flows
12
+
13
+ ## Orchestrator Definition
14
+
15
+ **Core Identity**: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
16
+
17
+ ## Required Reference
18
+
19
+ **MANDATORY**: Read `references/monorepo-flow.md` from subagents-orchestration-guide skill BEFORE proceeding. Follow the Extended Task Cycle and Agent Routing defined there.
20
+
21
+ ENFORCEMENT: Proceeding without reading monorepo-flow.md invalidates the entire workflow.
22
+
23
+ ## Execution Protocol
24
+
25
+ 1. **Spawn agents for all work** -- your role is to invoke sub-agents, pass data between them, and report results
26
+ 2. **Route agents by task filename pattern** (see monorepo-flow.md reference):
27
+ - `*-backend-task-*` -> task-executor + quality-fixer
28
+ - `*-frontend-task-*` -> task-executor-frontend + quality-fixer-frontend
29
+ 3. **Follow the 4-step task cycle exactly**: executor -> escalation check -> quality-fixer -> commit
30
+ 4. **Enter autonomous mode** when user provides execution instruction with existing task files -- this IS the batch approval
31
+ 5. **Scope**: Complete when all tasks are committed or escalation occurs
32
+
33
+ **CRITICAL**: MUST run layer-appropriate quality-fixer before every commit.
34
+ ENFORCEMENT: Commits without quality-fixer approval are invalid and MUST be reverted.
35
+
36
+ Work plan: $ARGUMENTS
37
+
38
+ ## Pre-execution Prerequisites
39
+
40
+ ### Task File Existence Check
41
+ Check for work plans in docs/plans/ and task files in docs/plans/tasks/.
42
+
43
+ ### Task Generation Decision Flow
44
+
45
+ Analyze task file existence state and determine the action required:
46
+
47
+ | State | Criteria | Next Action |
48
+ |-------|----------|-------------|
49
+ | Tasks exist | .md files in tasks/ directory | User's execution instruction serves as batch approval -> Enter autonomous execution immediately |
50
+ | No tasks + plan exists | Plan exists but no task files | Confirm with user -> spawn task-decomposer |
51
+ | Neither exists | No plan or task files | Error: Prerequisites not met |
52
+
53
+ ## Task Decomposition Phase (Conditional)
54
+
55
+ When task files don't exist:
56
+
57
+ ### 1. User Confirmation
58
+ ```
59
+ No task files found.
60
+ Work plan: docs/plans/[plan-name].md
61
+
62
+ Generate tasks from the work plan? (y/n):
63
+ ```
64
+
65
+ ### 2. Task Decomposition (if approved)
66
+ Spawn task-decomposer agent: "Read work plan at docs/plans/[plan-name].md and decompose into atomic tasks. Output: Individual task files in docs/plans/tasks/. Granularity: 1 task = 1 commit = independently executable. Use layer-aware naming: {plan}-backend-task-{n}.md, {plan}-frontend-task-{n}.md based on target file paths."
67
+
68
+ ### 3. Verify Generation
69
+ Verify generated task files exist in docs/plans/tasks/.
70
+
71
+ ## Pre-execution Checklist
72
+
73
+ - [ ] Confirmed task files exist in docs/plans/tasks/
74
+ - [ ] Identified task execution order (dependencies)
75
+ - [ ] **Environment check**: Can I execute per-task commit cycle?
76
+ - If commit capability unavailable -> Escalate before autonomous mode
77
+ - Other environments (tests, quality tools) -> Subagents will escalate
78
+
79
+ ## Agent Routing Table
80
+
81
+ | Filename Pattern | Executor | Quality Fixer |
82
+ |-----------------|----------|---------------|
83
+ | `*-backend-task-*` | task-executor | quality-fixer |
84
+ | `*-frontend-task-*` | task-executor-frontend | quality-fixer-frontend |
85
+ | `*-task-*` (no layer prefix) | task-executor | quality-fixer (default) |
86
+
87
+ ## Task Execution Cycle (4-Step Cycle)
88
+
89
+ **MANDATORY EXECUTION CYCLE**: `executor -> escalation check -> quality-fixer -> commit`
90
+
91
+ For EACH task, YOU MUST:
92
+ 1. **Register tasks**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity"
93
+ 2. **Spawn task-executor or task-executor-frontend agent** (per routing table): "Execute the task implementation for [task-file-path]"
94
+ 3. **CHECK executor response**:
95
+ - `status: "escalation_needed"` or `"blocked"` -> STOP and escalate to user
96
+ - `testsAdded` contains `*.int.test.ts` or `*.e2e.test.ts` -> Spawn integration-test-reviewer agent: "Review integration tests in [test-files]"
97
+ - `needs_revision` -> Return to step 2 with `requiredFixes`
98
+ - `approved` -> Proceed to step 4
99
+ - `readyForQualityCheck: true` -> Proceed to step 4
100
+ 4. **Spawn quality-fixer agent** (layer-appropriate per routing table): "Execute all quality checks and fixes"
101
+ 5. **COMMIT on approval**: After `approved: true` from quality-fixer -> Execute git commit
102
+
103
+ **CRITICAL**: MUST monitor ALL structured responses WITHOUT EXCEPTION and ENSURE every quality gate is passed.
104
+ ENFORCEMENT: Proceeding past a failed quality gate invalidates all subsequent work.
105
+
106
+ ## Sub-agent Invocation Constraints
107
+
108
+ **MANDATORY suffix for ALL sub-agent prompts**:
109
+ ```
110
+ [SYSTEM CONSTRAINT]
111
+ This agent operates within build skill scope. Use orchestrator-provided rules only.
112
+ ```
113
+
114
+ Autonomous sub-agents require scope constraints for stable execution. MUST append this constraint to every sub-agent prompt.
115
+ ENFORCEMENT: Sub-agent prompts missing the constraint suffix MUST be re-issued with the constraint appended.
116
+
117
+ VERIFY approval status before proceeding. Once confirmed, INITIATE autonomous execution mode.
118
+
119
+ **[STOP -- BLOCKING]** Upon detecting ANY requirement changes, halt execution immediately.
120
+ **CANNOT proceed until user explicitly confirms the change scope.**
121
+
122
+ ## Completion Criteria
123
+
124
+ - [ ] monorepo-flow.md read before execution
125
+ - [ ] Task files verified in docs/plans/tasks/
126
+ - [ ] Task execution order identified with dependencies
127
+ - [ ] Environment check completed (commit capability confirmed)
128
+ - [ ] All tasks routed to correct layer-appropriate agents
129
+ - [ ] All tasks executed through 4-step cycle (executor -> check -> quality-fixer -> commit)
130
+ - [ ] System constraint suffix appended to all sub-agent prompts
131
+ - [ ] All quality gates passed
132
+ - [ ] All tasks committed or escalation completed
133
+
134
+ ## Output Example
135
+ Fullstack implementation phase completed.
136
+ - Task decomposition: Generated under docs/plans/tasks/
137
+ - Implemented tasks: [number] tasks (backend: X, frontend: Y)
138
+ - Quality checks: All passed
139
+ - Commits: [number] commits created
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "recipe-fullstack-build"
3
+ short_description: "Layer-aware fullstack task execution with routing"
4
+ default_prompt: "Use $recipe-fullstack-build to start building fullstack: "
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -0,0 +1,151 @@
1
+ ---
2
+ name: recipe-fullstack-implement
3
+ description: "Orchestrate full-cycle implementation across backend and frontend layers with layer-aware agent routing."
4
+ ---
5
+
6
+ **Context**: Full-cycle fullstack implementation management (Requirements Analysis -> Design (backend + frontend) -> Planning -> Implementation -> Quality Assurance)
7
+
8
+ ## Required Skills [LOAD BEFORE EXECUTION]
9
+
10
+ 1. [LOAD IF NOT ACTIVE] `coding-rules` -- coding standards
11
+ 2. [LOAD IF NOT ACTIVE] `testing` -- test strategy and quality gates
12
+ 3. [LOAD IF NOT ACTIVE] `ai-development-guide` -- AI development patterns
13
+ 4. [LOAD IF NOT ACTIVE] `documentation-criteria` -- document quality standards
14
+ 5. [LOAD IF NOT ACTIVE] `implementation-approach` -- implementation methodology
15
+ 6. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` -- agent coordination and workflow flows
16
+
17
+ ## Orchestrator Definition
18
+
19
+ **Core Identity**: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
20
+
21
+ ## Required Reference
22
+
23
+ **MANDATORY**: Read `references/monorepo-flow.md` from subagents-orchestration-guide skill BEFORE proceeding. Follow the Fullstack Flow defined there instead of the standard single-layer flow.
24
+
25
+ ENFORCEMENT: Proceeding without reading monorepo-flow.md invalidates the entire workflow.
26
+
27
+ ## Execution Protocol
28
+
29
+ 1. **Spawn agents for all work** -- your role is to invoke sub-agents, pass data between them, and report results
30
+ 2. **Follow monorepo-flow.md** for the design phase (multiple Design Docs, design-sync, vertical slicing)
31
+ 3. **Follow subagents-orchestration-guide skill** for all other orchestration rules (stop points, structured responses, escalation)
32
+ 4. **Enter autonomous mode** only after "batch approval for entire implementation phase"
33
+
34
+ **CRITICAL**: Execute all steps, sub-agents, and stopping points defined in both the monorepo-flow.md reference and subagents-orchestration-guide skill.
35
+
36
+ ## Execution Decision Flow
37
+
38
+ ### 1. Current Situation Assessment
39
+ Instruction Content: $ARGUMENTS
40
+
41
+ Assess the current situation:
42
+
43
+ | Situation Pattern | Decision Criteria | Next Action |
44
+ |------------------|------------------|-------------|
45
+ | New Requirements | No existing work, new feature/fix request | Start with requirement-analyzer |
46
+ | Flow Continuation | Existing docs/tasks present, continuation directive | Identify next step in monorepo-flow.md |
47
+ | Quality Errors | Error detection, test failures, build errors | Execute quality-fixer (layer-appropriate) |
48
+ | Ambiguous | Intent unclear, multiple interpretations possible | Confirm with user |
49
+
50
+ ### 2. Progress Verification for Continuation
51
+
52
+ When continuing existing flow, verify:
53
+ - Latest artifacts (PRD/ADR/Design Docs/Work Plan/Tasks)
54
+ - Current phase position (Requirements/Design/Planning/Implementation/QA)
55
+ - Identify next step in monorepo-flow.md
56
+
57
+ ### 3. Execute monorepo-flow.md
58
+
59
+ **Follow monorepo-flow.md step-by-step** for the complete flow from UI Spec through Design Docs through Work Plan. The flow includes:
60
+ - UI Spec creation (with prototype inquiry)
61
+ - Separate Design Docs per layer (technical-designer for backend, technical-designer-frontend for frontend)
62
+ - **Backend Design Doc**: Spawn technical-designer agent
63
+ - **Frontend Design Doc**: Spawn technical-designer-frontend agent (MUST use frontend-specific agent)
64
+ - document-reviewer per Design Doc
65
+ - design-sync for cross-layer consistency
66
+ - Work plan with vertical slicing
67
+
68
+ All stop points defined in monorepo-flow.md MUST be respected.
69
+
70
+ ### 5. Register All Flow Steps (MANDATORY)
71
+
72
+ **After scale determination, register all steps of the monorepo-flow.md**:
73
+ - First task: "Confirm skill constraints"
74
+ - Register each step as individual task
75
+ - Mark currently executing step as in_progress
76
+ - **Complete task registration before spawning subagents**
77
+
78
+ ## After requirement-analyzer [Stop]
79
+
80
+ When user responds to questions:
81
+ - If response matches any `scopeDependencies.question` -> Check `impact` for scale change
82
+ - If scale changes -> Re-execute requirement-analyzer with updated context
83
+ - If `confidence: "confirmed"` or no scale change -> Proceed to next step
84
+
85
+ ## Orchestration Compliance
86
+
87
+ **Pre-execution Checklist (MANDATORY)**:
88
+ - [ ] Read monorepo-flow.md reference
89
+ - [ ] Confirmed relevant flow steps
90
+ - [ ] Identified current progress position
91
+ - [ ] Clarified next step
92
+ - [ ] Recognized stopping points
93
+ - [ ] **Environment check**: Can I execute per-task commit cycle?
94
+ - If commit capability unavailable -> Escalate before autonomous mode
95
+ - Other environments (tests, quality tools) -> Subagents will escalate
96
+
97
+ **Required Flow Compliance**:
98
+ - Run quality-fixer (layer-appropriate) before every commit
99
+ - Obtain user approval before Edit/Write outside autonomous mode
100
+
101
+ ENFORCEMENT: Commits without quality-fixer approval are invalid and MUST be reverted.
102
+
103
+ ## Sub-agent Invocation Constraints
104
+
105
+ **MANDATORY suffix for ALL sub-agent prompts**:
106
+ ```
107
+ [SYSTEM CONSTRAINT]
108
+ This agent operates within fullstack-implement skill scope. Use orchestrator-provided rules only.
109
+ ```
110
+
111
+ Autonomous sub-agents require scope constraints for stable execution. MUST append this constraint to every sub-agent prompt.
112
+ ENFORCEMENT: Sub-agent prompts missing the constraint suffix MUST be re-issued with the constraint appended.
113
+
114
+ ## Task Execution Quality Cycle (Filename-Pattern-Based)
115
+
116
+ **Agent routing by task filename** (see monorepo-flow.md reference):
117
+ ```
118
+ *-backend-task-* -> task-executor + quality-fixer
119
+ *-frontend-task-* -> task-executor-frontend + quality-fixer-frontend
120
+ ```
121
+
122
+ **Rules**:
123
+ 1. Execute ONE task completely before starting next (each task goes through the full 4-step cycle individually, using the correct executor per filename pattern)
124
+ 2. Check executor status before quality-fixer (escalation check)
125
+ 3. Quality-fixer MUST run after each executor (no skipping)
126
+ 4. Commit MUST execute when quality-fixer returns `approved: true` (do not defer to end)
127
+
128
+ ### Test Information Communication
129
+ After acceptance-test-generator execution, when calling work-planner, communicate:
130
+ - Generated integration test file path
131
+ - Generated E2E test file path
132
+ - Explicit note that integration tests are created simultaneously with implementation, E2E tests are executed after all implementations
133
+
134
+ **[STOP -- BLOCKING]** Upon detecting ANY requirement changes, halt execution immediately.
135
+ **CANNOT proceed until user explicitly confirms the change scope.**
136
+
137
+ ## Completion Criteria
138
+
139
+ - [ ] monorepo-flow.md read before execution
140
+ - [ ] All flow steps registered
141
+ - [ ] Separate Design Docs created per layer
142
+ - [ ] Design-sync executed for cross-layer consistency
143
+ - [ ] All stop points respected with user approval
144
+ - [ ] All tasks executed through layer-appropriate 4-step cycle
145
+ - [ ] All quality gates passed
146
+ - [ ] All tasks committed or escalation completed
147
+
148
+ ## Execution Method
149
+
150
+ All work is executed through sub-agents.
151
+ Sub-agent selection follows monorepo-flow.md reference and subagents-orchestration-guide skill.
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "recipe-fullstack-implement"
3
+ short_description: "Full-cycle cross-layer implementation orchestration"
4
+ default_prompt: "Use $recipe-fullstack-implement to implement a fullstack feature: "
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -0,0 +1,125 @@
1
+ ---
2
+ name: recipe-implement
3
+ description: "Orchestrate the complete implementation lifecycle from requirements to deployment."
4
+ ---
5
+
6
+ ## Required Skills [LOAD BEFORE EXECUTION]
7
+
8
+ 1. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — agent coordination and workflow flows
9
+ 2. [LOAD IF NOT ACTIVE] `documentation-criteria` — document creation rules and templates
10
+
11
+ # Full-Cycle Implementation
12
+
13
+ $ARGUMENTS
14
+
15
+ ## Orchestrator Definition
16
+
17
+ **Core Identity**: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
18
+
19
+ **CRITICAL**: MUST execute all steps, sub-agents, and stopping points defined in subagents-orchestration-guide skill flows.
20
+ ENFORCEMENT: Skipping any step or stopping point invalidates the entire workflow output.
21
+
22
+ ## CRITICAL Sub-agent Invocation Constraints
23
+
24
+ **MANDATORY suffix for ALL sub-agent prompts**:
25
+ ```
26
+ [SYSTEM CONSTRAINT]
27
+ This agent operates within implement skill scope. Use orchestrator-provided rules only.
28
+ ```
29
+ ENFORCEMENT: Sub-agent prompts missing the constraint suffix MUST be re-issued with the constraint appended.
30
+
31
+ ## Step 1: Requirement Analysis
32
+
33
+ Spawn requirement-analyzer agent to determine scale and affected layers.
34
+
35
+ **[STOP — BLOCKING]** Present requirement-analyzer output (scale, affectedLayers, scope) to user for confirmation. **CANNOT proceed until user explicitly confirms.**
36
+
37
+ When user responds to questions:
38
+ - If response matches any `scopeDependencies.question` -> Check `impact` for scale change
39
+ - If scale changes -> Re-execute requirement-analyzer with updated context
40
+ - If `confidence: "confirmed"` or no scale change -> Proceed to Step 2
41
+
42
+ ## Step 2: Layer-Based Workflow Routing
43
+
44
+ Based on requirement-analyzer output `affectedLayers`, route to the appropriate workflow:
45
+
46
+ | affectedLayers | Workflow | Reference |
47
+ |---|---|---|
48
+ | `["backend"]` only | Backend Flow | subagents-orchestration-guide skill (Large/Medium/Small scale) |
49
+ | `["frontend"]` only | Frontend Flow | See Frontend Flow below |
50
+ | `["backend", "frontend"]` | Fullstack Flow | subagents-orchestration-guide `references/monorepo-flow.md` |
51
+
52
+ ---
53
+
54
+ ### Backend Flow
55
+
56
+ Follow subagents-orchestration-guide skill Large/Medium/Small scale flow exactly. All steps, stopping points, and sub-agent sequencing are defined there.
57
+
58
+ ---
59
+
60
+ ### Frontend Flow
61
+
62
+ **STEP 1**: Ask user if they have prototype code or UI references to provide.
63
+
64
+ **STEP 2**: Spawn ui-spec-designer agent → spawn document-reviewer agent.
65
+ **[STOP — BLOCKING]** Present UI Spec for user approval. **CANNOT proceed until user explicitly confirms.**
66
+
67
+ **STEP 3**: Spawn technical-designer-frontend agent → spawn document-reviewer agent → spawn design-sync agent.
68
+ **[STOP — BLOCKING]** Present Frontend Design Doc for user approval. **CANNOT proceed until user explicitly confirms.**
69
+
70
+ **STEP 4**: Spawn acceptance-test-generator agent → spawn work-planner agent.
71
+ **[STOP — BLOCKING]** Present Work Plan for user approval. **CANNOT proceed until user explicitly confirms.**
72
+
73
+ **STEP 5**: Enter guided autonomous execution (see Autonomous Execution Mode below) using task-executor-frontend + quality-fixer-frontend agents.
74
+
75
+ ---
76
+
77
+ ### Fullstack Flow
78
+
79
+ Follow subagents-orchestration-guide `references/monorepo-flow.md` for the complete cross-layer workflow, including:
80
+ - Separate Design Docs per layer
81
+ - design-sync for cross-layer consistency
82
+ - Vertical slicing in work-planner
83
+ - Layer-aware task execution routing
84
+
85
+ ---
86
+
87
+ ## Autonomous Execution Mode
88
+
89
+ After user grants "batch approval for entire implementation phase", enter autonomous execution.
90
+
91
+ ### Task Execution Quality Cycle (4-Step Cycle per Task)
92
+
93
+ **Agent routing by task filename** (for fullstack projects):
94
+ ```
95
+ *-backend-task-* -> Spawn task-executor agent + quality-fixer agent
96
+ *-frontend-task-* -> Spawn task-executor-frontend agent + quality-fixer-frontend agent
97
+ *-task-* (no layer prefix) -> Spawn task-executor agent + quality-fixer agent (default)
98
+ ```
99
+
100
+ **Per-task cycle** (complete each task before starting next):
101
+ 1. Spawn task-executor (or task-executor-frontend) agent: "Implement task [task-file-path]"
102
+ 2. Check task-executor response:
103
+ - `status: escalation_needed` or `blocked` -> Escalate to user
104
+ - `testsAdded` contains `*.int.test.ts` or `*.e2e.test.ts` -> Spawn integration-test-reviewer agent
105
+ - `needs_revision` -> Return to step 1 with `requiredFixes`
106
+ - `approved` -> Proceed to step 3
107
+ - Otherwise -> Proceed to step 3
108
+ 3. Spawn quality-fixer (or quality-fixer-frontend) agent: "Quality check and fixes"
109
+ 4. git commit -> Execute on `approved: true`
110
+
111
+ ### Test Information Communication
112
+ After acceptance-test-generator execution, when spawning work-planner, communicate:
113
+ - Generated integration test file path
114
+ - Generated E2E test file path
115
+ - Note: integration tests are created with implementation; E2E tests run after all implementations
116
+
117
+ ## Completion Criteria
118
+
119
+ - [ ] Requirement analysis completed and user-confirmed
120
+ - [ ] Layer routing determined (backend / frontend / fullstack)
121
+ - [ ] Correct workflow followed per layer routing
122
+ - [ ] All stopping points honored with user confirmation obtained
123
+ - [ ] Quality-fixer spawned before every commit
124
+ - [ ] All tasks committed or escalation completed
125
+ - [ ] System constraint suffix appended to all sub-agent prompts
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "recipe-implement"
3
+ short_description: "Requirements to deployment lifecycle"
4
+ default_prompt: "Use $recipe-implement to start implementing: "
5
+
6
+ policy:
7
+ allow_implicit_invocation: false