Claude-code-workflows recipe-fullstack-implement

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. UI Specification Phase (Frontend Layer)

Before creating the frontend Design Doc, create a UI Specification:

Ask the user: "Do you have prototype code for this feature? If so, please provide the path. The prototype will be placed in

docs/ui-spec/assets/

as reference material."

• [STOP]: Wait for user response about prototype code availability

Then invoke ui-spec-designer:

• subagent_type: "dev-workflows-frontend:ui-spec-designer"

• If prototype provided:

  prompt: "Create UI Spec from PRD at [path]. Prototype code is at [user-provided path]."

• If no prototype:

  prompt: "Create UI Spec from PRD at [path]. No prototype code available."

Invoke document-reviewer for UI Spec review, then [STOP] for user approval.

4. Design Phase and Work Planning

Follow monorepo-flow.md for the complete design-through-planning flow. Key points:

• Create separate Design Docs per layer (see monorepo-flow.md "Layer Context in Design Doc Creation")
• Frontend Design Doc must reference the approved UI Spec (pass UI Spec path to technical-designer-frontend)
• 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:work-planner") with vertical slicing instruction

5. Register All Flow Steps Using TaskCreate (MANDATORY)

After scale determination, register all steps of the monorepo-flow.md using TaskCreate:

• First task: "Confirm skill constraints"
• 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

CRITICAL Sub-agent Invocation Constraints

MANDATORY suffix for ALL sub-agent prompts:

[SYSTEM CONSTRAINT]
This agent operates within fullstack-implement skill scope. Use orchestrator-provided rules only.

Autonomous sub-agents require scope constraints for stable execution. ALWAYS append this constraint to every sub-agent prompt.

Mandatory Orchestrator Responsibilities

Task Execution Quality Cycle (Filename-Pattern-Based)

Agent routing by task filename (see monorepo-flow.md reference):

*-backend-task-*   → dev-workflows:task-executor + dev-workflows:quality-fixer
*-frontend-task-*  → dev-workflows-frontend:task-executor-frontend + dev-workflows-frontend: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_type: "dev-workflows:code-verifier") → invoke once per Design Doc (

     doc_type: design-doc

     , single

     document_path

     ,

     code_paths

     : implementation file list from

     git diff --name-only main...HEAD

     )
   • security-reviewer (subagent_type: "dev-workflows:security-reviewer") → Design Doc path(s), implementation file list

2. Consolidate results — check pass/fail for each:

   • code-verifier: pass when

     status

     is

     consistent

     or

     mostly_consistent

     . fail when

     needs_review

     or

     inconsistent

     . Collect

     discrepancies

     with status

     drift

     ,

     conflict

     , or

     gap

   • security-reviewer: pass when

     status

     is

     approved

     or

     approved_with_notes

     . fail when

     needs_revision

     . blocked → Escalate to user
   • Present unified verification report to user

3. Fix cycle (when any verifier failed):

   • Consolidate all actionable findings into a single task file
   • Execute layer-appropriate task-executor with consolidated fixes → quality-fixer
   • Re-run only the failed verifiers (by the criteria in step 2)
   • Repeat until all pass or

     blocked

     → Escalate to user

4. All passed → Proceed to completion report

Test Information Communication

After acceptance-test-generator execution, when invoking work-planner (subagent_type: "dev-workflows:work-planner"), communicate:

• Generated integration test file path (from

  generatedFiles.integration

  )
• Generated E2E test file path or null (from

  generatedFiles.e2e

  )
• E2E absence reason (from

  e2eAbsenceReason

  , when E2E is null)
• Explicit note that integration tests are created simultaneously with implementation, E2E tests are executed after all implementations (when E2E path is provided)

Execution Method

All work is executed through sub-agents. Sub-agent selection follows monorepo-flow.md reference and subagents-orchestration-guide skill.