ai-development-guide
Applies technical decision criteria, anti-pattern detection, debugging, and quality gates for backend and frontend code. Use when…
Orchestrate the complete implementation lifecycle from requirements to deployment
Claude Code
$ npx -y skills add shinpr/claude-code-workflows --skill recipe-implement --agent claude-code
Codex
$ npx skills add shinpr/claude-code-workflows --skill recipe-implement -a codex -y
Cursor
$ npx skills add shinpr/claude-code-workflows --skill recipe-implement -a cursor -y
Gemini CLI
$ npx skills add shinpr/claude-code-workflows --skill recipe-implement -a gemini-cli -y
GitHub Copilot
$ npx skills add shinpr/claude-code-workflows --skill recipe-implement -a github-copilot -y
OpenCode
$ npx skills add shinpr/claude-code-workflows --skill recipe-implement -a opencode -y
Windsurf
$ npx skills add shinpr/claude-code-workflows --skill recipe-implement -a windsurf -y
name: recipe-implement description: Orchestrate the complete implementation lifecycle from requirements to deployment disable-model-invocation: true
**Explicit User Instruction**: The user explicitly instructs and authorizes every subagent call named in this recipe. Execute each applicable call when its prerequisites are met.
Execute Skill: llm-friendly-context before writing Agent prompts, handoffs, or generated artifacts. Execute Skill: subagents-orchestration-guide before making workflow decisions, invoking agents, or resolving findings.
**Context**: Full-cycle implementation management (Requirements Analysis → Design → Planning → Implementation → Quality Assurance)
**Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
**Local authority gate**: Make this recipe's workflow decisions and validate each returned result directly; delegate semantic deliverable production to the named specialist.
**Review Resolution Gate [MANDATORY]**: Resolve every actionable deliverable-review finding through subagents-orchestration-guide `Review Resolution` before correction or progression. Before the first finding disposition, read `references/review-resolution.md` from the loaded subagents-orchestration-guide skill.
**Execution Protocol**: 1. **Invoke named specialists for deliverable production** — pass deliverable paths between them and validate their results (see subagents-orchestration-guide "Orchestrator Execution Boundary") 2. **Follow subagents-orchestration-guide skill flows exactly**:
3. **Enter autonomous mode** after user confirmation at the Requirements stop for Small, or Medium/Large batch approval
At each Agent invocation below, build the prompt as a mechanical extraction: copy the named source values into the exact fields, apply only the declared serialization, then invoke immediately.
Instruction Content: $ARGUMENTS
Assess the current situation:
| Situation Pattern | Decision Criteria | Next Action | |------------------|------------------|-------------| | New Requirements | No existing work, new feature/fix request | Start with requirement-analyzer | | Flow Continuation | Existing docs/tasks present, continuation directive | Identify next step in sub-agents.md flow | | Quality Errors | Error detection, test failures, build errors | Execute quality-fixer | | Ambiguous | Intent unclear, multiple interpretations possible | Confirm with user |
When continuing existing flow, verify:
**MANDATORY subagents-orchestration-guide skill reference**:
Execute Skill: requirement-convergence before running the hearing protocol.
Build and judge the convergence record by the rules in `references/criteria.md` of the requirement-convergence skill, from the user's retained wording, using requirement-analyzer `scopeEvidence` and `costEvidence` as supporting facts, then run the requirement-convergence hearing protocol. After the user answers the requirements stop, apply the subagents-orchestration-guide Small evidence gate before assigning the final Structural Scale; when the gate is unresolved, invoke codebase-analyzer before routing.
When user responds to questions:
After Structural Scale is determined, follow only that scale's applicable path. Treat each applicable design, review, approval, planning, implementation, verification, cleanup, and reporting phase as a gate. Advance only when the current phase's stated evidence or approval exists; skip only branches whose stated condition is false.
**Pre-execution Checklist (MANDATORY)**:
**Required Flow Compliance**:
Claude Code can explore a codebase deeply. On non-trivial work, the harder problem is convergence.
Applies technical decision criteria, anti-pattern detection, debugging, and quality gates for backend and frontend code. Use when…
Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features, refactoring…
Determines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored. Use when deciding…
Records where resources outside the repository live (design source, design system, API schema, IaC source, secret store) and how…
Implementation strategy selection framework. Use when planning implementation strategy, selecting development approach, or…
Defines integration/E2E skeleton annotations, lane and file contracts, and route-parity review criteria. Use when generating or…
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.