User Stories
Format
User stories live in docs/user-stories/<story-name>.json as arrays of features:
[ { "description": "User creates a loop with custom config", "steps": [ "POST to /loops with config object", "Verify loop is created with merged config", "GET /loops/:id/detail and verify config values" ], "passes": true } ]
Fields
-
description: What the user does/expects
-
steps: Verification steps (imperative)
-
passes: true if verified working with passing tests, false otherwise
Workflow
When prompted to work on a feature:
-
Author/Update: Create or modify user story features before building
-
Build & Test: Implement until tests pass
-
Mark Passing: Set passes: true when verified