name: add-new-feature description:"SAM-style feature initiation workflow: discovery -> codebase analysis -> architecture spec -> task decomposition -> validation -> context manifest. Use when a user asks to add a feature, plan a feature, or convert an idea into executable task files." version: "1.0.0" last_updated: "2026-01-27" python_compatibility: "3.11+" user-invocable: true argument-hint: "<feature description or existing doc path>"

Add New Feature (SAM Workflow)

You MUST convert the user's request into durable SAM artifacts under the repo:

• plan/feature-context-{slug}.md (discovery)
• plan/codebase/{FOCUS}.md (optional, analysis)
• plan/architect-{slug}.md (architecture/design spec)
• plan/tasks-{N}-{slug}.md (executable task plan with Agents, deps, and verification)

<feature_request> $ARGUMENTS </feature_request>

Orchestrator Discipline

You are an orchestrator. You coordinate work across specialized agents. Prefer delegating discovery and analysis.

Phase 1: Discovery (feature-researcher)

Delegate to feature-researcher to produce plan/feature-context-{slug}.md and questions for resolution.

Phase 2: Codebase Analysis (codebase-analyzer)

If helpful, delegate to codebase-analyzer for one or more focus areas:

• patterns
• architecture
• testing
• conventions

Outputs go to plan/codebase/.

Phase 3: Architecture Spec (python-cli-design-spec)

Delegate to python-cli-design-spec to write plan/architect-{slug}.md based on:

• the feature context doc
• codebase analysis docs (if created)
• existing repo constraints (CLAUDE.md, pyproject.toml, etc.)

Phase 4: Task Decomposition (swarm-task-planner)

Delegate to swarm-task-planner to:

• create plan/tasks-{N}-{slug}.md
• ensure every task has:
  • Status, Dependencies, Priority, Complexity, Agent
  • Acceptance Criteria (3+)
  • Verification Steps (3+)

Phase 5: Plan Validation Gate (plan-validator)

Delegate to plan-validator. If it returns BLOCKED, do not proceed.

Phase 6: Context Manifest (context-gathering)

Delegate to context-gathering with the task file path. It must insert a ## Context Manifest into the task file.

Success Outcome

When all phases complete, provide the user:

• the feature slug
• the task file path
• next step: run the implement-feature skill with the slug or task file path