Deep test the codebase
This skill performs a thorough and strict verification of the codebase to guarantee that changes are clean, functional, matches Conventions, contains proper license headers, and does not leak template placeholders.
1. Prerequisites
Ensure you have the required runtimes and node dependencies installed:
- Node.js (>= 18)
- Run
npm installbefore running tests if dependencies are updated.
2. Run the Deep Test
Run the automated deep test script via npm:
npm run deep-test
3. Verify Output
The script automatically tests:
- Smoke tests:
node test/run-tests.mjs - Document Claim verification:
node install.mjs verify . --strict - Structural Drift verification:
node install.mjs drift . --strict --git(falls back to--strictwithout--gitif git is not available) - License Headers check: Scans files for copyright markers.
- Unresolved template placeholders: Confirms template variables are not leaked outside of
templates/.
If any of the checks fail, print the failures verbatim and address them before declaring success.
4. Manual Verification / Check Checklist
- If you introduced new files, check that their paths are added to the appropriate catalog or map (e.g.,
ai/guide/MODULE_MAP.md) and labeled as[inferred]. - Verify the change adheres to all project rules in
AGENTS.mdand conventions inai/guide/CONVENTIONS.md.