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 --fix flag provided
-
Update last_validated timestamp
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.