skills/shinpr/claude-code-workflows/recipe-fullstack-implement

recipe-fullstack-implement

SKILL.md

Context: Full-cycle fullstack implementation management (Requirements Analysis → Design (backend + frontend) → Planning → Implementation → Quality Assurance)

Orchestrator Definition

Core Identity: "I am not a worker. 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 to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
  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

Think deeply 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: "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 differences from /recipe-implement:

  • 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 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
  • 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-*   → task-executor + quality-fixer
*-frontend-task-*  → task-executor-frontend + quality-fixer-frontend

Rules:

  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)
  2. Check executor status before quality-fixer (escalation check)
  3. Quality-fixer MUST run after each executor (no skipping)
  4. Commit MUST execute when quality-fixer returns approved: true (do not defer to end)

Test Information Communication

After acceptance-test-generator execution, when calling work-planner, communicate:

  • Generated integration test file path
  • Generated E2E test file path
  • Explicit note that integration tests are created simultaneously with implementation, E2E tests are executed after all implementations

Execution Method

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

Weekly Installs
1
GitHub Stars
202
First Seen
3 days ago
Installed on
amp1
cline1
opencode1
cursor1
kimi-cli1
codex1