project-discipline-guides
Project Discipline Guides
A discipline guide serves as the conceptual orientation "hub" for a category or domain, establishing the coding agent's mental model and routing to granular use-case subguides via the {{ GUIDE_REF("guide-slug") }} macro. A guide is recognized as a discipline guide once registered in DISCIPLINE_GUIDES in src/core/guide-validation.ts, which includes:
- Category root guides that orient an entire discipline (such as
guides/css/css/guide.md). - Named orientation guides for cross-cutting feature horizontals or subdisciplines (such as
guides/wasm/cpp-on-the-web/guide.md).
Discipline guides are exempt from the description and web-feature-ids frontmatter requirements and are reported as bundled core guides by src/build/audit-build.ts.
This skill also facilitates the "Differential Knowledge Refactor" of discipline guides to ensure they remain lean, context-efficient, and strictly additive to what modern AI models already know natively.
Workflow: The Inverse Knowledge Filter
The goal is to aggressively "whittle down" a target guide (the Target) by removing any content that is natively understood by modern coding models.
1. Generate Knowledge Mirrors
Use the provided script to generate "Redundancy Mirrors"—comprehensive guides of what Gemini, Claude, and Codex consider "Common Knowledge" for a given discipline, and intersect them into a single LCD mirror.