Claude MD
Create and maintain CLAUDE.md and AGENTS.md documentation files.
Workflow
Creating New Docs
For projects without CLAUDE.md/AGENTS.md:
scripts/init_docs.py [--path <project>]This will:
- Analyze codebase (detect project type, extract info)
- Generate directory tree (using cli-tree skill)
- Create CLAUDE.md (pointer file)
- Create AGENTS.md (full documentation with frontmatter)
Validating/Updating Existing Docs
For projects with existing documentation:
scripts/validate_docs.py [--path <project>] [--fix]This will:
- Check structure (required sections present)
- Verify codebase consistency (paths exist, commands valid)
- Detect staleness (files changed since last validation)
- Apply fixes if
--fixflag provided - Update
last_validatedtimestamp
Project Type Detection
The init script auto-detects project type:
| Files Present | Detected Type |
|---|---|
package.json with react/next | nodejs-react |
package.json with express | nodejs-api |
package.json (other) | nodejs-library |
pyproject.toml / setup.py | python |
Cargo.toml | rust |
go.mod | go |
Multiple package.json | monorepo |
.claude/skills/ present | Adds skills framework section |
Generated Files
CLAUDE.md:
# Claude Code Instructions
See @AGENTS.md for detailed instructions.AGENTS.md:
---
last_validated: 2026-01-21T12:00:00Z
project_type: nodejs-library
---
# Agent Instructions: project-name
[Content based on template and codebase analysis]Validation Checks
- Structure: Required sections exist
- Content: No TODO placeholders, valid links
- Consistency: Paths in docs exist, commands in package.json/pyproject.toml
- Freshness: Compares file modification dates vs last_validated
Template
See references/template.md for the AGENTS.md template structure.