plan-html

🧪 This is an experiment — part of AI Will Replace You.

Stop wasting time on AI. I run practical experiments — real lessons you can use tomorrow, biweekly.

▶ Watch the demo on YouTube · 📖 Read the write-up · ✉️ Subscribe to the newsletter

More on @aiwillreplaceyou

plan-html

Interactive decision-deck planning. Turn a plan.json into a live HTML deck you work through in the browser — intent cards, decision cards, boundaries, implementation steps and a final-verify "finish line" — answered with buttons or your own words, iterated in rounds until you finalize. Every answer autosaves, so an interrupted session loses nothing.

It pairs with an agent: the agent writes the plan.json, serves it, and answers your questions live; you reshape the plan in the browser (add/edit/strike cards, reorder, ask, grill). The deck is the review surface — not a wall of markdown in a terminal.

A decision card: options, tradeoffs, and a live back-and-forth with the agent right inside the card.	The finish line: a verification loop and the acceptance criteria that prove the plan is done.

Features

• Reshapeable — add, edit, strike and drag-reorder cards, steps, and finish-line rows; your changes are authoritative and ride back to the agent.
• Live answers — ask a card a question and the agent's reply streams back into it (SSE), with the answer written into the plan so it survives a dropped connection.
• Works remotely — serve on your LAN or behind a tunnel; an adaptive polling fallback keeps updates flowing even through proxies that buffer SSE.
• Finalize on your terms — finalize early and let the agent decide what's unanswered (with a confirm), or loop until everything's pinned.
• Autosaves everything — every answer is persisted next to the plan; an interrupted session loses nothing.
• Zero dependencies to run — stdlib Python server, single offline deck.html. No build step, no CDN.

What's here

Path	What it is
serve_plan.py	The server. Renders plan.json into the deck, serves it on 127.0.0.1, autosaves answers, streams plan changes over SSE (--live), and prints each round to stdout. Zero dependencies (stdlib only).
templates/deck.html	The deck — a single self-contained, offline HTML file, hand-edited. Its JavaScript is organized into a few labeled top-level <script> blocks that run in document order and share one global scope. No build step, no modules, no CDN.
scripts/lint-deck.js	Extracts the deck's inline <script> blocks into a temp file and runs ESLint over them.
tests/	tests/e2e (pytest HTTP + Playwright browser).

Install

plan-html is a Claude Code skill — install it once and your agent invokes it whenever you ask to plan something interactively.

Option A — plugin marketplace (easiest):

/plugin marketplace add DoryZi/plan-html
/plugin install plan-html

Restart Claude Code, then just ask it to plan a feature — it picks up /plan-html automatically.

Option B — clone into your skills directory:

# user-level (available in every project)
git clone https://github.com/DoryZi/plan-html ~/.claude/skills/plan-html

# or project-level (just this repo)
git clone https://github.com/DoryZi/plan-html .claude/skills/plan-html

Claude Code auto-discovers any skill under .claude/skills/, so /plan-html is available the next time you start it. No build step and nothing to compile — the server is stdlib Python and the deck is a single offline HTML file.

Requirements: Python ≥ 3.10. (Node is only needed to run the dev/lint/test tooling, not to use the skill.)

Want to drive the server by hand, without an agent? Skip straight to Quick start.

Quick start

# serve a plan (no Node needed to run — the deck is a single offline HTML file)
python3 serve_plan.py --plan /abs/path/to/plan.json --live

The deck opens in your browser. Work through the cards; answers autosave to answers.json next to the plan. Click Send to agent to ship a round, or Finalize when you're done.

Phone / remote access

python3 serve_plan.py --plan plan.json --host 0.0.0.0   # LAN
# or expose a running deck publicly with a tunnel:
cloudflared tunnel --url http://localhost:<port>