@justinmoon/agent-tools

CLI tooling for AI agent project hygiene.

Usage

npx @justinmoon/agent-tools <command>

Commands

list-docs

List docs in ./docs/ with frontmatter summaries and "read when" hints.

npx @justinmoon/agent-tools list-docs

check-docs

Validate all docs have proper frontmatter. Use in CI.

npx @justinmoon/agent-tools check-docs

Doc format

---
summary: Brief description of what this doc covers
read_when:
  - when working on feature X
  - when debugging Y
---

check-justfile

Verify all justfile recipes have a # summary comment. Use in CI.

npx @justinmoon/agent-tools check-justfile
npx @justinmoon/agent-tools check-justfile path/to/justfile

CI Integration

Add to your pre-merge justfile recipe:

pre-merge: lint test
    npx -y @justinmoon/agent-tools check-docs
    npx -y @justinmoon/agent-tools check-justfile