Skip to content

Add create-book standalone plugin#34

Open
sapanparikh18 wants to merge 3 commits intomainfrom
feature/create-book
Open

Add create-book standalone plugin#34
sapanparikh18 wants to merge 3 commits intomainfrom
feature/create-book

Conversation

@sapanparikh18
Copy link
Copy Markdown
Contributor

Summary

  • New standalone plugin that analyzes source code and produces a comprehensive technical book with an Astro website
  • Originally created as a bee command, extracted into its own plugin since it has zero dependency on bee's workflow (no state tracking, agents, skills, or triage)
  • Serves a different audience (anyone documenting a codebase) with its own 7-phase workflow

What it does

/create-book:create-book <source-dir> runs:

  1. Exploration — Parallel agents analyze each subsystem
  2. Audience & Positioning — Define the core thesis
  3. Structure — Organize into parts/chapters, get approval, scaffold Astro site
  4. Writing — Narrative prose with pseudocode and mermaid diagrams
  5. Editorial Review — Review agents evaluate quality
  6. Revision — Apply feedback in one pass
  7. Source Code Audit — Ensure no verbatim code

Output

  • book/docs/ — Markdown chapters (300-800 lines each, "Apply This" patterns)
  • book/web/ — Astro website with dark/light theme, mermaid diagram zoom, chapter navigation

Plugin structure

create-book/
  .claude-plugin/plugin.json
  commands/create-book.md
  templates/              # Astro site boilerplate
  CLAUDE.md

Test plan

  • Install plugin: claude --plugin-dir create-book/
  • Run /create-book:create-book on a small codebase
  • Verify prompt is displayed and fine-tuning question appears
  • Verify book/docs/ and book/web/ are created after outline approval
  • Verify cd book/web && bun run dev serves the site

🤖 Generated with Claude Code

sapanparikh18 and others added 3 commits April 14, 2026 21:40
…ce code

Introduces a new command that analyzes a codebase and produces a comprehensive
technical book with a polished Astro website. The command orchestrates 7 phases
(exploration, positioning, structure, writing, review, revision, source audit)
and outputs markdown chapters to book/docs/ with a web reader in book/web/.

Includes reusable Astro templates adapted from the litellm-book reference site
with dark/light theme, mermaid diagram zoom, and data-driven navigation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Create-book has no dependency on bee's workflow (no state tracking, agents,
skills, or triage). It serves a different audience (anyone documenting a
codebase) with its own 7-phase workflow and Astro templates. Cleaner as
an independent plugin with its own release cycle.

- Move command and templates from bee/ to create-book/
- Add plugin.json manifest and CLAUDE.md
- Remove create-book entry from bee's CLAUDE.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@sapanparikh18 sapanparikh18 requested a review from a team April 21, 2026 12:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants