| name | start-new-feature |
| description | Starts a new feature in a new branch. Use when the user asks to create a new feature, build something new, or says "new feature", "start feature", or "let's build". Creates a feature branch, enters plan mode, interviews the user, validates with experts, and saves the spec. |
Start New Feature
Follow every step below in order. Do not skip any step.
Step 1: Create the feature branch
- Derive
<feature-name> from the user's request as a concise, hyphenated slug.
- Create and checkout the branch using the naming convention
feature/<feature-name>.
git checkout -b feature/<feature-name>
Step 2: Enter plan mode
- Use the
EnterPlanMode tool to switch into plan mode.
- Begin drafting the implementation plan inside the plan file.
Plan structure
Organize the plan in phases. Each phase must include:
- Goal — what the phase achieves.
- Deliverables — concrete outputs (files, migrations, tests, etc.).
- Steps — ordered implementation steps within the phase.
Step 3: Interview the user
- Invoke the
interview skill (/interview) to conduct an in-depth technical interview.
- Use the interview to clarify requirements, edge cases, UI/UX decisions, and technical tradeoffs.
- Incorporate all answers and decisions back into the plan.
Step 4: Validate with expert agents
Once a first version of the plan exists, validate it by launching all four agents in parallel using the Task tool:
- Laravel Architect () — review architecture, patterns, and Laravel conventions.