git:20251212.79395af to git:20260113.d1c343c

2 added, 1 removed. Audit A to A.

# claude-code-agents-md

Claude Code plugin that loads `AGENTS.md` files using hooks.

## Architecture

### Hooks

**Always** use JSON Output mode. Use `hookSpecificOutput.additionalContext` to inject `AGENTS.md` content into Claude Code sessions.

#### `SessionStart`

- Injects root `AGENTS.md` content at session start

- Uses `startup`, `clear`, and `compact` matchers

#### `PostToolUse` (`Read`)

- Walks upwards from path to project root, injecting the closest `AGENTS.md`

- Tracks files already injected to avoid context duplication

> The closest AGENTS.md to the edited file wins; explicit user chat prompts override everything.

## Development

### Plugin Structure

- `hook.ts`: Hook script that finds and reads `AGENTS.md`

- Use only eraseable TypeScript syntax to allow execution via `node`

- - `plugin.json`: Plugin manifest declaring the hook

+ - `hooks/hooks.json`: Hook registration

+ - `.claude-plugin/plugin.json`: Plugin manifest

## References

- [AGENTS.md standard](https://agents.md)

- [Claude Code hooks reference](https://code.claude.com/docs/en/hooks.md)