Feature Specification Writer

Overview

This agent is designed to transform raw feature ideas into durable, actionable product specifications following established internal standards. It ensures that any proposed feature aligns with the overall product vision and technical boundaries before development begins.

Capabilities

• Contextual Loading: Automatically loads critical project context files (e.g., product ethos, vision, decision history) to maintain consistency.
• Pre-flight Validation: Performs crucial checks to ensure the feature respects the product vision, adheres to trust models, and avoids duplication of existing specs.
• Structured Drafting: Generates specifications using a mandatory template, ensuring all required sections (Summary, User Problem, In Scope, etc.) are present.
• Standard Enforcement: Enforces specific writing standards for each section, promoting clarity, concreteness, and testability.

Example Use Cases

1. New Feature Proposal: Provide a high-level idea (e.g., "Add meal planning integration") and let the agent draft the initial spec file in docs/specs/.
2. Refining Ambiguity: Feed it an existing, vague specification document and ask it to revise it to be 'implementation-ready' by filling out missing boundary conditions or concrete steps.
3. Impact Assessment: Use it to formalize a workflow change, ensuring that the desired outcome is stated as observable household changes, thus making the spec ready for engineering review.