recipe-fullstack-implement
The recipe-fullstack-implement skill orchestrates complete full-stack feature development by delegating work across specialized sub-agents through requirements analysis, design, planning, implementation, and quality assurance phases. Use this when building features that require coordinated changes to both backend and frontend layers, relying on the monorepo-flow reference document to guide multi-layer design synchronization and vertical slicing.
git clone --depth 1 https://github.com/shinpr/claude-code-workflows /tmp/recipe-fullstack-implement && cp -r /tmp/recipe-fullstack-implement/dev-workflows-fullstack/skills/recipe-fullstack-implement ~/.claude/skills/recipe-fullstack-implementSKILL.md
**Context**: Full-cycle fullstack implementation management (Requirements Analysis → Design (backend + frontend) → Planning → Implementation → Quality Assurance) ## Orchestrator Definition **Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill) ## Required Reference **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. ## Execution Protocol 1. **Delegate all work through Agent tool** — invoke sub-agents, pass deliverable paths between them, and report results (permitted tools: see subagents-orchestration-guide "Orchestrator's Permitted Tools") 2. **Follow monorepo-flow.md** for the design phase (multiple Design Docs, design-sync, vertical slicing) 3. **Follow subagents-orchestration-guide skill** for all other orchestration rules (stop points, structured responses, escalation) 4. **Enter autonomous mode** only after "batch approval for entire implementation phase" **CRITICAL**: Execute all steps, sub-agents, and stopping points defined in both the monorepo-flow.md reference and subagents-orchestration-guide skill. ## Execution Decision Flow ### 1. Current Situation Assessment 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 monorepo-flow.md | | Quality Errors | Error detection, test failures, build errors | Execute quality-fixer (layer-appropriate) | | Ambiguous | Intent unclear, multiple interpretations possible | Confirm with user | ### 2. Progress Verification for Continuation When continuing existing flow, verify: - Latest artifacts (PRD/ADR/Design Docs/Work Plan/Tasks) - Current phase position (Requirements/Design/Planning/Implementation/QA) - Identify next step in monorepo-flow.md ### 3. Design through Planning Phase **Follow monorepo-flow.md** for the complete design-through-planning flow (Steps 1-16 for Large scale, Steps 1-14 for Medium scale). The flow table in that reference defines every step, agent invocation, parallelization rule, and stop point. Key points to enforce as the orchestrator runs the flow: - Create separate Design Docs per layer (see monorepo-flow.md "Layer Context in Design Doc Creation") - Frontend Design Doc references the approved UI Spec (pass UI Spec path to technical-designer-frontend) and reuses the ui-analyzer output produced earlier in the flow - Execute document-reviewer once per Design Doc (separate invocations) - Run design-sync for cross-layer consistency verification - Pass all Design Docs to work-planner (subagent_type: "dev-workflows-fullstack:work-planner") with vertical slicing instruction ### 4. Register All Flow Steps Using TaskCreate (MANDATORY) **After scale determination, register all steps of the monorepo-flow.md using TaskCreate**: - First task: "Map preloaded skills to applicable concrete rules" - Register each step as individual task - Set currently executing step to `in_progress` using TaskUpdate - **Complete task registration before invoking subagents** ## After requirement-analyzer [Stop] When user responds to questions: - If response matches any `scopeDependencies.question` → Check `impact` for scale change - If scale changes → Re-execute requirement-analyzer with updated context - If `confidence: "confirmed"` or no scale change → Proceed to next step ## Subagents Orchestration Guide Compliance Execution **Pre-execution Checklist (MANDATORY)**: - [ ] Read monorepo-flow.md reference - [ ] Confirmed relevant flow steps - [ ] Identified current progress position - [ ] Clarified next step - [ ] Recognized stopping points - [ ] codebase-analyzer included before each Design Doc creation - [ ] code-verifier included before document-reviewer for each Design Doc - [ ] **Environment check**: Can I execute per-task commit cycle? - If commit capability unavailable → Escalate before autonomous mode - Other environments (tests, quality tools) → Subagents will escalate **Required Flow Compliance**: - Run quality-fixer (layer-appropriate) before every commit - Obtain user approval before Edit/Write/MultiEdit outside autonomous mode ## Scope Boundary for Subagents Append the following block to every subagent prompt invoked from this recipe: ``` Scope boundary for subagents: Operate within the task scope and referenced files in the prompt. Use loaded skills to execute that scope. Escalate when the required fix or investigation falls outside that scope. ``` ## Mandatory Orchestrator Responsibilities ### Task Execution Quality Cycle (Filename-Pattern-Based) **Agent routing by task filename** (see monorepo-flow.md reference): ``` *-backend-task-* → dev-workflows-fullstack:task-executor + dev-workflows-fullstack:quality-fixer *-frontend-task-* → dev-workflows-fullstack:task-executor-frontend + dev-workflows-fullstack:quality-fixer-frontend ``` **Rules**: 1. Execute ONE task completely before starting next (each task goes through the full 4-step cycle via Agent tool, using the correct executor per filename pattern) 2. Check executor status before quality-fixer (escalation check) 3. Quality-fixer MUST run after each executor before proceeding to commit. **Always pass** the current task file path as `task_file` 4. Check quality-fixer response: - `stub_detected` → Return to executor with `incompleteImplementations[]` details - `blocked` → Escalate to user - `approved` → Proceed to commit ### Post-Implementation Verification (After All Tasks Complete) After all task cycles finish, run verification agents **in parallel** before the completion report: 1. **Invoke both in parallel** using Agent tool: - code-verifier (subagent_ty
Generates integration/E2E test skeletons from Design Doc ACs using ROI-based selection and journey-based E2E reservation. Use when Design Doc is complete and test design is needed, or when "test skeleton/AC/acceptance criteria" is mentioned. Behavior-first approach for minimal tests with maximum coverage.
Validates Design Doc compliance and implementation completeness from third-party perspective. Use PROACTIVELY after implementation completes or when "review/implementation check/compliance" is mentioned. Provides acceptance criteria validation and quality reports.
Validates consistency between PRD/Design Doc and code implementation. Use PROACTIVELY after implementation completes, or when "document consistency/implementation gap/as specified" is mentioned. Uses multi-source evidence matching to identify discrepancies.
Analyzes existing codebase objectively for facts about implementation, user behavior patterns, and technical architecture. Use when existing code needs to be understood without hypothesis bias. Invoked before Design Doc creation to produce focused guidance for technical designers.
Detects conflicts across multiple Design Docs and provides structured reports. Use when multiple Design Docs exist, or when "consistency/conflict/sync/between documents" is mentioned. Focuses on detection and reporting only, no modifications.
Reviews document consistency and completeness, providing approval decisions. Use PROACTIVELY after PRD/UI Spec/Design Doc/work plan creation, or when "document review/approval/check" is mentioned. Detects contradictions and rule violations with improvement suggestions.
Verifies consistency between test skeleton comments and implementation code. Use PROACTIVELY after test implementation completes, or when "test review/skeleton verification" is mentioned. Returns quality reports with failing items and fix instructions.
Comprehensively collects problem-related information and creates evidence matrix. Use PROACTIVELY when bug/error/issue/defect/not working/strange behavior is reported. Reports only observations without proposing solutions.