ClaudeMD Forge

Generate and audit CLAUDE.md files in seconds. Make Claude Code, Cursor, Windsurf, and Codex actually understand your project.

pip install claudemd-forge
PyPI Python License Tests

Generate

Scan your codebase and produce a complete CLAUDE.md with coding standards, commands, anti-patterns, and architecture — in one command.

Audit

Score an existing CLAUDE.md against 5 quality dimensions: coverage, accuracy, specificity, anti-patterns, and freshness.

CI/CD

GitHub Action runs audit on every PR. Posts a formatted comment with score, findings, and recommendations. Fail builds below your threshold.

Framework-Aware

11 presets for FastAPI, React, Next.js, Django, Rust, Go, Express, and more. Each preset knows the conventions and anti-patterns of its ecosystem.

See It Work

$ claudemd-forge generate . --quiet

$ claudemd-forge audit CLAUDE.md

Audit Findings
WARNING coverage Missing "Architecture" section
INFO specificity "follow best practices" is too vague
INFO freshness Reference to nonexistent file: src/old_module.py

Score: 72/100

Recommendations:
- Add Architecture section with directory tree
- Replace vague guidance with specific rules
- Remove stale file references

GitHub Action

Audit CLAUDE.md on every pull request. No config beyond the workflow file.

# .github/workflows/claudemd-audit.yml
name: Audit CLAUDE.md
on: [pull_request]

jobs:
audit:
runs-on: ubuntu-latest
permissions:
pull-requests: write
steps:
- uses: actions/checkout@v6
- uses: Arete-Consortium/claudemd-forge@v0.2.0
with:
fail-below: 40
comment: true

Pricing

Free

$0
  • Generate CLAUDE.md from any codebase
  • Audit with 5-dimension scoring
  • 11 community framework presets
  • JSON output for scripting
  • GitHub Action with PR comments
  • Interactive guided setup
  • Drift detection
  • Premium presets

Pro

$8/mo
  • Everything in Free
  • Interactive guided setup
  • Drift detection (diff command)
  • 6 premium presets
  • Team templates (coming soon)
  • Priority support