Skill
Community

spec-workflow

Install
1
Install the plugin
$
npx claudepluginhub cianos95-dev/claude-command-centre --plugin claude-command-centre

Want just this skill?

Then install: npx claudepluginhub u/[userId]/[slug]

Description

Complete 9-stage spec-driven development funnel from ideation through deployment, with 3 approval gates, universal intake protocol, plan promotion to durable documents, and issue closure rules. Use when understanding the full development workflow, checking what stage a feature is in, determining next steps for an issue, promoting plans to Linear Documents, or onboarding to the spec-driven process. Trigger with phrases like "what stage is this in", "development workflow overview", "what are the approval gates", "how does the funnel work", "intake process", "what happens after spec approval", "promote this plan", "save plan to Linear", "make plan durable".

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets
View in Repository
references/plan-promotion.md
references/stage-details.md
Skill Content

Claude Command Centre Workflow

This is the complete funnel from idea to production. Every feature, fix, and infrastructure change flows through these stages. The funnel enforces three human approval gates and eliminates ambiguity about what is being built, why, and when it is done.

Funnel Overview

The funnel flows: Intake (Stage 0) → Ideation (1) → Analytics (2) → PR/FAQ Draft (3) → Gate 1 → Adversarial Review (4) → Gate 2 → Visual Prototype (5) → Implementation (6) → Gate 3 → Verification (7) → Closure (7.5) → Async Handoff (8).

See references/stage-details.md for the full mermaid diagrams and stage-by-stage breakdown with activities, outputs, and skip conditions.

Unified Entry Point: /ccc:go

/ccc:go [argument] [--quick] [--mode MODE] [--status] [--next]
ArgumentBehavior
(none)Check for active work, resume or ask what to build
--statusShow "You Are Here" text-based funnel view
CIA-XXXRoute by issue status to correct stage
"free text"New idea → intake → spec draft
--quickCollapse funnel for small tasks
--nextPick up next unblocked task

See the /ccc:go command definition and the execution-engine skill for full details.

Fast Paths

Not every task needs the full 9-stage funnel. The execution mode determines which stages to skip:

Execution ModeStages UsedStages SkippedTypical Use
quick0, 3 (quick template), 6, 7, 7.51, 2, 4, 5, 8Bug fixes, small features, config changes
tdd0, 3, 6, 7, 7.52, 4, 5, 8Well-defined features with clear AC
pair0, 1, 3, 4, 6, 7, 7.52, 5, 8Uncertain scope requiring human-in-the-loop
checkpointAll stagesNoneHigh-risk changes, infrastructure, breaking changes
swarm0, 3, 4, 6, 7, 7.52, 5, 8Large scope decomposed into parallel subtasks

Rule of thumb: If the task can be described in one sentence and has an obvious implementation, use quick and skip to Stage 6 after intake.

Stage Reference

#StageKey ToolsGate
0Universal Intakeproject-trackerNone (normalization)
1Ideationproject-tracker MCPNone
2Analytics Reviewanalytics-platformNone (informational)
3PR/FAQ DraftPR/FAQ templates, project-tracker MCPHuman: approve spec
4Adversarial ReviewReview options A-H, RDR tableHuman: accept findings
5Visual PrototypeDesign tool routingNone (skip for non-UI)
6ImplementationSubagents, model mixingHuman: review PR
7VerificationPreview deploy, analytics checkMerge to production
7.5Issue ClosureMetadata-driven closure rulesAuto/propose per rules
8Async HandoffRemote dispatchN/A

Approval Gates

The three gates are the only points where human judgment is required. Everything else can be automated or agent-driven.

  1. Gate 1: Approve Spec (Stage 3 exit) — Is this spec clear enough and valuable enough? On approval: spec:draftspec:ready. On rejection: return to Stage 3.

  2. Gate 2: Accept Findings (Stage 4 exit) — Are review findings acceptable? Human fills Decision/Response columns in the RDR table. Gate passes when all Critical and Important findings have a Decision value. On REVISE: return to Stage 3. On RETHINK: return to Stage 1.

  3. Gate 3: Review PR (Stage 6 exit) — Does implementation match the spec? On approval: merge and proceed. On changes requested: return to Stage 6.

