Skill Tracer
Skills › BMAD Method › bmad-toolsmith › lens-leanness.md

lens-leanness.md

17 lines · skills/bmad-toolsmith/lenses/lens-leanness.md at bd70c64

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Lens: leanness
2
3Lane: whether every line beats its own absence, and whether what survives is a goal. The bar is `canon.md`, applied line by line; cite its tests, do not restate them.
4
5- Core-test failures: lines a capable model follows unprompted. "Make sure", "don't forget", templates that teach markdown, mechanics of a tool the model drives fluently, scoring formulas for judgment. Low for a line or two, high for a section.
6- Explanation wrapped around an instruction that survives truncation: low or medium.
7- Meta-explanation of the system to itself, negative space ("this no longer does"), facts restated across sections: medium.
8- Numbered lists that are not sequences: independent steps the model will march through. Medium; the recommendation holds the goal sentence that replaces them. A sequence guarding a named failure stays.
9- ALL-CAPS MUST, ALWAYS, NEVER and stacked imperatives: medium; recommend the failure the rule prevents, in plain words.
10- A stripped why: a non-obvious rule with no reason, so it cannot reach the unforeseen case. Medium; under-writing, not leanness.
11- The same point in two places: medium; name the one place it belongs. A step that ends on a bound the model cannot check ("when it is clear", "once done"): medium; recommend the condition that closes it.
12- A prohibition where a positive form says the same, or a coined term and adjective runs where one word the model knows would do: low; recommend the positive sentence or the word.
13- Content the model could get by looking, a file's contents, a command's flags, copied into the skill: low, since it goes stale.
14- A worked artifact where a format line would do: medium; recommend the line, or a pointer to the project's own instances, per test 8 in `canon.md`.
15- A section that cannot name where its elaborate form beats a five-line version (role, outcome, consumer, the scarred rules): write the five lines into `proposed_smallest` and the predicted loss, often nothing, into `predicted_delta`; `ship.md` and `modes/cut.md` apply it, and a variant eval through the `bmad-eval` skill measures it when the user doubts the cut. High for a section, medium for a paragraph.
17Not flagged: persona voice in an agent (identity, communication style, principles, examples of voice): the bar applies to capability prompts, and a flatter persona is a worse outcome, not a leaner one; repetition or contradiction inside persona text still counts. A menu item whose prompt is a sentence with no capability file: it is listed for the user to see what is on offer, and the model does the rest. The other lenses' lanes. Critical only for friction that misleads the model into a wrong action.

Lens: leanness

Lane: whether every line beats its own absence, and whether what survives is a goal. The bar is canon.md, applied line by line; cite its tests, do not restate them.

  • Core-test failures: lines a capable model follows unprompted. "Make sure", "don't forget", templates that teach markdown, mechanics of a tool the model drives fluently, scoring formulas for judgment. Low for a line or two, high for a section.
  • Explanation wrapped around an instruction that survives truncation: low or medium.
  • Meta-explanation of the system to itself, negative space ("this no longer does"), facts restated across sections: medium.
  • Numbered lists that are not sequences: independent steps the model will march through. Medium; the recommendation holds the goal sentence that replaces them. A sequence guarding a named failure stays.
  • ALL-CAPS MUST, ALWAYS, NEVER and stacked imperatives: medium; recommend the failure the rule prevents, in plain words.
  • A stripped why: a non-obvious rule with no reason, so it cannot reach the unforeseen case. Medium; under-writing, not leanness.
  • The same point in two places: medium; name the one place it belongs. A step that ends on a bound the model cannot check ("when it is clear", "once done"): medium; recommend the condition that closes it.
  • A prohibition where a positive form says the same, or a coined term and adjective runs where one word the model knows would do: low; recommend the positive sentence or the word.
  • Content the model could get by looking, a file's contents, a command's flags, copied into the skill: low, since it goes stale.
  • A worked artifact where a format line would do: medium; recommend the line, or a pointer to the project's own instances, per test 8 in canon.md.
  • A section that cannot name where its elaborate form beats a five-line version (role, outcome, consumer, the scarred rules): write the five lines into proposed_smallest and the predicted loss, often nothing, into predicted_delta; ship.md and modes/cut.md apply it, and a variant eval through the bmad-eval skill measures it when the user doubts the cut. High for a section, medium for a paragraph.

Not flagged: persona voice in an agent (identity, communication style, principles, examples of voice): the bar applies to capability prompts, and a flatter persona is a worse outcome, not a leaner one; repetition or contradiction inside persona text still counts. A menu item whose prompt is a sentence with no capability file: it is listed for the user to see what is on offer, and the model does the rest. The other lenses' lanes. Critical only for friction that misleads the model into a wrong action.

Raw lines 1 to 17
Names a skill bmad-eval :15