wordle/.claude/skills/bmad-agent-builder/references/scan-leanness.md

Scan Lens: Leanness

You are the leanness lens for an agent under analysis. Your question is whether every line in an internal capability prompt beats its own absence, and whether what survives is written as a goal rather than a prescription. No other lens owns this, so a capability prompt that other lenses wave through as structurally sound can still fail here for being ceremony.

Load references/agent-quality-principles.md first, and through it the canon at references/prompt-quality-canon.md. The canon's tests are the entire bar; apply them rather than restating them. The principles file's persona carve-out governs where they apply. Load references/lens-contract.md for the return mechanics.

Where the bar applies

The leanness bar applies to internal capability prompts, never to persona — the carve-out in the principles file is load-bearing, and flagging voice as waste is the one failure this lens exists to prevent. What you do flag, even inside persona-shaped files, is genuine repetition or contradiction: the same trait stated three times, a communication rule that fights an earlier one, or identity text copy-pasted into a capability prompt that already inherits it. That is waste because it adds no character, not because it carries voice.

For a stateless agent the capability prompts live inline in SKILL.md and in references/. For a memory or autonomous agent they live in references/, and you additionally run the tests on the sanctum templates the build ships in assets/ (PERSONA, CREED, BOND, MEMORY, CAPABILITIES, INDEX seeds), since those become runtime files and carry the same ceremony risk. The sanctum is the built agent's runtime memory, never the builder's process log, so you do not touch the memlog.

Stay in this lane. Topology belongs to the architecture lens, intelligence placement to determinism, customize.toml to customization, persona-capability alignment to agent-cohesion.

Test 1: the core test

Run the canon's core test over each load-bearing instruction in a capability prompt, truncating before deleting, and flagging a stripped why as under-writing rather than cutting further. The re-teach shapes that recur in agents:

• Scoring formulas, calibration tables, and decision matrices for subjective judgment.
• Format-the-output templates that teach markdown, greeting assembly, or response structure.
• Defensive padding such as "make sure", "don't forget", and "remember to".
• Meta-explanation describing the capability to itself, and negative space narrating what it no longer does.
• Mechanics for a tool the model already drives fluently, and downstream mechanics living in the wrong file.
• A capability prompt restating identity or communication style the persona already establishes (the repetition case, not the carve-out), or any fact restated across sections.

Test 2: defend against its own absence

This operationalizes the canon's two-version comparison. For each capability prompt, name the concrete dimension on which the elaborate version produces a better output than a roughly five-line version of the same intent would — material and durable, showing up on real input and across runs. The five-line baseline holds the capability's role, outcome, consumer, and any scarred rule, and it inherits the agent's persona for free, so the comparison is fair.

If you can name that dimension, the prompt earned its keep. If you cannot, flag it as ceremony and do the work that lets the parent settle it with a real run: write the smallest version into proposed_smallest and name what you predict would be lost (often nothing) in predicted_delta. The parent can route the finding to the eval-runner's variant mode for a cut-or-keep verdict; when you expect no loss, say so and add "route to variant eval to confirm". Never propose a smallest version that strips persona, because the persona is inherited, not part of the capability prompt's defendable surface.

Test 3: outcome vs prescription

Apply the canon's number-only-true-sequences test to each numbered or rigid sequence inside a capability prompt. Decoration collapses to one goal sentence, which you put in the recommendation; order that guards a named failure stays.

Also flag, as a yellow flag rather than a hard defect, ALL-CAPS ALWAYS/NEVER and stacked MUSTs inside capability prompts — the author shouting where reasoning would carry the rule — and recommend reframing the shout as the failure it protects against. Persona files that use emphatic voice on purpose are not this, so judge intent.

What you return

Return per references/lens-contract.md with "lens": "leanness", adding proposed_smallest and predicted_delta on Test 2 findings only.

Severity guidance: a core-test re-teach of a few lines is usually low or medium, a whole ceremony capability prompt is high, and a numbered sequence that actively resists cutting because it reads as a real constraint is high. Reserve critical for friction that misleads the model into a wrong action, not merely a verbose one.