tldr-experts 0.3.1 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tldr-experts",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "tldr-experts: a lightweight, file-based AI development workflow. Installs the `tldrx` (and `tldr-experts`) command. Alpha.",
   "license": "MIT",
   "author": "Alan Martinez",
@@ -48,6 +48,8 @@
   "scripts": {
     "test": "bun test",
     "build": "bun scripts/build.ts",
+    "docs:dev": "cd docs-site && bun install && bun run dev",
+    "docs:build": "cd docs-site && bun install --frozen-lockfile && bun run build",
     "typecheck": "tsc --noEmit",
     "doctor": "bun bin/tldrx.ts doctor",
     "prepublishOnly": "bun run build"

package/plugin/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$doc": "Shape verified from https://code.claude.com/docs/en/plugins.md (Quickstart > Create the plugin manifest). Fields used here: name, description, version, author.name. Only plugin.json goes inside .claude-plugin/; skills/, agents/ and hooks/ live at the plugin root.",
   "name": "tldrx",
   "description": "tldr-experts: a file-based AI development workflow. One loop, five phases, everything on disk. Alpha.",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "author": {
     "name": "Alan Martinez"
   }

package/stages/build/stage.yml

@@ -22,7 +22,8 @@ model: sonnet
 effort: high
 budget_usd: 9
 timeout_s: 1800
-# Branches and commits are not revertible by a flag, so a dry run is refused
+# A stage that cuts branches and fans out per-story sub-agents has no ONE dispatch to
+# describe, so a dry run is refused
 # rather than half-honoured (spec §5, Build executor).
 dry_run_allowed: false
 

package/stages/plan/stage.md

@@ -52,6 +52,17 @@
 - `waves.yml`
 - `budget.yml`
 
+The first three are **schema'd files a machine parses**, not free markdown. Their exact
+front matter, id shapes, enums and size caps are under **Output schemas** below — read
+that section before writing any of them.
+
+## Output schemas
+
+_The framework renders this section from the validators that gate this stage, so it is the
+contract itself rather than a copy of it. If you are reading this sentence instead of a
+schema, the bundle was not assembled by `tldrx next`: read `src/core/schemas/story.ts`,
+`epic.ts` and `waves.ts` before writing anything._
+
 ## Gate
 
 Blocked on: **<human approval | checks green>** — `stage.yml`'s `gate.type`. What is

package/templates/epic.md

@@ -23,9 +23,11 @@ What this epic is for, sourced. Two or three sentences.
 
 ## Stories
 
-| Story | Repo | Depends on | Status |
-|---|---|---|---|
-| S1 | example | — | todo |
+The `stories:` list in the front matter above is the membership, and it is the whole
+of it. Each story has its own file at `03-plan/stories/<id>.md`, and its status, its
+repo and its `depends_on` live in THAT file's front matter, where the Build phase
+writes them. None of it is copied here: a copy with no writer is wrong from the
+moment the first story lands (gh #50).
 
 ## Integration test