task-pipeline-skill 1.40.0 → 1.41.0

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## v1.41.0 — one line per run is a slope, not a bound
+
+`retro.md` is read **in full** at stage 0, and its own doctrine called both read sections
+*bounded by construction*. Measured 2026-08-10:
+
+```
+standing instructions   ~1 234 tok   capped at ten
+run stamps              ~2 099 tok   27 rows, capped by nothing
+recent log             ~12 441 tok   queried, not read
+```
+
+The v1.38.0 audit found exactly this shape in the narrative log and moved it out of the
+floor. It left the neighbour in the same file, with the same property, because the
+neighbour's growth is **tidy** — one line per run. A tidy slope is still a slope: at a
+hundred runs the stamp table alone is ~7 800 tokens of a floor the doctrine believes is
+bounded.
+
+**The cap is ten, and the cold trigger is why.** It reads *the last five run stamps*, so
+ten is that with a margin and a rotated row can never be one the trigger needed. Eighteen
+stamps rotated into `docs/superpowers/retro/2026-Q3.md`, whole, append-only. The stamp
+section went **2 099 → 1 088 tok**, the read portion **3 333 → 2 335**, and the stage-0
+floor to roughly **35 300**.
+
+### The reader found six ways past the cap, and one of them was the doctrine's own command
+
+R-005's reader defeated the first cap guard six ways, each planted and watched passing:
+
+- **a second `## Run stamps — …` heading in the same file** held forty more rows and
+  passed. The guard read a *section*; stage 0 reads the **file**;
+- **one leading space** on a row — still a valid table row — hid it from `startswith("|")`;
+- **the stamp command this doctrine ships** (`printf '%s · %s\n' …`) appends prose, not a
+  table row. An agent obeying the shipped instruction literally produced forty stamps the
+  guard could not see, with `unlooked: 0`;
+- **`templates/retro.md`** ships the same table to every host project and was outside the
+  corpus — the fourth hand-written list this repository has caught, against an invariant
+  that says corpora are discovered;
+- **rotation by deletion** passed: a stamp removed from `retro.md` and absent from the
+  archive is history destroyed, and the guard could not tell moving from deleting;
+- and the row check — already narrowed twice — was defeated by **swapping the two items
+  around the `·`**, which is the standing instructions' `max 10` answering for the stamps
+  again, on the other side of the separator.
+
+Both guards are rewritten to count by **predicate over a discovered corpus**: three stamp
+shapes (table row, list item, and the `<date> · <sha>` line the doctrine writes), every
+file carrying a `## Run stamps` section, and the doctrine's cap read from the segment that
+names the stamps rather than from anywhere in the row.
+
+**Four surfaces had never learned the rule** — the live section's own intro, stage 10's
+prune, `templates/retro.md`, and `templates/retro-archive.md`, which had no destination
+section for a rotation the doctrine names. And stage 0 still called *one line per run* a
+bound. All five now say the same thing.
+
+**A hand-written count in this release was wrong.** It said twenty-one stamps rotated;
+computed, it is **eighteen** (28 → 10). In a repository whose loudest canon is *compute,
+never restate*.
+
+### Two predicates that were answered by their neighbours
+
+Both found by their own probes, both the same shape as the defects the last release's
+reader named:
+
+- the first version asked whether the file contained *"one line each"* and *"bounded by
+  construction"*. After the fix both survived **only inside the sentences criticising
+  them**, and the guard fired on its own correction. A predicate that cannot tell a claim
+  from its refutation has a false-positive budget above zero, which `gates.md` sets at
+  zero;
+- scoped to the table row, it was then answered by the **standing instructions' own
+  `max 10`** in the same cell. It now reads only the part of the row after `Run stamps`.
+
+- Guards: 248 → **250**.
+
 ## v1.40.0 — the loop had a cadence and no queue
 
 `run.loop` said how **often** to continue. It never said **what the next item is**, so an

package/SKILL-CARD.md

