ping-mee-self-service-platform/.agents/skills/bmad-toolsmith/lenses/lens-architecture.md

Lens: architecture

Lane: structure and progressive disclosure, per lenses/standards.md and the canon. The bar: the entry carries only what every route needs; everything the skill promises exists and resolves.

• skill_md_tokens against what each route loads: branch content in SKILL.md, or a reference smaller than its pointer. High past about 800 tokens in a plain skill, or 1,200 in an agent, with a carvable section, else medium. A small skill in one file with no references is the right shape, not a gap. The budget is the entry's; a large workflow carved so that a run loads only its branch is right-sized at any total, and a large one loaded whole is not.
• A reference loading another reference, or leaning on "as described above": high; it breaks when the entry drops out.
• A router with one branch, or branches of a line each: medium; inline it.
• Content duplicated across files, or a fact restated across sections: medium.
• A route or step file loaded ahead of its branch: high; the model pays for text it may never need.
• path_findings that hold up: a path that does not resolve, a path into another skill, a bare scripts/ call. High, critical if activation depends on it.
• A pattern over-applied (parallel reviewers on a one-file transform, a memlog on a one-shot, a menu on a one-job skill): medium; say what removing it loses. A multi-turn build with no state across turns: medium.
• Agent (shape_hint is agent or memory-agent): every [[agent.menu]] item resolves to an installed skill, a references/<capability>.md that exists, or an inline prompt that is the whole instruction; one pointing at a missing file is high. A capability file holding nothing the persona and one sentence would not supply: low; recommend inlining it. Overlapping capabilities, one job split across several, or a persona promising what no capability delivers: medium.
• bmod_kind is none while the skill ships customize.toml or calls _bmad/scripts: wired to BMad and registered nowhere, so help, setup and update checks never see it. Critical when the read-back registered it; not a finding when the read-back chose a plain skill. invalid: critical, bmad reports the file as a problem.
• Memory agent: the sanctum seeds the shape ships in assets/ and the wake and init scripts in scripts/; a missing one is critical, the agent cannot wake. Sanctum content sitting in SKILL.md: high. Memory kept as one growing file loaded at waking, a token guardrail that forces pruning, or an index the agent must update by hand: high; memory is small files by subject that load when reached, and the map is generated. A bootloader or First Breath reading the owner's name or language from config: high; they are learned in the first exchange.

Not flagged: a thin memory-agent SKILL.md (thin is the design); the identity files loaded whole on waking; branch lines too small to carve; the other lenses' lanes.