document-creator

A command that creates hierarchical DEVGUIDE.md architecture documents for a codebase using language-server analysis. A language server is a tool that understands code symbols, definitions, and references.

In plain words
What is it for?
Use it on one or more directories to map symbols, dependencies, and definitions, while taking relevant project rules into account.
Why use it?
It turns code relationships into written documentation, making unfamiliar directories easier to understand and maintain.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/gantisstorm/essentials-claude-code/document-creator
Clone the repo
git clone --depth 1 https://github.com/GantisStorm/essentials-claude-code
Per session 13 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 697 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00013 $0.00697
Opus 5 $0.00006 $0.00349
Sonnet 5 $0.00003 $0.00139
Haiku 4.5 $0.00001 $0.00070

Measured yesterday against content hash f670c7a45784, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

document-creator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

essentials/commands/document-creator.md · 110 lines

How it starts

The opening of the file, as written. The whole thing — 110 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Document Creator

Generate hierarchical architectural documentation (DEVGUIDE.md) using Claude Code's built-in LSP tools. Supports multiple directories with parallel agent execution.

Built-in LSP Operations

  • documentSymbol — Extract symbols from files
  • findReferences — Map dependencies
  • goToDefinition — Detailed symbol analysis

Arguments

Directory paths to document (one agent per directory):

  • Single directory: /document-creator src/services/
  • Multiple directories: /document-creator src/services src/components src/lib
  • No argument: analyzes current directory (.)

Instructions

Step 1: Parse Input

Parse $ARGUMENTS to extract directory list:

  • Split arguments by spaces
  • If empty → use current directory (.)
  • Validate each path exists as a directory

Step 2: Check for Rules

Check if .claude/rules directory exists at project root:

Use Glob(".claude/rules/*.md") to find rules files.

If rules exist:
- Read each rules file to understand frontmatter paths
- Pass relevant rules info to agents

If no rules exist:
- Note this for agents to create rules files when missing

Step 3: Determine Output Paths

For each directory:

  • If no DEVGUIDE.md exists → <target-dir>/DEVGUIDE.md
  • If exists → <target-dir>/DEVGUIDE_2.md (increment until unused)

Step 4: Launch Agents

For EACH directory, launch background agent:

Generate DEVGUIDE: <directory-path>
Output: <determined path>
Rules: <exists/not found>

REQUIRED Task tool parameters:

subagent_type: "essentials:document-creator-default"
run_in_background: true
prompt: "Generate DEVGUIDE: <dir>\nOutput: <path>\nRules: <status>"

Launch ALL agents in a single message for parallel execution. Output a status message like "Generating N DEVGUIDE files..." and end your turn. The system wakes you when agents finish.

Step 5: Report Results

## DEVGUIDE Documentation Created (LSP)

| Directory | Output | Status |
|-----------|--------|--------|
| [dir1] | [output path] | CREATED |
| [dir2] | [output path] | CREATED |

Rules Status: [Found N rules / No rules folder found]

Next Steps:
1. Review generated documentation
2. Commit the DEVGUIDE files
3. [If no rules] Agent created .claude/rules/ file automatically

Read the full file on GitHub · 110 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 110 lines · 13 tokens per session scan A f670c7a45784

Subscribe to this mod's changes

document-creator is a command published in the GitHub repository GantisStorm/essentials-claude-code (91 stars, last pushed 6mo ago), licensed Unlicense. It adds 13 tokens to every session and 697 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.