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.
- package/.agents/skills/ai-development-guide/SKILL.md +283 -0
- package/.agents/skills/ai-development-guide/agents/openai.yaml +7 -0
- package/.agents/skills/ai-development-guide/references/frontend.md +135 -0
- package/.agents/skills/coding-rules/SKILL.md +98 -0
- package/.agents/skills/coding-rules/agents/openai.yaml +7 -0
- package/.agents/skills/coding-rules/references/typescript.md +220 -0
- package/.agents/skills/documentation-criteria/SKILL.md +127 -0
- package/.agents/skills/documentation-criteria/agents/openai.yaml +7 -0
- package/.agents/skills/documentation-criteria/references/adr-template.md +64 -0
- package/.agents/skills/documentation-criteria/references/design-template.md +327 -0
- package/.agents/skills/documentation-criteria/references/plan-template.md +131 -0
- package/.agents/skills/documentation-criteria/references/prd-template.md +119 -0
- package/.agents/skills/documentation-criteria/references/task-template.md +38 -0
- package/.agents/skills/documentation-criteria/references/ui-spec-template.md +145 -0
- package/.agents/skills/implementation-approach/SKILL.md +145 -0
- package/.agents/skills/implementation-approach/agents/openai.yaml +7 -0
- package/.agents/skills/integration-e2e-testing/SKILL.md +125 -0
- package/.agents/skills/integration-e2e-testing/agents/openai.yaml +7 -0
- package/.agents/skills/integration-e2e-testing/references/e2e-design.md +86 -0
- package/.agents/skills/recipe-add-integration-tests/SKILL.md +128 -0
- package/.agents/skills/recipe-add-integration-tests/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-build/SKILL.md +119 -0
- package/.agents/skills/recipe-build/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-design/SKILL.md +90 -0
- package/.agents/skills/recipe-design/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-diagnose/SKILL.md +187 -0
- package/.agents/skills/recipe-diagnose/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-front-build/SKILL.md +127 -0
- package/.agents/skills/recipe-front-build/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-front-design/SKILL.md +90 -0
- package/.agents/skills/recipe-front-design/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-front-plan/SKILL.md +68 -0
- package/.agents/skills/recipe-front-plan/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-front-review/SKILL.md +101 -0
- package/.agents/skills/recipe-front-review/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-fullstack-build/SKILL.md +139 -0
- package/.agents/skills/recipe-fullstack-build/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-fullstack-implement/SKILL.md +151 -0
- package/.agents/skills/recipe-fullstack-implement/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-implement/SKILL.md +125 -0
- package/.agents/skills/recipe-implement/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-plan/SKILL.md +73 -0
- package/.agents/skills/recipe-plan/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-reverse-engineer/SKILL.md +212 -0
- package/.agents/skills/recipe-reverse-engineer/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-review/SKILL.md +115 -0
- package/.agents/skills/recipe-review/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-task/SKILL.md +74 -0
- package/.agents/skills/recipe-task/agents/openai.yaml +7 -0
- package/.agents/skills/recipe-update-doc/SKILL.md +156 -0
- package/.agents/skills/recipe-update-doc/agents/openai.yaml +7 -0
- package/.agents/skills/subagents-orchestration-guide/SKILL.md +354 -0
- package/.agents/skills/subagents-orchestration-guide/agents/openai.yaml +7 -0
- package/.agents/skills/subagents-orchestration-guide/references/monorepo-flow.md +124 -0
- package/.agents/skills/task-analyzer/SKILL.md +142 -0
- package/.agents/skills/task-analyzer/agents/openai.yaml +7 -0
- package/.agents/skills/task-analyzer/references/skills-index.yaml +162 -0
- package/.agents/skills/testing/SKILL.md +324 -0
- package/.agents/skills/testing/agents/openai.yaml +7 -0
- package/.agents/skills/testing/references/typescript.md +224 -0
- package/.codex/agents/acceptance-test-generator.toml +310 -0
- package/.codex/agents/code-reviewer.toml +228 -0
- package/.codex/agents/code-verifier.toml +231 -0
- package/.codex/agents/design-sync.toml +265 -0
- package/.codex/agents/document-reviewer.toml +367 -0
- package/.codex/agents/integration-test-reviewer.toml +178 -0
- package/.codex/agents/investigator.toml +197 -0
- package/.codex/agents/prd-creator.toml +250 -0
- package/.codex/agents/quality-fixer-frontend.toml +356 -0
- package/.codex/agents/quality-fixer.toml +249 -0
- package/.codex/agents/requirement-analyzer.toml +172 -0
- package/.codex/agents/rule-advisor.toml +186 -0
- package/.codex/agents/scope-discoverer.toml +248 -0
- package/.codex/agents/solver.toml +212 -0
- package/.codex/agents/task-decomposer.toml +262 -0
- package/.codex/agents/task-executor-frontend.toml +312 -0
- package/.codex/agents/task-executor.toml +314 -0
- package/.codex/agents/technical-designer-frontend.toml +492 -0
- package/.codex/agents/technical-designer.toml +474 -0
- package/.codex/agents/ui-spec-designer.toml +150 -0
- package/.codex/agents/verifier.toml +228 -0
- package/.codex/agents/work-planner.toml +251 -0
- package/README.md +365 -0
- package/bin/cli.js +249 -0
- 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,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,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,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,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
|