Everything before Gate 1 is exploration. Everything between Gate 1 and Gate 3 is execution. Everything after Gate 3 is verification.

Stage Transitions and Labels

LabelMeaningSet When
spec:draftPR/FAQ written, awaiting approvalStage 3 complete
spec:readySpec approved, ready for reviewGate 1 passed
spec:reviewUnder adversarial reviewStage 4 in progress
spec:implementingCode is being writtenStage 6 in progress
spec:completeShipped and verifiedStage 7.5 closure

Master Plan Pattern

When batched or sequential work spans 2+ sessions, create a master session plan issue with sub-issues for each step.

Two-session gate:

  • Session 1 = decisions, research, and planning. Produce recommendations, not changes.
  • Human review gate between sessions.
  • Session 2 = execution. Apply the decisions made and approved in Session 1.

Why separate sessions: Never mix research/decisions and execution in the same session. Combining both leads to >70% context consumption, rushed decisions, and execution that outpaces approval.

Plan Promotion

Elevate ephemeral session plans to durable Linear Documents for cross-surface access. This bridges the Code tab (where plans are written) and Cowork (where plans are refined collaboratively). Linear is the shared state layer.

Two-Tier Plan Architecture

TierLocationLifecycleAccess
Tier 1: Ephemeral~/.claude/plans/<session-slug>.mdSession-scoped, disposable after executionCode tab only
Tier 2: DurableLinear Document (primary) or docs/plans/ (architectural)Persists across sessions, projects, surfacesAny surface with Linear MCP

When to promote (Tier 1 → Tier 2):

  • Plan spans multiple sessions or will be resumed later
  • Plan captures architectural decisions needing team visibility
  • Plan needs review or refinement in Cowork
  • Plan is for a 3+ point issue (non-trivial scope)

When NOT to promote: Quick-mode plans, exploration plans, plans immediately superseded by execution.

Protocol: Resolve plan source → resolve target issue → check for existing plan document → create/update Linear Document → link to issue via comment → add local backlink.

See references/plan-promotion.md for the full 8-step promotion protocol, document format, pre-update validation, platform-specific behavior, and listing promoted plans.

Scope Discipline

  • Pilot batch before bulk: When a task affects 10+ items, do a pilot batch of 3-5 first.
  • Approach confirmation: Before executing a plan touching >5 files or >10 issues, confirm the approach.
  • Scope creep guard: If during execution you discover new work, create a sub-issue immediately. NEVER add scope to the parent issue.
  • Anti-pattern — "while I'm here": Resist fixing adjacent issues during implementation. Log them as new issues.

Human Review Gate Enforcement

  • No gate can be skipped, even for quick mode (which still requires Gate 3: PR review)
  • Gates are synchronization points: agent stops, human catches up, then work resumes
  • Passing a gate is an explicit human action, never implicit
  • Architectural decisions require split sessions: Any change to architecture, data models, or cross-cutting concerns → Session 1 produces proposal, human reviews, Session 2 executes only what was approved.
  • Evidence format: Summary tables, linked to tracker issues, with explicit recommendation. Human should decide in under 5 minutes of reading.

Cross-Skill References

  • execution-engine -- Powers Stage 6 (stop hook task loop, .ccc-state.json, .ccc-progress.md, gate pauses, retry budget)
  • prfaq-methodology -- Governs Stage 3 (PR/FAQ drafting process, templates, interactive questioning)
  • adversarial-review -- Governs Stage 4 (reviewer perspectives, architecture options A-H, RDR for Gate 2)
  • execution-modes -- Governs Stage 6 (quick, tdd, pair, checkpoint, swarm routing)
  • issue-lifecycle -- Governs Stage 7.5 (closure rules, evidence requirements, ownership boundaries)
  • context-management -- Applies across all stages (subagent delegation, output brevity, model mixing)
  • document-lifecycle -- Safety rules for plan promotion (no round-tripping, pre-update validation)
  • platform-routing -- Surface detection for Code vs Cowork plan promotion behavior
Stats
Stars0
Forks0
Last CommitFeb 25, 2026

Similar Skills