Skip to content

The method on one page ​

How work is cut, who writes what, and who accepts it. The full rules are in the backlog; the reasons in ADR-0017, ADR-0020, ADR-0023 and ADR-0028.

mermaid
flowchart LR
  subgraph feature [One feature]
    direction LR
    R[Refinement<br/>Product Owner and agent] --> SP[SP<br/>research spike]
    SP --> ST[US · EN<br/>stories, CHK midway]
    ST --> AUD[AUD<br/>independent audit]
    AUD --> VAL[VAL<br/>guided test, demo]
    VAL --> REL[Release<br/>develop to main]
  end
  subgraph epic [Once every feature of the epic is released]
    direction LR
    REV[REV<br/>epic review, user test] --> RET[RET<br/>retrospective, metrics]
  end
  REL -.-> REV

Four levels ​

LevelIsExample from E01Written byAccepted by
Epica business need, several featuresE01 — draw symbol shapes from numbersProduct Owner (agent drafts)Product Owner, at REV
Featurea capability the user can see and testF04 — turn a shape by any angleProduct Owner with the agentProduct Owner, at VAL
Storyone behavior or one piece of work, finished aloneUS-018 — turn and move a shape in the playgroundagent, from the refinementthe checks, then the feature
Taskone commit, an hour to a dayUS-018.T2 — the angle field and the two boxesagentthe checks

Story types ​

The type says who can see the result, not who wrote it or whether it is code.

TypeNameThe resultWho checks itExample
USuser storya behavior a user sees in the playground or the tools; comes with a test cardthe Product Owner, on the card, then at VALUS-014 — convert a polygon and move its points
ENenablerwork no user sees: a geometric function and its derivation, a model change, toolingthe tests, the auditorEN-017 — the stretched polygon's geometry
SPspikeanswers: sources read, derivations, research requests, before any codethe stories it unblocksSP-009 — research for F06
CHKcheckpointmidway through a feature: docs and methods brought up to date, consistency checkedthe agentCHK-008
AUDauditthe feature re-checked by an independent reviewer: formulas, values, sources, duplicatesthe auditor agent, then the Product OwnerAUD-009
VALvalidationthe demo page and the guided test; the Product Owner's validation recordedthe Product OwnerVAL-009
REVepic reviewthe epic report and a user test crossing its featuresthe Product OwnerREV-001
RETretrospectivewhat helped and hurt, metrics, evolvability, playbook and configuration updatedthe Product Owner and the agentRET-001

TIP

A story that changes code can be either: a function the user never sees directly is an EN; the playground field that uses it is a US. The Product Owner writes features and their criteria; the agent cuts them into stories.

Who does what ​

MomentProduct OwnerAgent
refinementanswers the questionnaire, decides the business rulesprepares the questions (with the functional-analyst agent), writes the feature
spike and storiessets stories ready, or starts a runresearches, implements, tests, has each story reviewed
validationruns the guided test, says what they seerecords the result and the remarks, opens the feature pull request
releasemerges the feature, then the release pull requestprepares both, brings develop up to date
review, retrospectiveanswers, decides what changesreports with figures, updates the playbook and the configuration

Cadences beyond the epic ​

WhenWhat
every retrospectivemetrics read (npm run metrics), overrides and "considered for later" tools re-checked, improvement and feedback logs emptied
around the 4th or 5th epic, and at the end of the projectreview of every rule: configuration, lint, hooks, skills, process — each one questioned against how the project went; harden by default, relax only with a reason (Product Owner, 2026-10-13)