Skills › BMAD Method › bmad-toolsmith › lens-determinism.md
lens-determinism.md
13 lines · skills/bmad-toolsmith/lenses/lens-determinism.md at bd70c64
1# Lens: determinism
3Lane: the boundary between script and prose. The bar: a script does work with one right answer per input; prose does work that turns on meaning. A line crossing either way is a defect.
5- Prose doing work a unit test could check: parsing, counting, path resolution, rendering a template, validating structure, diffing. The signal verbs: validate, count, extract, convert, compare, scan for, check structure, list all, diff. High when paid on every invocation, medium when occasional and cheap. Name the script and its interface.
6- Prose reading raw files to pull out a few facts (frontmatter values, token counts, inventories) where a pre-pass script could hand the model compact JSON: medium, high for large files.
7- Scripts in `scripts[]` with `has_pep723` or `has_test` false, or without `--help`: medium each. `script_findings` carries the detail; cite it, do not re-derive it.
8- A script that defers errors to the model: swallows an exception, warns and exits 0, or returns partial output with no reason. High; the model will treat it as success.
9- A script deciding meaning: a regex or string match classifying intent, tone or quality rather than locating a delimiter. Critical when it gates later behavior, high otherwise; it breaks when the phrasing shifts.
10- Memory agent (`shape_hint` is `memory-agent`): prose maintaining an index of memory files, counting or sorting entries, or checking the sanctum's structure, when `wake.py` generates the map: medium. The model's tokens go to what to remember, not bookkeeping.
11- A transcript or session log in hand: the same helper re-derived turn after turn is the strongest script signal. High; name the script that does it once.
13Not flagged: judgment on meaning, tone, ambiguity or severity; persona; a one-off operation cheaper to say than to script; work the pre-pass already did.
Lens: determinism
Lane: the boundary between script and prose. The bar: a script does work with one right answer per input; prose does work that turns on meaning. A line crossing either way is a defect.
- Prose doing work a unit test could check: parsing, counting, path resolution, rendering a template, validating structure, diffing. The signal verbs: validate, count, extract, convert, compare, scan for, check structure, list all, diff. High when paid on every invocation, medium when occasional and cheap. Name the script and its interface.
- Prose reading raw files to pull out a few facts (frontmatter values, token counts, inventories) where a pre-pass script could hand the model compact JSON: medium, high for large files.
- Scripts in
scripts[]withhas_pep723orhas_testfalse, or without--help: medium each.script_findingscarries the detail; cite it, do not re-derive it. - A script that defers errors to the model: swallows an exception, warns and exits 0, or returns partial output with no reason. High; the model will treat it as success.
- A script deciding meaning: a regex or string match classifying intent, tone or quality rather than locating a delimiter. Critical when it gates later behavior, high otherwise; it breaks when the phrasing shifts.
- Memory agent (
shape_hintismemory-agent): prose maintaining an index of memory files, counting or sorting entries, or checking the sanctum's structure, whenwake.pygenerates the map: medium. The model's tokens go to what to remember, not bookkeeping. - A transcript or session log in hand: the same helper re-derived turn after turn is the strongest script signal. High; name the script that does it once.
Not flagged: judgment on meaning, tone, ambiguity or severity; persona; a one-off operation cheaper to say than to script; work the pre-pass already did.
Raw lines 1 to 13