Claude MD

Workflow

Creating New Docs

scripts/init_docs.py [--path <project>]

1. Analyze codebase (detect project type, extract info)
2. Generate directory tree (using cli-tree skill)
3. Create CLAUDE.md (pointer file)
4. Create AGENTS.md (full documentation with frontmatter)

Validating/Updating Existing Docs

scripts/validate_docs.py [--path <project>] [--fix]

1. Check structure (required sections present)
2. Verify codebase consistency (paths exist, commands valid)
3. Detect staleness (files changed since last validation)
4. Apply fixes if

   --fix

   flag provided
5. Update

   last_validated

   timestamp

Project Type Detection

package.json

nodejs-react

package.json

nodejs-api

package.json

nodejs-library

pyproject.toml

setup.py

python

Cargo.toml

rust

go.mod

go

package.json

monorepo

.claude/skills/

Generated Files

# Claude Code Instructions

See @AGENTS.md for detailed instructions.

---
last_validated: 2026-01-21T12:00:00Z
project_type: nodejs-library
---

# Agent Instructions: project-name

[Content based on template and codebase analysis]

Validation Checks

1. Structure: Required sections exist
2. Content: No TODO placeholders, valid links
3. Consistency: Paths in docs exist, commands in package.json/pyproject.toml
4. Freshness: Compares file modification dates vs last_validated

Template

references/template.md