shep: Skill for Claude Code

Fast-Track Feature Specification

Collapse the full new-feature → research → plan pipeline into a single autonomous pass. Produces all the same YAML artifacts as the full pipeline but with minimal user interaction (0-2 clarifying questions max).

Full workflow guide: docs/development/spec-driven-workflow.md

When to Use

• Feature scope is well-understood from the one-liner description
• You want to skip the multi-step interactive flow
• You want to get to implementation quickly

When NOT to Use

• Highly ambiguous features requiring extensive discovery
• Features with many open questions or unknowns
• When you specifically need deep library evaluation with benchmarks

Input

The user provides a feature description inline:

/shep-kit:new-feature-fast add unit tests to backend services

If no description is provided, ask for a one-liner description. That is the only mandatory question.

Workflow

Phase 1: Scaffold

1.1 Derive Feature Name

Extract a kebab-case feature name from the user's description. Do NOT ask — infer it.

Examples:

• "add unit tests to backend" → backend-unit-tests
• "implement dark mode toggle" → dark-mode-toggle
• "fix memory leak in agent runner" → agent-runner-memory-fix

1.2 Create Branch & Directory

# Determine next spec number
NEXT_NUM=$(ls -d specs/[0-9][0-9][0-9]-* 2>/dev/null | sort | tail -1 | grep -oP '^\d{3}' | xargs -I{} printf "%03d" $(({} + 1)))
# If no specs exist, use 001
[ -z "$NEXT_NUM" ] && NEXT_NUM="001"

FEATURE_NAME="<derived-kebab-case>"

# Create branch from main
git checkout main && git pull
git checkout -b "feat/${NEXT_NUM}-${FEATURE_NAME}"

# Run scaffolding (creates all template files)
.claude/skills/shep-kit-new-feature/scripts/init-feature.sh "$NEXT_NUM" "$FEATURE_NAME"

This reuses the existing init script — same templates, same directory structure.

Phase 2: Deep Analysis (Silent)

Before writing any YAML, perform thorough codebase analysis. This is the foundation for ALL subsequent YAML files. Do NOT show analysis to user — go straight to writing.