AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Spec Workflow

skill-tzachbon-smart-ralph-spec-workflow · by tzachbon

This skill should be used when the user asks to "build a feature", "create a spec", "start spec-driven development", "run research phase", "generate requirements", "create design", "plan tasks", "implement spec", "check spec status", "triage a feature", "create an epic", "decompose a large feature", or needs guidance on spec-driven development workflow, phase ordering, or epic orchestration.

↗ Repository
— No reviews yet
0 installs
18 views
0.0% view→install

Install

$ agentstack add skill-tzachbon-smart-ralph-spec-workflow

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Spec Workflow? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Spec Workflow

Spec-driven development transforms feature requests into structured specs through sequential phases, then executes them task-by-task.

Decision Tree: Where to Start

| Situation | Command | |-----------|---------| | New feature, want guidance | /ralph-specum:start | | New feature, skip interviews | /ralph-specum:start --quick | | Large feature needing decomposition | /ralph-specum:triage | | Resume existing spec | /ralph-specum:start (auto-detects) | | Jump to specific phase | /ralph-specum: |

Single Spec Flow

start/new -> research -> requirements -> design -> tasks -> implement

Each phase produces a markdown artifact in ./specs//. Normal mode pauses for approval between phases. Quick mode runs all phases then auto-starts execution.

Phase Commands

| Command | Agent | Output | Purpose | |---------|-------|--------|---------| | /ralph-specum:research | research-analyst | research.md | Explore feasibility, patterns, context | | /ralph-specum:requirements | product-manager | requirements.md | User stories, acceptance criteria | | /ralph-specum:design | architect-reviewer | design.md | Architecture, components, interfaces | | /ralph-specum:tasks | task-planner | tasks.md | POC-first task breakdown | | /ralph-specum:implement | spec-executor | commits | Autonomous task-by-task execution |

Epic Flow (Multi-Spec)

For features too large for a single spec, use epic triage to decompose into dependency-aware specs.

triage -> [spec-1, spec-2, spec-3...] -> implement each in order

Entry points:

  • /ralph-specum:triage -- create or resume an epic
  • /ralph-specum:start -- detects active epics, suggests next unblocked spec

File structure:

specs/
  _epics//
    epic.md            # Triage output (vision, specs, dependency graph)
    research.md        # Exploration + validation research
    .epic-state.json   # Progress tracking across specs
    .progress.md       # Learnings and decisions

Management Commands

| Command | Purpose | |---------|---------| | /ralph-specum:status | Show all specs and progress | | /ralph-specum:switch | Change active spec | | /ralph-specum:cancel | Cancel active execution | | /ralph-specum:refactor | Update spec files after execution |

Common Workflows

Quick prototype

/ralph-specum:start my-feature "Build X" --quick
# Runs all phases automatically, starts execution

Guided development

/ralph-specum:start my-feature "Build X"
# Interactive interviews at each phase
# Review and approve each artifact
/ralph-specum:implement

Large feature

/ralph-specum:triage "Build entire auth system"
# Decomposes into: auth-core, auth-oauth, auth-rbac
/ralph-specum:start  # Picks next unblocked spec

References

  • references/phase-transitions.md -- Detailed phase flow, state transitions, quick mode behavior, phase skipping

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in AI & ML