interdoc

interdoc

Recursive AGENTS.md generator for Claude Code.

What this does

Point interdoc at a project and it produces cross-AI compatible documentation: AGENTS.md files that work with Claude Code, Codex CLI, and whatever comes next. It spawns parallel subagents to analyze each directory, consolidates their findings, deduplicates cross-cutting patterns, and shows you a unified diff before writing anything.

Why AGENTS.md? Claude Code reads both AGENTS.md and CLAUDE.md, but AGENTS.md is the cross-AI standard. Using it as the primary format means your documentation works regardless of which agent you're running.

The skill auto-detects mode: no AGENTS.md means generation (full recursive pass), existing AGENTS.md means update (incremental changes only, preserving what you've already written).

Installation

First, add the interagency marketplace (one-time setup):

/plugin marketplace add mistakeknot/interagency-marketplace

Then install the plugin:

/plugin install interdoc

Or manually:

git clone https://github.com/mistakeknot/interdoc.git
cd interdoc && /plugin install .

Usage

Ask naturally: interdoc picks up the intent:

"generate documentation for this project"
"update AGENTS.md"
"fix stale references"

Key modes

Generation: spawns one subagent per directory in parallel, each analyzing purpose/architecture/conventions/gotchas, then consolidates into coherent docs with cross-references. For large projects (100+ files), it offers scoping: top-level only, full recursive, or custom.

Update: detects git changes since last update, skips up-to-date directories, and proposes incremental additions/modifications/deletions rather than full rewrites. Shows exact diffs in unified diff format.

Fix: deterministic structural repairs (broken cross-links from renames, deletions, moves) without spending LLM tokens. Use /interdoc fix after reorganizing files.

CLAUDE.md harmonization: if you have both CLAUDE.md and AGENTS.md, interdoc can consolidate them: migrates project docs to AGENTS.md, slims CLAUDE.md to settings only, adds a pointer.

GPT-Powered review

After generating docs, interdoc automatically sends them to Oracle for independent critique via Oracle. This catches blind spots that self-review misses. Never blocks if Oracle is unavailable: the feature is additive, not required.

Dry run

Add "dry run" to your request to preview without writing. Apply later with "apply last preview" (valid until HEAD changes).

Architecture

skills/interdoc/SKILL.md     Main skill definition
hooks/                       SessionStart (check freshness), PostToolUse (commit check)
.claude/agents/              interdocumentarian.md (specialized directory analyzer)

Credits

MK (mistakeknot@vibeguider.org)

License

MIT