Feature Workflow
Follow this workflow for new features or significant changes.
Steps
- •
Research: Understand the codebase, requirements, and constraints
- •Check existing patterns and implementations for similar functionality
- •Review related tests to understand expected behavior
- •Identify dependencies and potential side effects
- •
Plan: Create initial plan with clear, actionable steps
- •Create a markdown feature file in
docs/features/namedYYYY-MM-DD-HHMM_FEATURE_NAME.md - •Use
date +%Y-%m-%d-%H%Mfor timestamp (e.g.,docs/features/2025-11-26-1530_AUTHENTICATION.md)
- •Create a markdown feature file in
- •
Present Summary: Present brief plan to user
- •Use
question_tool: "Go to clarifying" - •If user adds context/feedback: immediately update feature file
- •Continue showing prompt until user confirms
- •Only proceed to Clarify after confirmation
- •Use
- •
Clarify: Ask questions to ensure complete understanding (REQUIRED if ANY ambiguity exists)
- •Ask ALL questions at once in a single
question_toolcall with multiple questions - •Use
question_toolwhen options can be predefined; plain text otherwise - •If answers reveal new ambiguities: ask follow-up questions (again, all at once)
- •When to ask: architecture, file structure, user-facing changes, breaking changes, major patterns
- •When NOT to ask: minor implementation details
- •NEVER skip if uncertain - defaulting to assumption is unacceptable
- •After ALL clarifying questions resolved: update feature file with decisions, then go to Confirm
- •Ask ALL questions at once in a single
- •
Confirm: Present final plan summary
- •Use
question_tool: "Implement this plan" - •If user confirms with no changes: proceed to implementation
- •If user provides changes/details: update feature file and ask "Implement this plan" again
- •Any plan modification requires re-confirmation before implementation
- •Use
- •
Implement: Execute plan incrementally
- •Follow code style and architecture guidelines
- •Write tests alongside implementation
- •Make incremental commits for major milestones if working on large features
- •
Validate: Run all quality gates in order
- •If any gate fails: fix issues and re-run all gates from the beginning
- •
Update Feature File: Sync feature file with any discussions, decisions, or changes not yet documented
- •
Complete: After all quality gates pass
- •Summarize changes made
- •Ask about committing (see Version Control in AGENTS.md)