Architecture Presenter
A portable Copilot CLI plugin for evidence-backed architecture build-ups. It carries the presenter engine, not any project's architecture or cloud access.
copilot plugin install timschps/architecture-presenter
In a new session, ask:
Create an architecture presenter for this project using the fixed-overview standard.
Or:
Build independent architecture, delivery and engineering-learnings journeys, with NFR principles and source evidence.
The skill inspects the current project, replaces starter content with verified
components and handoffs, and generates a standalone architecture\presenter.html.
No server, CDN, runtime MCP, cloud credentials or PowerPoint installation is
required to generate or present it.
Standard
- Fixed camera and stable component positions through reveals.
- Responsibility boundaries visible from the first reveal.
- Concrete components and typed artifact/data/identity handoffs.
- Principle, value, trade-off and evidence limits accompany each reveal.
- Implemented, foundation, external and target states remain explicit.
- Microsoft Fluent exploration and a separate deck-inspired stage skin.
- Manual-only zoom, contextual evidence, clicker controls, blackout and fullscreen.
- Offline HTML plus SVG and editable Excalidraw companions.
The included stage colors were extracted from an owner-supplied BRK285 reference: slate blue, cyan, magenta, purple and blue. No slide content, images, fonts or presentation file is distributed. A new deck can override project-local theme tokens without changing the engine or other projects.
Project-local generation
The skill's bootstrap copies the reusable engine and starter into a project. Existing output directories are refused, never overwritten.
python <installed-skill>\scripts\init.py --project-root . --name "Project architecture"
python architecture\build.py --input architecture\story.json --project-root . --output architecture
The engine accepts JSON, not executable project plugins. The starter explicitly uses synthetic target components and is not an architecture assessment. Replace it with project evidence before delivery. Read the skill's data contract.
Updates to the installed plugin do not silently rewrite project-local snapshots. Review engine/theme changes before copying them into an existing project.
Validation
python -m unittest discover -s tests -v
npm ci
npm test
Browser tests need Microsoft Edge on Windows, or Playwright Chromium installed
with npx playwright install chromium elsewhere. They open generated files
offline and verify stable screen coordinates, reveals, manual zoom, escaping,
source links, navigation, blackout and multiple viewports. Simulated keys do
not replace actual clicker rehearsal.
This plugin has no hooks, agents, MCP servers, telemetry or automatic deployment. It is a private reusable implementation, not a Microsoft-endorsed product.
The engine was generalized from the owner's architecture-presenter work in Superagents, which in turn used the owner's AIDC presenter foundation. Only reusable controls/rendering and extracted theme tokens were copied; source projects and supplied presentation files are not moved or changed.