FAQ
Common questions about Blueprint Deck Kit.
Do I need to install anything else?
No. The skill is a folder of instructions, the engine and references; the installer only copies files. Your agent writes the diagram, and the result is a plain HTML file that opens in any browser. No runtime, build tool or account is needed. (If Node happens to be installed, the agent also runs an optional check script with it.)
Where does my content go?
Nowhere. Your agent runs locally in your repository with your own subscription, and it reads only the sources your config lists. The generated file makes no network requests: no CDN, no fonts, no analytics. It works offline and from file://.
Can I edit the diagram without the agent?
Yes. Open the file and press E: edit texts, colours, theme and logo, move boxes, and change tabs, tour steps and personas. In Chrome and Edge the changes are saved into the file itself; in other browsers they are kept in the browser and you download the updated file. For bigger changes, ask the agent ("add a persona for the support team").
Can I share it?
It's one HTML file: email it, put it in a shared drive or attach it to a ticket. For a phone-friendly link, upload it to any static host (Cloudflare Pages, GitHub Pages, Netlify, an S3 bucket). Press P for a PDF deck when someone needs slides.
Which agents does it work with?
Any agent that supports Agent Skills (a folder with a SKILL.md), for example Claude Code and Codex. Agents without skill support can still follow SKILL.md as plain instructions: point them at the file.
Will the agent make things up?
The skill tells it not to: every box and area carries sources (file and section), invent: never is the default, and the agent writes an extraction-report.md next to the diagram listing the sources it read, conflicts between them and gaps (things you asked for that the sources don't say). Planned things are marked as planned.
What kinds of diagrams can it make?
Architecture and product blueprints, data flows, processes, customer journeys, ecosystems and org maps (plus a free-form custom type). Each can be written from a product viewpoint (what it does for whom) or a technical one (components, protocols, technology choices), and one file can hold several diagrams with a switcher.
How do I update the diagram when the docs change?
Ask the agent to update it ("update the blueprint deck"). In update mode it re-reads the sources and changes only what the sources changed; edits you made in the browser and boxes marked "locked": true stay as they are.
How do I get a newer engine into an old file?
Install the latest skill and ask the agent to upgrade the file. It copies the new engine and moves your data block into it; your content does not change.
Can I lock a file so nobody edits it?
Set behaviour.editor: false in the config (or settings.editor: false in the data). The ⋯ menu then only offers the PDF export and copying a link.
What does it cost?
Nothing. Blueprint Deck Kit is open source under the MIT licence. Generating a diagram uses your agent, so it counts against your own agent subscription or API usage like any other task. If it saves you time, you can sponsor the project on GitHub, once or monthly.
Something else?
Open an issue on GitHub.