andreiverdes/bluedoc

bluedoc

An agent skill for engineering docs, plans, code reviews, UI designs, slide decks, website reviews, app icons and app store listings. The agent writes one JSON file, plus small HTML fragments for screens and SVG layers for icons; a local server renders it as a page. You tick checklists, pick options, comment on any element and approve or send back; your answers and change requests go to the agent, and each revision can be compared with the last. Works with Claude Code, Codex, pi, omp, Copilot CLI and Antigravity CLI.

bluedoc 1.0 is tested on macOS; Linux and Windows are untested. Issues and feedback are welcome on GitHub.

Doc types

| Type | What it's for | Page | | |---|---|---|---| | docs | Architecture pages, walkthroughs, runbooks, setup guides, change proposals | docs | <img src="docs/media/docs-hero.webp" width="240" alt="The Acme orders doc"> | | plan | A plan you approve or send back before the agent writes code | plan | <img src="docs/media/plan-hero.webp" width="240" alt="The Acme saved carts plan"> | | review | Review findings pinned to their lines from git, one decision per finding | review | <img src="docs/media/review-hero.webp" width="240" alt="The Acme review findings"> | | design | UI screens on a board and app icons | design | <img src="docs/media/design-hero.webp" width="240" alt="The Acme Fit design board"> | | website | A site's pages, live from its dev server: comment on sections, pick versions in place, each comment names the source to edit | website | [<img src="docs/med