# CLAUDE.md

## Repository Role

This repository is used to analyze Claude Code framework internals. Treat it as
a source-reading and knowledge-base workspace, not an implementation product.

Main artifacts:

- `reference/`: source snapshots and reference materials. Do not edit unless explicitly requested.
- `knowledge-base/`: durable Markdown notes and indexes.
- `advanced-site/Claude-Code-Analysis.html`: default public-facing HTML target.
- `reports/`: rendered reports and visual explanations.

## Research Control Point

When a session researches this repository:

1. Read the relevant implementation first.
2. Cite source paths and line numbers.
3. Update or create the focused `knowledge-base/<topic>.md` note when the finding is durable.
4. Update `knowledge-base/index.md` when a new topic file is added.
5. Update or explicitly evaluate `advanced-site/Claude-Code-Analysis.html` when the finding can make the external explanation clearer.
6. If no KB or HTML update is needed, say so with the reason before stopping.

## Repository Guides

Use these as the detailed operating rules:

- `knowledge-base/readme.md`
- `knowledge-base/claude.md`
- `knowledge-base/agents.md`