PLUGIN brewdoc
On this page
Brewdoc Overview
Brewdoc keeps documentation in sync with the codebase, documents your Claude Code setup, and exports documents to PDF or a shareable link. 5 skills, no agents, no registered hooks; docsync-setup installs optional hooks into your project on request.
Install
Install prompt- if Claude refuses, paste this 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.What you get
| Skill | Does | Link |
|---|---|---|
docsync-setup | Tracks doc staleness by frontmatter date through project hooks | Skill |
my-claude | Documents your Claude Code installation, architecture or a research query | Skill |
memory-sync-setup | Generates a project-local /memory-sync skill | Skill |
md-to-pdf | Converts Markdown to PDF with reportlab or weasyprint | Skill |
publish | Publishes text, files or sites to brewpage.app, returns the URL | Skill |
Commands, arguments and models: Skills.
/brewdoc:docsync-setup sync # Sync stale docs (with confirmation)
/brewdoc:md-to-pdf README.md # Convert markdown to PDF
/brewdoc:publish "Hello world" # Publish to brewpage.app, returns the URL
brewcode mods: Prompt placeholders · Plan-mode effort · Reminders · all mods
How it fits
Each skill is self-contained and independent of the others; the shared -setup convention gives the two setup skills one mode set. Brewdoc covers documentation utilities; Brewcode is the authoring toolkit: skills, agents, rules, semantic search, conventions and E2E tests. Both install from the same claude-brewcode marketplace.
Technical details
Naming and invocation rules #
A -setup suffix marks a skill that installs a mechanism you afterwards use instead of the skill: project-local hooks, or a generated /memory-sync command. Recurring tools keep bare names (md-to-pdf, publish, my-claude). Every -setup skill shares one mode set, in this order: status | install | upgrade | enable | disable | uninstall | purge; no argument means status when installed, install when not. Every brewdoc skill except /brewdoc:publish is user-invoked only (user-invocable: true + disable-model-invocation: true); publish is model-invocable, see the FAQ.
Install the whole suite (plugins and mods) #
The mods need Claude Code 2.1.301 or newer: run claude update, then restart Claude Code (type exit, then run claude).
Install prompt- if Claude refuses, paste this into the chat
First run `claude --version`. The mods need Claude Code 2.1.301 or newer. If it is lower, stop and tell me to run `claude update`, restart Claude Code (type `exit`, then run `claude`) and paste this prompt again.
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 brewmod-placeholders@claude-brewcode
3. claude plugin install brewmod-plan-effort@claude-brewcode
4. claude plugin install brewmod-reminders@claude-brewcode
5. claude plugin install brewcode@claude-brewcode
6. claude plugin install brewdoc@claude-brewcode
7. claude plugin install brewtools@claude-brewcode
8. 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.Plugin structure #
brewdoc/
├── .claude-plugin/plugin.json # manifest
├── hooks/hooks.json # {"hooks":{}} -- no hooks registered
└── skills/ # docsync-setup, my-claude, memory-sync-setup (references/), md-to-pdf, publishdocsync-setup installs project-local hooks into the target project, not into brewdoc. Skills use ${CLAUDE_SKILL_DIR} for their own files.
Safety and scope behaviour #
Docsync installation validates inputs before writing hooks, configuration and settings, merges settings under a lock with no backup file (the transaction is its own rollback), leaves an existing settings.json.bak and session state untouched, and on a write failure restores only files that still match this run’s writes. A generated memory-sync follows restrictions such as “only rules” or “do not touch agents”. Scope, depth and reach are separate choices. Claims are checked against current code, no file ends longer than it started, and a checker other than the writer verifies each batch.
Artifact metadata #
Every artifact a brewdoc -setup skill installs carries the shared provenance fields, resolved from the plugin’s .claude-plugin/plugin.json. Field table: Brewcode overview. /brewcode:setup-status reads them back and reports older installs as stale.
Related
Skills
Commands, arguments and models for all 5 skills.
Installation
Install the suite from the marketplace.
Latest release
Download, changelog, and installation instructions.
GitHub source
Source code, README, and configuration files.
Update: /brewtools:plugin-update, /reload-plugins, then /brewcode:setup-status upgrade - FAQ