Skip to content

Product specifications

These pages are mirrored from the repository specs/ tree (source of truth for product behavior).

Product feature index. Each spec lives in specs/features/<slug>.md.

Terminological authority: domain-glossary.md (glossaryOwner: domain-glossary).

Feature template

Each specs/features/<slug>.md file follows this skeleton:

markdown
# {Title}

| Field | Value |
|-------|--------|
| Slug | `{slug}` |
| Status | draft |
| Last review | {date} |

## Summary
## User flows
## Data model
## CLI
## Business rules
## User scenarios
## Dependencies
## Out of scope
## Acceptance criteria
## Terminology
## Implementation notes

Conventions per section

SectionConvention
User flowsNumbered journeys Flow-01, Flow-02, … — persona, preconditions, steps command → expected result → errors.
Data modelTables for JSON files / persisted entities. Domain enums only in domain-glossary.md.
CLISignature skli <command> [args] [options] — arguments, options, exit codes.
Business rulesNumbered rules BR-{slug}-NNN.
Statusdraftdefineddefined+ (enriched) → implemented.
Acceptance criteriaExpected behavior; [x] if already in code, [ ] otherwise.
TerminologyPoint to domain-glossary; do not redefine enums.

Released under the MIT License.