Feature spec template
One feature, written so it can be built and tested.
- Stage
- Plan
- Sections
- 6
- Updated
How to fill it in
- 1Say what it is in one sentence.
- 2Write how it behaves, step by step.
- 3Add criteria that are only true or false.
- 4Cover the empty, error and offline cases.

What it is
One sentence a user would recognise.
Why now
What breaks or stays broken if this waits.
How it behaves
- The user does…
- The system responds…
- The result is…
Acceptance criteria
Phrase each one so it can only be true or false — no judgement calls.
- Given …, when …, then …
Edge cases
- Empty state
- Error / offline
- Very large input
Not doing
What’s inside 6
- What it is
- Why now
- How it behaves
- Acceptance criteria
- Edge cases
- Not doing
Where to find it
In Kanso, add a page and pick this template, or type / in any doc.
Read the guide: How to write acceptance criteria, with examples
Questions
A short document that describes one feature in enough detail to build and test it: how it behaves, its acceptance criteria and its edge cases.
More templates
All templatesUse the feature spec in Kanso.
Free does not expire. No card required.


