Workflow

Workflow

High-velocity solo development. Idea to production same-day.

Agent Capabilities

| Capability | Used For | Required | Fallback | |------------|----------|----------|----------| | File read/write | Specs, config, history | Yes | — | | Code search (grep/glob) | Discovery, context | Yes | — | | Shell/command execution | Quality gates (lint, build, test) | Yes | List commands for user to run | | Codebase intelligence (npx codebase-intelligence) | Structural analysis for TS/TSX projects (graph, metrics, blast radius) | No | grep/glob/read (manual exploration) | | Task/todo tracking | Phase management | Recommended | Track in spec Progress section | | User interaction | Stuck escalation, risk flags | Recommended | Log decisions in spec Notes | | Web/doc search | Pattern lookup | No | Use embedded patterns |

Fallback rule: If your agent lacks a capability, use the fallback. Never skip the workflow step — adapt the method.

Commands

| Command | Action | Reference | |---------|--------|-----------| | plan {idea} | Create spec | [plan.md](references/actions/plan.md) | | spike {question} | Time-boxed exploration | [spike.md](references/actions/spike.md) | | ship / ship {idea} | Implement + validate | [ship.md](references/actions/ship.md) | | fix / fix {bug} | Scientific debug + regression fix | [fix.md](references/actions/fix.md) | | review | Portable multi-perspective review spec with line-by-line + rule-by-rule coverage | [review.md](references/actions/review.md) | | spec-review | Adversarial spec analysis | [spec-review.md](references/actions/spec-review.md) | | focus | Priority analysis + task proposals | [focus.md](references/actions/focus.md) | | done | Validate + retro + archive | [done.md](references/actions/done.md) | | drop | Abandon, preserve learnings | [drop.md](references/actions/drop.md) | | workflow | Show state + suggest next | [Status](#status-action) (below) |

No flags needed. The agent auto-detects intent from context:

• "review the spec" → manual review pause
• "skip tests" → skip test gate (documented)
• "fix this bug" → dedicated bug fix with regression test
• "emergency fix" → bypass spec ceremony
• "production ready" → production validation

Flow

Features: focus → plan {idea} → ship → [implement/review/fix loop] → done
Bug fixes: fix {bug} → [investigate/TDD/validate] → done

Quick mode (<2h): ship {idea} → done Don't know what to work on: focus

Philosophy

• Spec-first: All work needs a spec (creates one if missing)
• Ship loop: Build → review → fix until clean
• Quality gates: lint → typecheck → build → test → E2E → coverage (auto-detected per project)
• E2E-first testing: Default to E2E tests. Unit tests only for pure functions
• TDD enforced: RED → GREEN → REFACTOR per AC. Tests written before implementation (BLOCKING)
• Mock boundary: Real systems preferred. Mock only third-party APIs without sandbox (last resort)
• AC-driven coverage: Every Must Have + Error AC maps to an E2E test in the scenario registry
• Anti-regression: Bug fixes require E2E regression test + anti-cascade diff (BLOCKING)
• Failure mode testing: Every HIGH/MED failure hypothesis gets a defensive E2E test
• Human controls deployment: Agent codes, you push/deploy
• Done same-day: Scope to what ships today
• Own planning: Never use the host agent's built-in plan mode (EnterPlanMode, etc.). This skill writes real spec files to specs/active/.

Spec Tiers

| Tier | Size | Spec | Task Tracking | |------|------|------|---------------| | trivial | <5 LOC | None — just do it | No | | micro | <30 LOC | Inline comment in code | No | | mini | <100 LOC | Spec file, minimal | Yes (if available) | | standard | 100+ LOC | Full spec with checklist | Yes (if available) |

Action Router

User input
  │
  ├─ "plan", "spec", "design"           → Load references/actions/plan.md
  ├─ "spike", "explore", "investigate"   → Load references/actions/spike.md
  ├─ "ship", "implement", "build"         → Load references/actions/ship.md
  ├─ "fix", "debug", "repair"            → Load references/actions/fix.md
  ├─ "review", "check code"              → Load references/actions/review.md
  ├─ "review spec", "analyze spec",
  │  "challenge spec"                    → Load references/actions/spec-review.md
  ├─ "focus", "what should i do",
  │  "prioritize", "overwhelmed"         → Load references/actions/focus.md
  ├─ "done", "finish", "complete"        → Load references/actions/done.md
  ├─ "drop", "abandon"                   → Load references/actions/drop.md
  └─ "workflow", "what's next", "what now",
     "what's up", "whats up", "status"  → Status Action (below)

Loading rule: Read the action file BEFORE executing. The action file contains all logic, task templates, and references needed.

Status Action

No separate action file — logic is inline here. Detect current state, suggest next action:

1. Check specs/active/ for active spec
2. Check git status for uncommitted work
3. Check task list for in-progress items

State → Suggestion:
  No spec, no changes    → "Ready. Run: plan {idea}"
  Active spec, no code   → "Spec ready. Run: ship"
  Active spec, code WIP  → "In progress. Run: ship (resumes)"
  Active spec, code done → "Ready to close. Run: done"
  No spec, dirty tree    → "Uncommitted work. Run: ship (creates spec) or done"

Output: Follow [status-output.md](references/templates/status-output.md).

Project Structure

specs/
  active/       ← Current work (0-1 specs)
  backlog/      ← Queued work from focus
  shipped/      ← Completed features
  dropped/      ← Abandoned with learnings
  history.log   ← One-line per feature shipped/dropped

Configuration

All behavior is configurable by editing the skill files directly.

| What to change | Edit | |----------------|------| | Action logic, gates, limits | references/actions/{action}.md | | Output format | references/templates/{action}-output.md | | Spec structure | references/spec-template.md | | Quality gate commands/levels | references/quality-gates.md | | Session resume, stuck detection | references/session-management.md |

References

Actions:

• [Plan](references/actions/plan.md) | [Ship](references/actions/ship.md) | [Fix](references/actions/fix.md) | [Review](references/actions/review.md) | [Spec Review](references/actions/spec-review.md) | [Focus](references/actions/focus.md) | [Done](references/actions/done.md) | [Drop](references/actions/drop.md) | [Spike](references/actions/spike.md)

Output templates:

• [Plan + Spec Review](references/templates/plan-output.md) | [Ship](references/templates/ship-output.md) | [Fix](references/templates/fix-output.md) | [Review](references/templates/review-output.md) | [Focus](references/templates/focus-output.md) | [Done](references/templates/done-output.md) | [Drop](references/templates/drop-output.md) | [Spike](references/templates/spike-output.md) | [Status](references/templates/status-output.md)

Review standards:

• [Core portable review spec](references/reviews/core-portable-review-spec.md) | [Executor patterns](references/reviews/executor-patterns.md) | [Production Standards](references/reviews/production-standards.md)

The portable review spec is normative. Executor patterns are optional implementation guidance.

Specs & gates:

• [Spec template](references/spec-template.md) | [Quality gates](references/quality-gates.md) | [Session management](references/session-management.md) | [Memory update](references/memory-update.md) | [Testing automation](references/testing-automation.md) | [E2E scenarios](references/e2e-scenarios.md) | [Codebase intelligence](references/codebase-intelligence.md)

Patterns:

• [Implementation](references/patterns/implementation.md) | [Planning](references/patterns/planning.md) | [Debugging](references/patterns/debugging.md) | [Decisions](references/patterns/decisions.md) | [Decomposition](references/patterns/decomposition.md) | [Regression testing](references/patterns/regression-testing.md)

Source & license

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

• Author: bntvllnt
• Source: bntvllnt/agent-skills
• License: MIT
• Homepage: https://skills.sh/bntvllnt/agent-skills

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