moxpp-check

MoxPP CLAUDE.md Integrity Check

Audit CLAUDE.md against the actual project files and propose any corrections. Work through each check below, then present a consolidated diff of all proposed changes for the user to confirm before editing anything.

Steps

0. Check for unconfigured template state

Read CLAUDE.md and check if the top section still contains the unconfigured placeholder (i.e. the line > This is an unconfigured MoxPP template). If it does, stop immediately and tell the user:

This repo hasn't been configured yet. Run /moxpp-setup first, then re-run /moxpp-check once the project is set up.

Do not proceed with any further checks.

1. Read all source-of-truth files

Read the following files in parallel:

• CLAUDE.md — current documented state
• mox.lua — ground truth for project name, C++ version, architecture, macro prefix, configurations, unit test setting
• conanfile.py — ground truth for Conan dependencies and options
• README.md — project description and overview
• LICENSE (if it exists) — license type

Then discover and read all build.lua files in the project:

• single: src/build.lua
• flat: src/*/build.lua
• hierarchical: src///build.lua
• manual: search recursively under src/ for any build.lua
• Always also check test/build.lua if cmox_unit_test_src is set

2. Check project name

Compare the # <Heading> at the top of CLAUDE.md against cmox_product_name in mox.lua. Flag if they differ.

3. Check project description

Compare the description paragraph(s) below the top heading in CLAUDE.md against the content of README.md. Flag if CLAUDE.md is missing a description or if it appears significantly out of date relative to README.md. Do not require word-for-word matches — flag only meaningful divergences in purpose, audience, or scope.

4. Check Conan dependencies

Parse all self.requires("name/version") calls from conanfile.py. Compare the resulting list against the ## Conan Dependencies section in CLAUDE.md:

• Flag any package present in conanfile.py but missing from CLAUDE.md
• Flag any package listed in CLAUDE.md but absent from conanfile.py
• Flag any version mismatches

5. Check unit test setting

Read cmox_unit_test_src from mox.lua:

• If nil: verify the test/ directory does not exist. If it does, warn the user — it should be deleted.
• If set to a folder name: verify that folder exists at the repo root.

6. Check build.lua projects

For each discovered build.lua, extract the project name from mox_project(...). Check:

• No two projects share the same UUID — flag any duplicates.
• Each project's source directory contains at least one .cpp file. For sharedlib/staticlib projects, verify dummy.cpp is present.

7. Check license

If a LICENSE file exists, check whether CLAUDE.md mentions the license. If not, note it as a minor gap (non-blocking).

8. Present findings and propose edits

Summarise all findings grouped by severity:

• Error — factual mismatch that will mislead Claude (wrong name, missing/wrong dependency, duplicate UUID)
• Warning — gap that reduces Claude's effectiveness (missing description, missing dependency note)
• Info — minor or cosmetic gap (license mention, stale wording)

For each Error and Warning, show the exact proposed change to CLAUDE.md. Ask the user to confirm before applying any edits.