@@ -12,7 +12,7 @@ harmless.
 |---|---|
 | **Purpose** | Runs a substantial task through ten gated delivery stages — intake grill, docs study, brainstorm, spec, plan, subagent build, tests, lint/deploy, post-deploy, docs+registers, acceptance — refusing to advance until each gate passes |
 | **Owner** | ssheleg ([github.com/ssheleg/task-pipeline](https://github.com/ssheleg/task-pipeline)) |
-| **Version** | 1.40.0 |
+| **Version** | 1.41.0 |
 | **Surface** | Claude Code (filesystem skill + plugin) and the vercel `skills` CLI. **Not** uploaded to the Skills API; custom Skills do not sync across surfaces |
 | **Dependencies** | None required. Optional: `context7` (MCP), `figma` (MCP), super-ux, agent-sync, graphify, obsidian-wiki. Every stage's doctrine ships in-repo; the one conditional requirement is super-ux for the stage-3 UX track on a user-facing task |
 | **Evaluation status** | Suite authored, 5 categories. One recorded run, **self-observed by the author**; **zero blind runs on zero of three models** — the split, and the numbers, live in [`evals/RESULTS.md`](evals/RESULTS.md) and are computed by `evals/run.py` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "task-pipeline-skill",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "Full-cycle delivery pipeline for coding agents: a mandatory built-in intake grill, then 10 gated stages (docs, brainstorm+decompose, spec, plan, build, tests, lint/deploy, post-deploy, docs/wiki, acceptance). Every stage's doctrine ships inside the skill — no companion plugin required. This package is the installer CLI.",
   "bin": {
     "task-pipeline": "bin/task-pipeline.js"

package/plugins/task-pipeline/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "task-pipeline",
   "displayName": "Task Pipeline",
   "description": "Runs a substantial task through a mandatory built-in intake grill, then 10 gated stages (docs, brainstorm+decompose, spec, plan, subagent build, tests, lint/deploy, post-deploy, docs/wiki, acceptance). Every stage's doctrine is built into the skill — no companion plugin required — with typed auto/manual gates, a frozen requirement spine that closes with evidence, a work board and a verification ledger that outlive a run, an exposure line naming what shipped unconfirmed, a progress rail computed from the project's own config, a loop guard whose review ceiling measures rather than stops, and stage-3 tracks for what a product does, how it sounds and how it looks. Two modes need no task: `checkup` (what is unverified) and `setup` (audit existing docs). Retro insights can publish upstream as issues, opt-in and redacted.",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "author": {
     "name": "ssheleg",
     "url": "https://x.com/sshlg93"

package/plugins/task-pipeline/skills/task-pipeline/references/retrospective.md

@@ -18,7 +18,7 @@ justifies reading it protects one section while the file below it doubles.
 
 | Artifact | Parts | How it is read |
 |---|---|---|
-| `docs/superpowers/retro.md` — **one per project** | **Standing instructions** (max **10**) · **Run stamps** (one line each) | stage 0, **in full** — both are bounded by construction |
+| `docs/superpowers/retro.md` — **one per project** | **Standing instructions** (max **10**) · **Run stamps** (max **10**, oldest rotate out) | stage 0, **in full** — both are bounded by a **cap**, which *one line each* never was |
 | the same file's **Recent log** | entries from the last five run stamps — narrative, and capped by nothing | stage 0, **queried** by the task's nouns. It said *in full* until 2026-08-10, when it measured **74%** of the file: an uncapped section inside a binding source is what makes the capped part get skimmed |
 | `docs/superpowers/retro/YYYY-QN.md` — the archive | every entry and every retirement ever written, append-only | **queried** by the task's nouns; never read end to end |
 
@@ -32,6 +32,7 @@ file exists to stop.
 
 - Write the entry only for a divergence — and name the layer that owned it
 - Every lesson carries its commit
+- The stamp table is capped at ten, and *one line per run* was never a cap
 - Rotation — the archive is how pruning stops losing things
 - Three grades of fix — take the highest one that can work
 - Stamp first, then prune, then write
@@ -79,6 +80,26 @@ mechanical: the project's documentation gate runs `git rev-parse --verify --quie
 <sha>^{commit}` over every backticked SHA in the retro and its archive
 ([`gates.md`](gates.md)).
 
+## The stamp table is capped at ten, and *one line per run* was never a cap
+
+Measured 2026-08-10: standing instructions **~1 234 tok** behind a cap of ten, run stamps
+**~2 099 tok over 27 rows** behind nothing. Both are read in full at stage 0 and both
+were described as *bounded by construction*. One line per run is a **slope**: at a
+hundred runs the stamp table alone is ~7 800 tokens of a floor the doctrine believes is
+bounded.
+
+This is the same shape the 2026-08-10 audit found in the narrative log and moved out of
+the floor — and it left the neighbour in the same file, with the same property, because
+the neighbour's growth is *tidy*. A tidy slope is still a slope.
+
+**The cap is ten and the trigger is why.** The cold rule reads *the last five run
+stamps*; ten is that with a margin, so a stamp rotating out can never be one the trigger
+needed. At the eleventh, the oldest row moves — whole, with its verdict and its retro
+column — into `docs/superpowers/retro/YYYY-QN.md` under `## Run stamps`, append-only,
+like every other rotation. **The count is printed at the prune**, beside the standing
+instructions' own count, so a table that stops rotating is visible rather than merely
+large.
+
 ## Rotation — the archive is how pruning stops losing things
 
 At the prune, entries older than the last five run stamps **move** to

package/plugins/task-pipeline/skills/task-pipeline/references/stages.md

@@ -102,7 +102,7 @@ never that the work was skipped quietly.
   `affected` / `god-nodes` answer *reach*, which is what grep cannot), `CLAUDE.md`,
   `CONTEXT.md`/ADRs, `docs/` + `docs/ux/`, past pipeline briefs and carry-over
   ledgers, **the retro's standing instructions and run stamps** (`docs/superpowers/retro.md`,
-  read **in full** — ten rows and one line per run, both bounded, and they bind this
+  read **in full** — ten standing rows and ten stamps, both bounded **by a cap**, and they bind this
   run; stamp each instruction as it fires. Its *Recent log* is **queried** by the
   task's nouns, not read: uncapped narrative inside a binding source is what makes the
   capped part get skimmed, [`retrospective.md`](retrospective.md)), the **knowledge wiki** if one is
@@ -656,7 +656,10 @@ never that the work was skipped quietly.
   with a floor, neither ever a target ([`gates.md`](gates.md) → *Disclosures*); **the
   retrospective is written — stamped first, then pruned, then the entry; the
   list at or under its cap, every deletion logged in the archive with its commit,
-  entries older than five run stamps rotated into `docs/superpowers/retro/`, the run
+  entries older than five run stamps rotated into `docs/superpowers/retro/` **and the
+  stamp table itself held to ten — at the eleventh the oldest stamp rotates whole into
+  the same archive, and both counts print beside the verdict** (the stamp table is read
+  in full at stage 0, so *one line per run* is a slope the prune has to stop), the run
   stamped with its commit, every SHA in either file resolvable, and the
   counts printed beside this verdict**; **where `pipeline.json` → `retro.publish` is
   set, the skill-level insight is published as an issue on the skill's repository —

package/plugins/task-pipeline/skills/task-pipeline/templates/retro-archive.md

@@ -39,3 +39,13 @@ history attached**, which is what this section is for.
 | Date | id | Instruction | Trigger that retired it | Commit |
 |---|---|---|---|---|
 | <YYYY-MM-DD> | R-000 | … | became a check (`npm run lint:paths`) | `<sha>` |
+
+## Run stamps
+
+Rotated out of `retro.md` when its live table passes ten. Append-only, whole rows —
+the cold trigger reads the last five in the live file, so a stamp here is one it no
+longer needs. Moving is not deleting: a stamp that leaves `retro.md` and appears
+nowhere is history destroyed, not archived.
+
+| Date | Topic | Commit | Verdict | Retro |
+|---|---|---|---|---|

package/plugins/task-pipeline/skills/task-pipeline/templates/retro.md

@@ -61,8 +61,9 @@ shape the hygiene gate's check 6 exists to find.
 
 ## Run stamps
 
-One line per run, appended at stage 10. This is what makes "five runs" countable
-— without it the cold-rule is a guess and the prune becomes a mood.
+One line per run, appended at stage 10, **capped at ten** — at the eleventh the
+oldest rotates whole into the archive. One line per run is a slope, not a bound:
+this section is read in full at stage 0.
 
 | Date | Topic | Commit | Verdict | Retro |
 |---|---|---|---|---|