Audit and fix all Lattice documentation, README, docs/, PROJECT.md, GitHub issue templates, and CLAUDE.md to ensure they are fully aligned with the current skill inventory. Documentation drift is the most common source of user confusion in Lattice — a skill exists in the codebase but not in the docs, or a renamed skill leaves a stale reference in the bug report template. If you've made any change to skills/ and haven't run this, run it now. Use when the user says 'align docs', 'audit docs', 'update documentation', 'skill align', 'check docs are in sync', 'audit skill inventory', 'ensure docs are aligned', 'are the docs up to date', or 'what needs updating'. Standalone — does not call other skills.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Audit and fix all Lattice documentation, README, docs/, PROJECT.md, GitHub issue templates, and CLAUDE.md to ensure they are fully aligned with the current skill inventory. Documentation drift is the most common source of user confusion in Lattice — a skill exists in the codebase but not in the docs, or a renamed skill leaves a stale reference in the bug report template. If you've made any change to skills/ and haven't run this, run it now. Use when the user says 'align docs', 'audit docs', 'update documentation', 'skill align', 'check docs are in sync', 'audit skill inventory', 'ensure docs are aligned', 'are the docs up to date', or 'what needs updating'. Standalone — does not call other skills.
Lattice Sync
Core responsibility: Keep every public-facing document in sync with the actual skill inventory. The skills directory is the source of truth — all documents derive from it.
Input: None required. Reads the live state of skills/ and all documentation on every run. Optionally: a specific skill name or tier to focus the audit.
Output:
A findings report listing every gap as [GAP], [STALE], or [WRONG] with file and description
All found gaps fixed in-place across: README.md, docs/how-it-works.md, docs/configuration.md, docs/practical-guide.md, PROJECT.md, CLAUDE.md, .github/ISSUE_TEMPLATE/bug_report.yml
A final clean confirmation: "No gaps found" or a list of what was changed
Read references/audit-checklist.md for the complete per-document audit rules before starting Phase 2.
Phase 2 — Audit each document
Work through every document in this order. For each, apply the checks in references/audit-checklist.md. STOP: a document with zero findings gets no entry in the report — do not print a heading or a "no gaps" line for it. Log every finding as:
[GAP] file:line — description of what is missing or wrong
[STALE] file:line — description of what refers to something that no longer exists
[WRONG] file:line — description of a relationship (consumed-by, produces) that is incorrect
Documents to audit:
docs/how-it-works.md
docs/configuration.md
docs/practical-guide.md
README.md
PROJECT.md — Skill Conventions, Known subfolders list, and Repository Structure counts all live here
.github/ISSUE_TEMPLATE/bug_report.yml
.github/ISSUE_TEMPLATE/skill_request.yml(generic — only check if skill-specific examples are present)
.github/ISSUE_TEMPLATE/documentation.yml(generic — only check if skill names appear)
knowledge-base/requirement-forge-requirements.md(if exists — check it matches current skill names)
Present a consolidated findings report before making any changes:
## Lattice Sync — Findings
### docs/how-it-works.md
[GAP] Atoms table missing: requirement-quality
[STALE] Refiners in Depth: requirement-forge-refiner consumed-by says "molecule" but should say "requirement-quality atom"
### .github/ISSUE_TEMPLATE/bug_report.yml
[GAP] Skill dropdown missing: requirement-quality (atom)
Total: N gaps, M stale references, P wrong relationships
Ask: "Ready to apply all fixes? Or are there any findings you want to skip?"
Phase 3 — Fix
Apply every agreed fix. For each document, make all changes in a single edit pass. STOP: do not make multiple passes over the same file.
After all fixes are applied, run one final verification grep to confirm no old references remain:
# Check for stale atom names or wrong consumed-by text
grep -rn "<old-name>\|consumed.*molecule\|consumed.*wrong" \
docs/ README.md PROJECT.md CLAUDE.md .github/ --include="*.md" --include="*.yml"
If the grep returns results, fix them before declaring done.
Phase 4 — Deploy (optional)
If the user wants to push the updated skills to their AI tool's skills directory:
./tools/install.sh /path/to/your/skills/folder
Ask the user for the target path if not provided. Default for Claude Code: ~/.claude/skills/.
Key relationships to always verify
The most error-prone relationship in Lattice documentation is the refiner → atom → molecule chain. Documents frequently drift to say a refiner is "consumed by the molecule" when it's actually consumed by an atom that the molecule composes.
For every refiner in the live inventory, derive the correct relationship dynamically:
Read the refiner's SKILL.md — find which atom it says consumes it (look for "consumed by" or "reads this document")
Read that atom's Config Resolution — confirm it reads the same paths.{key}
Read the molecule that composes that atom — confirm the chain is complete
If any document says the refiner is consumed by the molecule directly (not the atom), flag [WRONG]
Exception: review-refiner is consumed by the review molecule directly — it configures the molecule's workflow, not an atom. This is the only correct molecule-direct consumption in the current framework.
Known .lattice/ subfolders
Every molecule that writes living documents must use a named subfolder. If a new molecule is found that writes to .lattice/ and its subfolder is not in this list, flag it for addition to PROJECT.md:
Every skill in skills/ appears in the docs/how-it-works.md inventory tables
Every refiner has a correct entry in docs/configuration.md paths table with the right consumed-by atom
Every molecule appears in bug_report.yml skill dropdown
Every atom appears in bug_report.yml skill dropdown
Every refiner appears in bug_report.yml skill dropdown
PROJECT.md known subfolders list covers every .lattice/ output directory
No document contains a skill name that no longer exists in skills/
The pipeline descriptions in README.md and docs/how-it-works.md use current molecule names in the right order
Every molecule that hardcodes its own refiner list (refiners-update's map table, lattice-init's Step 3 priority list) has one entry per live refiner in skills/refiners/ — no missing, no stale
See references/audit-checklist.md for the exhaustive per-document rules.
