Problem
Agent guidance is duplicated across root policy and oversized skills, so normal tasks ingest unrelated manuals and contradictory workflow ceremony.
Context
README.md already owns stable repository facts, but CLAUDE.md, AGENTS.md, and domain skills repeat them.
The jgengine router contains domain manuals instead of routing progressively.
Legacy size baselines grandfather oversized intake, while API/orphan checks can reward symbol mentions rather than usable guidance.
PR Un-red main: fix orphan-gate false positives, guard degraded generation, surface red main #945 changed API, capability, and orphan-gate data; this work must re-measure and preserve its useful protections.
Suggested scope
Keep CLAUDE.md and AGENTS.md identical, governance-only, and under an enforceable few-KB budget.
Reduce jgengine/SKILL.md to a true router of at most 100 lines; consolidate aliases and give each domain one owner.
Add active-intake, mirror-equality, routing, and duplication checks that prevent prose dumping without weakening safety.
Preserve editor ownership, upstream-first design, layering, prohibited assets, attribution, user-owned merge/release, and risk-based verification.
Prove lower root, total skill, router, and normal-game active-intake bytes; update generators, references, tests, and skill packaging.
Ship the coherent overhaul in one PR that documents the reviewable/revertible PR-boundary rule.
Problem
Agent guidance is duplicated across root policy and oversized skills, so normal tasks ingest unrelated manuals and contradictory workflow ceremony.
Context
README.mdalready owns stable repository facts, butCLAUDE.md,AGENTS.md, and domain skills repeat them.jgenginerouter contains domain manuals instead of routing progressively.Suggested scope
CLAUDE.mdandAGENTS.mdidentical, governance-only, and under an enforceable few-KB budget.jgengine/SKILL.mdto a true router of at most 100 lines; consolidate aliases and give each domain one owner.