| name | capture-friction |
| description | Use when this tick or session hit real, disproportionately costly friction with the harness (a pitfall it could have warned about, a slow gate, missing operational knowledge), touched structural debt it can't fix right now (a duplicate surface, a hand-roll a sanctioned crate already covers), or can ground an apply-ready diff — to the harness's operating layer, or advocating a process-phrase re-cut — in a named invariant. Files one terse capture to .flume/friction/, .flume/refactor/, or .flume/amendments/ in the documented format — exceptional, never a duty; most ticks file nothing. |
Capture friction, structural debt, or a harness amendment
Three sibling channels, one skill: .flume/friction/ carries agent→human
harness feedback (humans drain it); .flume/refactor/ carries agent→plan
structural-debt observations (plan drains them into pending entries);
.flume/amendments/ carries agent→human apply-ready harness diffs (0044,
humans ratify). Check the target directory first — never re-file an
already-filed capture.
The bar, all three channels: exceptional, never a duty. Most
ticks/sessions file nothing. A capture names something you actually hit or
touched THIS tick, with its actual cost — never speculative, never a
substitute for finishing the job.
Pick the channel by what you are reporting; each channel's exact format and
draining live in its directory README.
Friction — .flume/friction/<phase>-<slug>.md
A pitfall the harness could have warned about, a disproportionately lengthy
process, missing operational knowledge, or a gate firing on a false positive
— the test is recurrence × cost, something the next session/tick would likely
hit too. Format and draining: .flume/friction/README.md.
Refactor — .flume/refactor/<phase>-<slug>.md
A second implementation of one job, a hand-roll a sanctioned crate covers,
scaffolding copy-pasted once more — the engineering-shape standard
(specs/process/engineering.md). Consolidation inside your own entry's
surface needs no capture; this channel is for debt you touched or read but
could not fix in scope. Format and draining: .flume/refactor/README.md.
Amendment — .flume/amendments/<phase>-<slug>.md
A harness change you can ground in a named invariant and a cost you actually
paid, expressed as an apply-ready unified diff — a prompt edit, a rule
re-cut, a capture-format fix. A proposal that still needs drafting is
friction, not an amendment. In-scope targets, the constitution's exclusions,
format, and draining: .flume/amendments/README.md.
