Brewdoc Overview

Brewdoc is a documentation toolkit plugin (a set of utilities for working with documents) for Claude Code. It keeps documentation in sync with the codebase, optimizes content for LLM consumption, and exports documents to ready-made formats.

Installation

Install prompt

If Claude refuses to run the commands, paste the prompt below directly into the chat.
Execute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:

1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
2. claude plugin install brewdoc@claude-brewcode

After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.

Install the entire suite:

Install prompt

If Claude refuses to run the commands, paste the prompt below directly into the chat.
Execute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:

1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
2. claude plugin install brewcode@claude-brewcode
3. claude plugin install brewdoc@claude-brewcode
4. claude plugin install brewtools@claude-brewcode
5. claude plugin install brewui@claude-brewcode

After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.

Skills (recipes)

Brewdoc contains 6 skills, each handling a separate documentation task.

πŸ”„

Auto-Sync

Synchronize documentation (labels) with code. Detects outdated files through INDEX, launches parallel agents for updates. Supports project, global, file, and folder modes.

πŸ“‹

My-Claude

Generate documentation about your Claude Code installation. Three modes: internal (local configuration), external (hooks and context architecture), research (search across forums, GitHub, marketplaces).

🧠

Memory

Interactive optimization of memory files (CLAUDE.md and MEMORY.md). 4 steps: remove duplicates, migrate to rules, compress, validate.

πŸ“‚

md-to-pdf

Convert Markdown to professional PDF. Two engines: reportlab (lightweight) and weasyprint (full CSS support). Style customization, test mode, LLM preprocessing.

πŸ”—

Publish

Publish text, markdown, JSON, or files to brewpage.app. Interactive namespace and password selection. Owner token saved locally for later delete.

πŸ“–

Guide

Interactive tutorial for the full plugin suite. 9 topics across 3 domains, progress tracking, multilingual support.

Commands

CommandPurposeModelArguments
/brewdoc:auto-syncSynchronize documentation with codeopus[status] | [init <path>] | [global] | [path]
/brewdoc:my-claudeGenerate documentation about Claude Code installationopus[ext [context]] | [r <query>]
/brewdoc:memoryOptimize memory files in 4 stepsopusβ€”
/brewdoc:md-to-pdfConvert Markdown to PDFsonnet<file.md> [--engine name] ["prompt"] | styles | test
/brewdoc:publishPublish to brewpage.app β€” returns public URLhaiku<text|file|json> [--ttl N]
/brewdoc:guideInteractive tutorial for the plugin suitehaiku[topic]

My-Claude

The /brewdoc:my-claude skill now has a dedicated page with full documentation.

Architecture

Brewdoc has a minimal architecture compared to Brewcode:

brewdoc/
β”œβ”€β”€ .claude-plugin/
β”‚   └── plugin.json              # Plugin manifest
β”œβ”€β”€ hooks/
β”‚   β”œβ”€β”€ hooks.json               # 1 hook (Pre-Task)
β”‚   β”œβ”€β”€ pre-task.mjs             # BD_PLUGIN_ROOT injection
β”‚   └── lib/utils.mjs            # I/O utilities
β”œβ”€β”€ skills/
β”‚   β”œβ”€β”€ auto-sync/               # Documentation sync
β”‚   β”œβ”€β”€ my-claude/               # Installation documentation
β”‚   β”œβ”€β”€ memory/                  # Memory optimization
β”‚   β”œβ”€β”€ md-to-pdf/               # PDF conversion
β”‚   β”œβ”€β”€ publish/                 # brewpage.app publishing
β”‚   └── guide/                   # Interactive tutorial
└── agents/
    └── bd-auto-sync-processor   # File processing agent

The single hook pre-task.mjs injects the BD_PLUGIN_ROOT variable into subagent prompts so they can locate the plugin’s instruction files. Skills in the main conversation use ${CLAUDE_SKILL_DIR} to access their own files.

Brewdoc vs Brewcode

Brewdoc is a set of documentation utilities: sync, memory optimization, PDF export. Each skill is self-contained and independent of the others.

Brewcode is a task execution engine with infinite context, 9 lifecycle hooks, KNOWLEDGE.jsonl, and a session handoff mechanism.

Both plugins install from the same claude-brewcode marketplace but operate independently.

πŸš€

Latest Release

Download, changelog, and installation instructions.

πŸ“–

Installation Guide

Full setup, update, and troubleshooting instructions.

πŸ”—

View on GitHub

Source code, README, and configuration files.