From eac711ecec183fbb86022b337c55a76090fb2d8b Mon Sep 17 00:00:00 2001
From: Danijel Martinek <danijel@fraqtal.xyz>
Date: Wed, 13 May 2026 07:44:54 +0200
Subject: [PATCH] docs(work): scaffold work-system-v1 epic + story

---
 .../01-state-builder-and-cli/_story.md        | 33 +++++++++++++++++++
 docs/work/work-system-v1/_epic.md             | 28 ++++++++++++++++
 2 files changed, 61 insertions(+)
 create mode 100644 docs/work/work-system-v1/01-state-builder-and-cli/_story.md
 create mode 100644 docs/work/work-system-v1/_epic.md

diff --git a/docs/work/work-system-v1/01-state-builder-and-cli/_story.md b/docs/work/work-system-v1/01-state-builder-and-cli/_story.md
new file mode 100644
index 0000000..587d392
--- /dev/null
+++ b/docs/work/work-system-v1/01-state-builder-and-cli/_story.md
@@ -0,0 +1,33 @@
+---
+id: 01-state-builder-and-cli
+epic: work-system-v1
+title: State builder + pnpm work CLI
+type: technical-story
+status: in-progress
+feature: scripts
+depends-on: []
+blocks: []
+---
+
+## Goal
+`pnpm work status` shows the current epic/story state across `docs/work/`.
+`pnpm work next` prints the next unblocked story. `pnpm work rebuild-state`
+regenerates `_state.json` from markdown.
+
+## In scope
+- `scripts/work/state-builder.mjs` — pure function, fully tested
+- `scripts/work/cli.mjs` — argument dispatch + I/O wrapping the builder
+- `docs/work/_state.json` — initial committed snapshot
+- pnpm work script entry
+
+## Out of scope
+- Per-task state (tasks are markdown checkboxes, not separate entries)
+- Orchestrator dispatch logic
+- Dependency-graph analysis
+
+## Tasks
+- [ ] Epic + story scaffold
+- [ ] state-builder.mjs + tests
+- [ ] cli.mjs + tests
+- [ ] _state.json initial commit + pnpm work script entry
+- [ ] Final verification + closeout
diff --git a/docs/work/work-system-v1/_epic.md b/docs/work/work-system-v1/_epic.md
new file mode 100644
index 0000000..0a16ef4
--- /dev/null
+++ b/docs/work/work-system-v1/_epic.md
@@ -0,0 +1,28 @@
+---
+id: work-system-v1
+prd: null
+title: Work system v1 (MVP) — state tracking + pnpm work CLI
+type: epic
+status: in-progress
+features: [scripts]
+created: 2026-05-13
+---
+
+## Goal
+Filesystem-only state tracking for `docs/work/` + a `pnpm work` CLI with
+status / next / rebuild-state subcommands. Foundation for future
+orchestration; no agent dispatch in v1.
+
+## Why
+Agents and humans both need a fast way to see "what's the next unblocked
+work?" and "where are we?" — without scanning every story file by hand.
+
+## Out of scope (v2+)
+- Sandcastle / agent dispatch
+- PRD and ADR elicitation skills
+- Decomposer / implementer / reviewer prompts
+- DAG analysis (depends-on / blocks)
+- Pre-commit hooks (the state file is rebuilt manually for now)
+
+## Stories
+- [ ] [01 — State builder + CLI](01-state-builder-and-cli/_story.md)