add-new-feature

name	add-new-feature
argument-hint	<feature description or existing doc path>
user-invocable	true
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.
compatibility	Python 3.11+
metadata	{"version":"1.0.0","last_updated":"2026-01-27"}

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