Files

920 lines
63 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Plan2Code: plan it, approve it, let it build</title>
<meta name="description" content="Plan2Code is a spec-driven workflow for AI coding agents, and a desktop app that puts the plan, your agent and every sign-off in one window. What you decide lands in your repo as plain files.">
<meta name="color-scheme" content="dark">
<meta name="theme-color" content="#0b2150">
<meta property="og:title" content="Plan2Code: plan it, approve it, let it build">
<meta property="og:description" content="A spec-driven workflow for AI coding agents, and a desktop app that puts the plan, your agent and every sign-off in one window.">
<meta property="og:image" content="https://plan2code.jparkerweb.com/banner.jpg">
<link rel="icon" href="favicon.ico" sizes="32x32">
<link rel="icon" type="image/png" sizes="32x32" href="favicon.png">
<link rel="icon" href="favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="apple-touch-icon.png">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Archivo:wdth,wght@62..125,300..900&family=Martian+Mono:wght@300..600&display=swap" rel="stylesheet">
<script>document.documentElement.className += " js"</script>
<style>
/* The page is a blueprint: cyanotype blue, chalk-white line work, one highlighter
yellow for the moments that are yours (your move, your sign-off). The app window
keeps the product's own warm dark palette, so it reads as the built thing lying
on the drawing. */
:root {
--bp-950: #071634;
--bp-900: #0b2150;
--bp-800: #10306f;
--bp-700: #1a4596;
--bp-500: #4f7fd6;
--chalk: #eef4ff;
--chalk-2: #b9cbee;
--chalk-3: #86a0d2;
--line: rgba(170, 200, 255, 0.13);
--line-2: rgba(170, 200, 255, 0.3);
--mark: #ffd45e;
--ok: #7ee0a5;
/* The app's own palette (src/web-console tokens, dark). */
--a-bg: #171513;
--a-panel: #201d1a;
--a-panel-2: #262220;
--a-rule: #332e29;
--a-rule-2: #46403a;
--a-ink: #f0ece5;
--a-ink-2: #b6afa3;
--a-accent: #619fe5;
--a-ok: #74c28f;
--a-warn: #e0a24a;
--a-term: #0f0d0c;
--sans: "Archivo", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
--mono: "Martian Mono", ui-monospace, SFMono-Regular, "Cascadia Mono", Menlo, Consolas, monospace;
--w: 1200px;
--gutter: 28px;
}
* { box-sizing: border-box; }
html { scroll-behavior: smooth; scroll-padding-top: 72px; }
body {
margin: 0;
color: var(--chalk);
background-color: var(--bp-900);
background-image:
linear-gradient(var(--line) 1px, transparent 1px),
linear-gradient(90deg, var(--line) 1px, transparent 1px),
linear-gradient(rgba(170, 200, 255, 0.05) 1px, transparent 1px),
linear-gradient(90deg, rgba(170, 200, 255, 0.05) 1px, transparent 1px);
background-size: 120px 120px, 120px 120px, 24px 24px, 24px 24px;
background-position: -1px -1px;
font: 400 17px/1.6 var(--sans);
-webkit-font-smoothing: antialiased;
overflow-wrap: break-word;
}
img { max-width: 100%; height: auto; }
a { color: var(--chalk); text-underline-offset: 4px; text-decoration-color: var(--chalk-3); }
a:hover { text-decoration-color: var(--mark); }
code, kbd { font-family: var(--mono); font-size: 0.8em; }
:focus-visible { outline: 2px solid var(--mark); outline-offset: 3px; border-radius: 3px; }
h1, h2, h3 { margin: 0; font-family: var(--sans); }
h2 {
font-size: clamp(2rem, 4.6vw, 3.5rem);
font-weight: 800;
font-stretch: 118%;
line-height: 1.02;
letter-spacing: -0.02em;
max-width: 18ch;
}
h3 { font-size: 1.2rem; font-weight: 700; font-stretch: 108%; line-height: 1.25; }
p { margin: 0; }
.wrap { max-width: var(--w); margin: 0 auto; padding: 0 var(--gutter); }
.lede { color: var(--chalk-2); font-size: 1.15rem; max-width: 58ch; margin-top: 20px; }
.skip { position: absolute; left: -9999px; top: 0; background: var(--chalk); color: var(--bp-900); padding: 10px 16px; z-index: 30; }
.skip:focus { left: 0; }
.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
.sheet { padding: 120px 0; border-top: 1px solid var(--line-2); background: var(--bp-900); }
.sheet.deep { background: var(--bp-950); }
.fig-note { margin-top: 14px; color: var(--chalk-3); font: 400 11.5px/1.6 var(--mono); }
/* Planny. The star eye is always the highlight color. */
.planny { display: block; width: 44px; height: 60px; overflow: visible; flex: none; color: var(--chalk); --shell: var(--bp-800); --star: var(--mark); }
/* The parts are styled without a .planny ancestor: most Plannys are <use> copies, and a
selector cannot reach from the copy into the shared drawing, but inherited values can. */
.shell { fill: var(--shell); stroke: currentColor; stroke-width: 1.3; }
.smile, .arm path { fill: none; stroke: currentColor; stroke-linecap: round; }
.smile { stroke-width: 0.9; }
.arm path { stroke-width: 1.2; }
.arm circle, .foot { fill: currentColor; }
.eye { fill: var(--star); transform-box: fill-box; transform-origin: center; }
.planny g.arms > g { display: none; }
.planny[data-mood="rest"] .a-down, .planny[data-mood="work"] .a-down,
.planny[data-mood="wave"] .a-down-l, .planny[data-mood="wave"] .a-wave,
.planny[data-mood="up"] .a-up { display: inline; }
.planny .a-wave { transform-box: view-box; transform-origin: 19px 16.5px; animation: wave 1s ease-in-out infinite alternate; }
.planny[data-mood="work"] .eye { animation: spin 4s linear infinite; }
@keyframes wave { from { transform: rotate(-8deg); } to { transform: rotate(20deg); } }
@keyframes spin { to { transform: rotate(360deg); } }
/* Top bar. */
.nav { position: sticky; top: 0; z-index: 20; background: rgba(11, 33, 80, 0.86); backdrop-filter: blur(10px); -webkit-backdrop-filter: blur(10px); border-bottom: 1px solid var(--line-2); }
.nav .wrap { display: flex; align-items: center; gap: 28px; min-height: 60px; }
.brand { display: inline-flex; align-items: center; gap: 10px; font-weight: 800; font-stretch: 118%; font-size: 1.05rem; letter-spacing: -0.01em; text-decoration: none; }
.brand .planny { width: 20px; height: 27px; }
.nav nav { display: flex; gap: 24px; margin-left: auto; font-size: 15px; }
.nav nav a { text-decoration: none; color: var(--chalk-2); padding: 8px 0; }
.nav nav a:hover { color: var(--chalk); }
.btn { display: inline-flex; align-items: center; justify-content: center; gap: 8px; min-height: 46px; padding: 0 22px; border-radius: 4px; border: 1.5px solid var(--chalk); font: 700 16px var(--sans); font-stretch: 108%; text-decoration: none; cursor: pointer; }
.btn.solid { background: var(--mark); border-color: var(--mark); color: var(--bp-950); }
.btn.solid:hover { background: #ffe08a; border-color: #ffe08a; }
.btn.line { background: transparent; color: var(--chalk); }
.btn.line:hover { background: rgba(238, 244, 255, 0.08); }
.nav .btn { min-height: 38px; padding: 0 16px; font-size: 14.5px; }
/* Hero. The outlined line is the drawing, the solid line is the build. */
.hero { position: relative; padding: 84px 0 96px; overflow: hidden; }
.hero::before { content: ""; position: absolute; inset: 0; background: radial-gradient(ellipse 70% 46% at 50% 68%, rgba(79, 127, 214, 0.4), transparent 70%); pointer-events: none; }
.hero .wrap { position: relative; }
.hero h1 {
font-size: clamp(2.1rem, 8.1vw, 7.6rem);
font-weight: 900;
font-stretch: 125%;
line-height: 0.9;
letter-spacing: -0.035em;
}
.hero h1 span { display: block; }
.hero h1 .drawn { color: transparent; -webkit-text-stroke: 1.5px var(--chalk); }
@supports not (-webkit-text-stroke: 1px white) { .hero h1 .drawn { color: var(--chalk-2); } }
.hero-foot { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 24px 48px; align-items: end; margin-top: 32px; }
.hero-foot .lede { margin-top: 0; }
.cta { display: flex; flex-wrap: wrap; gap: 12px; }
/* The stage: dimension lines, the app window, the four moments of a session. */
.stage { position: relative; max-width: 1320px; margin: 64px auto 0; padding: 0 var(--gutter); }
.win { position: relative; background: var(--a-panel); color: var(--a-ink); border-radius: 10px; overflow: hidden; box-shadow: 0 0 0 1px rgba(238, 244, 255, 0.28), 0 40px 90px rgba(3, 10, 30, 0.7), 0 8px 24px rgba(3, 10, 30, 0.5); font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; }
.titlebar { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 7px 12px; background: var(--a-panel-2); border-bottom: 1px solid var(--a-rule); font-size: 12.5px; color: var(--a-ink-2); }
.titlebar .t { display: flex; align-items: center; gap: 8px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.titlebar .planny { width: 11px; height: 15px; color: var(--a-ink-2); --shell: var(--a-panel); --star: var(--a-accent); }
.wc { display: flex; gap: 16px; flex: none; }
.wc span { display: block; width: 10px; height: 10px; border: 1px solid var(--a-ink-2); border-radius: 2px; opacity: 0.6; }
.wc span:first-child { height: 0; border-width: 1px 0 0; align-self: flex-end; border-radius: 0; }
.appbar { display: flex; flex-wrap: wrap; align-items: center; gap: 10px; padding: 8px 12px; border-bottom: 1px solid var(--a-rule); font-size: 13.5px; background: var(--a-panel); }
.chip { display: inline-flex; align-items: center; gap: 7px; padding: 5px 11px; border: 1px solid var(--a-rule-2); border-radius: 7px; background: var(--a-bg); font-weight: 500; }
.chip svg { width: 14px; height: 14px; stroke: var(--a-ink-2); fill: none; stroke-width: 1.6; }
.ns { padding: 6px 13px; border-radius: 7px; background: var(--a-accent); color: #0c1117; font-weight: 600; }
.appbar .sp { flex: 1; }
.agent { display: inline-flex; align-items: center; gap: 8px; padding: 5px 11px; border: 1px solid var(--a-rule-2); border-radius: 7px; background: var(--a-bg); }
.agent b { font-weight: 500; }
.agent small { color: var(--a-ink-2); font-size: 12.5px; }
.adot { width: 9px; height: 9px; border-radius: 50%; background: var(--a-ok); flex: none; }
.badge { padding: 1px 8px; border-radius: 99px; border: 1px solid var(--a-warn); color: var(--a-warn); font-size: 11.5px; font-weight: 600; }
.wbody { display: grid; grid-template-columns: minmax(0, 1fr) clamp(250px, 28%, 350px); background: var(--a-bg); }
.stage[data-dock="bottom"] .wbody { grid-template-columns: minmax(0, 1fr); }
.surface { position: relative; aspect-ratio: 16 / 10; overflow: hidden; background: var(--a-bg); min-width: 0; }
.stage[data-dock="bottom"] .surface { aspect-ratio: 16 / 7.4; }
.surface img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; object-position: top left; opacity: 0; transition: opacity 0.5s ease; }
.surface img.on { opacity: 1; }
.stamp { position: absolute; right: 9%; top: 40%; padding: 10px 20px 8px; border: 3px solid var(--mark); border-radius: 6px; color: var(--mark); font: 800 clamp(15px, 2.2vw, 28px)/1.1 var(--sans); font-stretch: 122%; letter-spacing: 0.02em; background: rgba(23, 21, 19, 0.82); transform: rotate(-7deg) scale(1.6); opacity: 0; pointer-events: none; }
.stamp small { display: block; font: 400 11px/1.6 var(--mono); letter-spacing: 0; color: var(--a-ink-2); }
.stamp.on { opacity: 1; transform: rotate(-7deg) scale(1); transition: transform 0.22s cubic-bezier(0.2, 1.4, 0.4, 1), opacity 0.12s; }
.term { display: flex; flex-direction: column; min-width: 0; min-height: 0; background: var(--a-term); border-left: 1px solid var(--a-rule); }
.stage[data-dock="bottom"] .term { border-left: 0; border-top: 1px solid var(--a-rule); height: 190px; }
.th { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 6px 10px; background: rgba(255, 255, 255, 0.06); border-bottom: 1px solid rgba(255, 255, 255, 0.08); font-size: 12px; color: #a39b8e; }
.seg { display: none; border: 1px solid rgba(255, 255, 255, 0.22); border-radius: 6px; overflow: hidden; }
html.js .seg { display: inline-flex; }
.seg button { font: 500 12px ui-sans-serif, system-ui, sans-serif; padding: 4px 10px; background: transparent; color: var(--a-ink); border: 0; cursor: pointer; }
.seg button + button { border-left: 1px solid rgba(255, 255, 255, 0.22); }
.seg button[aria-pressed="true"] { background: var(--a-accent); color: #0c1117; }
.seg button:focus-visible { outline-offset: -2px; }
.tb { flex: 1; min-height: 0; margin: 0; padding: 12px; overflow: hidden; font: 400 11.5px/1.75 var(--mono); white-space: pre-wrap; word-break: break-word; display: flex; flex-direction: column; justify-content: flex-end; color: var(--a-ink); }
.tb .d { color: #a39b8e; }
.tb .g { color: #7fd29a; }
.tb .b { color: #8fb8f0; }
.tb .y { color: var(--mark); }
.cur { display: inline-block; width: 7px; height: 13px; background: var(--a-ink); vertical-align: -2px; animation: blink 1.1s steps(1) infinite; }
@keyframes blink { 50% { opacity: 0; } }
.status { display: flex; align-items: center; gap: 10px; padding: 6px 12px; border-top: 1px solid var(--a-rule); background: var(--a-panel); font-size: 13px; color: var(--a-ink-2); min-height: 44px; }
.status .planny { width: 18px; height: 25px; color: var(--a-ink-2); --shell: var(--a-panel); --star: var(--a-accent); }
/* The one orchestrated moment: the window is drafted as line work, then built. */
.draft { position: absolute; inset: 0; width: 100%; height: 100%; z-index: 3; pointer-events: none; opacity: 0; }
.draft path { fill: none; stroke: var(--chalk); stroke-width: 1.25; vector-effect: non-scaling-stroke; }
@media (prefers-reduced-motion: no-preference) {
.win { animation: sheet 2.2s ease both; }
.win > :not(.draft) { animation: build 2.3s ease both; }
.draft { animation: ink 2.3s cubic-bezier(0.6, 0, 0.2, 1) both; }
}
@keyframes sheet { 0%, 55% { background: rgba(16, 48, 111, 0.55); } 100% { background: var(--a-panel); } }
@keyframes build { 0%, 55% { opacity: 0; } 100% { opacity: 1; } }
@keyframes ink { 0% { opacity: 1; clip-path: inset(0 100% 0 0); } 45% { clip-path: inset(0 0 0 0); } 60% { opacity: 1; } 100% { opacity: 0; clip-path: inset(0 0 0 0); } }
.moments { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); margin: 22px 0 0; padding: 0; list-style: none; border-left: 1px solid var(--line-2); }
.moments li { border-right: 1px solid var(--line-2); }
.moments button { position: relative; display: block; width: 100%; height: 100%; padding: 16px 18px 14px; background: transparent; border: 0; color: var(--chalk-2); text-align: left; font: 400 14.5px/1.45 var(--sans); cursor: pointer; }
.moments button::before { content: ""; position: absolute; left: 0; top: 0; height: 3px; width: 0; background: var(--mark); }
.moments button strong { display: block; color: var(--chalk); font-size: 1.05rem; font-weight: 700; font-stretch: 108%; margin-bottom: 2px; }
.moments button:hover { background: rgba(238, 244, 255, 0.05); }
.moments button[aria-pressed="true"] { background: rgba(238, 244, 255, 0.07); }
.moments button[aria-pressed="true"]::before { width: 100%; }
.moments.auto button[aria-pressed="true"]::before { animation: fill var(--beat, 6s) linear both; }
@keyframes fill { from { width: 0; } to { width: 100%; } }
html:not(.js) .moments button { cursor: default; }
/* The app, in four details. Line drawings, not screenshots. */
.head-row { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 24px 64px; align-items: end; }
.head-row .lede { margin-top: 0; }
.details { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); margin: 72px 0 0; padding: 0; list-style: none; border-top: 1px solid var(--line-2); }
.details li { padding: 28px 28px 8px 0; }
.details li + li { padding-left: 28px; border-left: 1px solid var(--line-2); }
.details svg { display: block; width: 100%; max-width: 200px; height: auto; margin-bottom: 20px; overflow: visible; }
.details svg * { fill: none; stroke: var(--chalk-2); stroke-width: 1.25; stroke-linecap: round; stroke-linejoin: round; }
.details svg .hi { stroke: var(--mark); }
.details svg .hi-fill { fill: var(--mark); stroke: none; }
.details svg .soft { stroke-dasharray: 3 4; stroke: var(--chalk-3); }
.details svg text { fill: var(--chalk-2); stroke: none; font: 400 8px var(--mono); }
.details p { color: var(--chalk-2); font-size: 15.5px; margin-top: 8px; }
/* The Implementation Loop. */
.loop-grid { display: grid; grid-template-columns: minmax(0, 4fr) minmax(0, 8fr); gap: 56px 64px; align-items: start; margin-top: 8px; }
.loop-copy h2 { max-width: 12ch; }
.facts { margin: 36px 0 0; padding: 0; list-style: none; border-top: 1px solid var(--line-2); }
.facts li { padding: 16px 0; border-bottom: 1px solid var(--line-2); color: var(--chalk-2); font-size: 15.5px; }
.facts strong { display: block; color: var(--chalk); font-size: 1.02rem; font-stretch: 108%; }
.loopwin { background: var(--a-bg); color: var(--a-ink); border-radius: 10px; overflow: hidden; box-shadow: 0 0 0 1px rgba(238, 244, 255, 0.22), 0 30px 70px rgba(2, 8, 24, 0.7); font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; }
.banner { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 16px; padding: 12px 16px; background: #1a2533; border-bottom: 1px solid #3d5978; font-size: 14px; }
.banner b { font-weight: 600; }
.banner .pips { display: inline-flex; gap: 5px; }
.banner .pips i { width: 22px; height: 6px; border-radius: 3px; background: #3d5978; }
.banner .pips i.done { background: var(--a-ok); }
.banner .pips i.now { background: var(--a-accent); animation: pulse 1.2s ease-in-out infinite alternate; }
@keyframes pulse { to { opacity: 0.45; } }
.banner .el { margin-left: auto; color: var(--a-ink-2); font: 400 12px var(--mono); }
.banner .stop { padding: 4px 10px; border: 1px solid var(--a-rule-2); border-radius: 6px; font-size: 12.5px; color: var(--a-ink-2); }
.ledger-scroll { overflow-x: auto; }
.ledger th:first-child { padding-left: 16px; }
.ledger { width: 100%; min-width: 560px; border-collapse: collapse; font-size: 13.5px; }
.ledger th, .ledger td { padding: 13px 10px; text-align: left; border-bottom: 1px solid var(--a-rule); vertical-align: top; }
.ledger thead th { font-weight: 500; font-size: 12.5px; color: var(--a-ink-2); background: var(--a-panel); }
.ledger tbody th { font-weight: 600; white-space: nowrap; }
.ledger tbody th small { display: block; font-weight: 400; color: var(--a-ink-2); font-size: 12.5px; }
.ledger td { font-family: var(--mono); font-size: 11.5px; line-height: 1.7; color: var(--a-ink-2); white-space: nowrap; }
.ledger td[data-s="done"] { color: #7fd29a; }
.ledger td[data-s="done"]::before { content: "\2713\00a0"; }
.ledger td[data-s="now"] { color: var(--a-ink); }
.ledger td[data-s="now"]::before { content: ""; display: inline-block; width: 7px; height: 7px; margin-right: 7px; border-radius: 50%; background: var(--a-accent); animation: pulse 0.7s ease-in-out infinite alternate; }
.ledger td[data-s="wait"] { opacity: 0.4; }
.ledger .str { display: inline-block; padding: 0 8px; border: 1px solid var(--a-rule-2); border-radius: 99px; font: 500 11.5px/1.7 ui-sans-serif, system-ui, sans-serif; color: var(--a-ink); }
.ping { display: grid; grid-template-columns: 4px minmax(0, 1fr); gap: 0 14px; margin: 16px; padding: 12px 14px 12px 0; background: var(--a-panel); border: 1px solid var(--a-rule); border-radius: 8px; font-size: 13.5px; overflow: hidden; }
.ping::before { content: ""; background: var(--a-ok); margin: -12px 0; }
.ping b { display: block; }
.ping span { color: var(--a-ink-2); }
.stops { margin-top: 48px; padding-top: 24px; border-top: 1px solid var(--line-2); }
.stops h3 { margin-bottom: 18px; max-width: 46ch; }
.stops ul { margin: 0; padding: 0; list-style: none; columns: 2; column-gap: 40px; color: var(--chalk-2); font-size: 15.5px; }
.stops li { break-inside: avoid; padding: 0 0 10px 22px; position: relative; }
.stops li::before { content: ""; position: absolute; left: 0; top: 0.55em; width: 10px; height: 10px; border: 1.5px solid var(--mark); }
/* The workflow underneath. */
.pipe { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); margin: 72px 0 0; padding: 0; list-style: none; }
.pipe li { position: relative; padding: 0 18px 0 0; }
.pipe li::before { content: ""; position: absolute; left: 0; right: 0; top: 17px; border-top: 1.5px solid var(--chalk); }
.pipe li.opt::before { border-top-style: dashed; border-color: var(--chalk-3); }
.pipe li:last-child::before { right: auto; width: 36px; }
.pipe .n { position: relative; display: grid; place-items: center; width: 36px; height: 36px; border: 1.5px solid var(--chalk); border-radius: 50%; background: var(--bp-950); font: 600 13px var(--mono); }
.pipe li.opt .n { border-style: dashed; border-color: var(--chalk-3); color: var(--chalk-2); }
.pipe h3 { margin-top: 18px; }
.pipe h3 small { font: 400 11.5px var(--mono); color: var(--chalk-3); margin-left: 4px; }
.pipe p { color: var(--chalk-2); font-size: 14.5px; line-height: 1.5; margin-top: 6px; }
.pipe code { display: block; margin-top: 12px; color: var(--mark); font-size: 10.5px; line-height: 1.6; }
.pipe .out { display: block; margin-top: 4px; color: var(--chalk-3); font: 400 10.5px/1.6 var(--mono); }
.under { display: grid; grid-template-columns: minmax(0, 5fr) minmax(0, 7fr); gap: 48px 64px; margin-top: 88px; }
.under h3 { font-size: 1.45rem; font-weight: 800; font-stretch: 115%; letter-spacing: -0.01em; }
.under h3 + p { color: var(--chalk-2); margin-top: 10px; font-size: 15.5px; }
.tree { margin: 22px 0 0; padding: 20px 22px; border: 1px solid var(--line-2); border-radius: 6px; background: rgba(7, 22, 52, 0.6); font: 400 12px/1.95 var(--mono); color: var(--chalk-2); overflow-x: auto; white-space: pre; }
.tree b { color: var(--chalk); font-weight: 500; }
.tree .x { color: var(--ok); }
.tree .w { color: var(--mark); }
.tree .c { color: var(--chalk-3); }
.skills { margin: 22px 0 0; padding: 0; list-style: none; display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0 40px; border-top: 1px solid var(--line-2); }
.skills li { padding: 12px 0; border-bottom: 1px solid var(--line-2); font-size: 14.5px; line-height: 1.45; color: var(--chalk-2); }
.skills code { display: block; color: var(--chalk); font-size: 11.5px; margin-bottom: 3px; }
.agents { margin-top: 28px; color: var(--chalk-2); font-size: 15.5px; max-width: 72ch; }
/* The rules. */
.rules { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); margin: 64px 0 0; padding: 0; list-style: none; border-top: 1px solid var(--line-2); }
.rules li { padding: 36px 48px 36px 0; border-bottom: 1px solid var(--line-2); }
.rules li:nth-child(even) { padding-left: 48px; padding-right: 0; border-left: 1px solid var(--line-2); }
.rules h3 { font-size: clamp(1.45rem, 2.6vw, 2.1rem); font-weight: 800; font-stretch: 118%; line-height: 1.08; letter-spacing: -0.015em; max-width: 18ch; }
.rules p { margin-top: 14px; color: var(--chalk-2); max-width: 52ch; }
/* More of the page: real screenshots. */
.shots { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 48px 40px; margin: 64px 0 0; }
.shots figure { margin: 0; }
.shots img { display: block; width: 100%; border-radius: 8px; box-shadow: 0 0 0 1px rgba(238, 244, 255, 0.22), 0 24px 60px rgba(2, 8, 24, 0.6); }
.shots figcaption { margin-top: 16px; color: var(--chalk-2); font-size: 15.5px; max-width: 56ch; }
.shots figcaption strong { color: var(--chalk); }
.aside { margin-top: 56px; display: flex; gap: 18px; align-items: center; color: var(--chalk-2); max-width: 70ch; }
.aside .planny { width: 34px; height: 46px; }
/* Install. */
.install { padding: 120px 0 104px; border-top: 1px solid var(--line-2); }
.install-grid { display: grid; grid-template-columns: minmax(0, 5fr) minmax(0, 7fr); gap: 48px 64px; align-items: start; }
.before { border: 1px solid var(--line-2); border-radius: 6px; background: rgba(7, 22, 52, 0.7); padding: 22px 24px; font-size: 15.5px; }
.before h3 { margin-bottom: 10px; }
.before ul { margin: 0; padding-left: 20px; color: var(--chalk-2); }
.before li { margin: 8px 0; }
.before strong { color: var(--chalk); }
.cmd { display: flex; align-items: center; gap: 12px; margin-top: 20px; padding: 10px 10px 10px 16px; background: var(--bp-950); border: 1.5px solid var(--chalk); border-radius: 6px; }
.cmd pre { flex: 1; min-width: 0; margin: 0; overflow-x: auto; font: 400 11.5px/1.6 var(--mono); white-space: pre; color: var(--chalk); }
.cmd pre span { color: var(--mark); user-select: none; }
.copy { flex: none; min-height: 40px; padding: 0 16px; border: 0; border-radius: 4px; background: var(--mark); color: var(--bp-950); font: 700 14px var(--sans); cursor: pointer; }
.copy:hover { background: #ffe08a; }
.after { margin: 20px 0 0; padding: 0; list-style: none; color: var(--chalk-2); font-size: 15.5px; }
.after li { padding: 14px 0; border-top: 1px solid var(--line-2); }
.after strong { color: var(--chalk); }
footer { border-top: 1px solid var(--line-2); padding: 28px 0 36px; color: var(--chalk-2); font-size: 14.5px; background: var(--bp-950); }
footer .wrap { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 28px; }
footer .brand { margin-right: auto; }
@media (max-width: 1020px) {
.details { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.details li:nth-child(3) { padding-left: 0; border-left: 0; }
.details li:nth-child(n+3) { border-top: 1px solid var(--line-2); }
.loop-grid, .under, .install-grid, .head-row { grid-template-columns: minmax(0, 1fr); }
.pipe { grid-template-columns: minmax(0, 1fr); gap: 0; }
.pipe li { padding: 0 0 28px 56px; }
.pipe li::before, .pipe li:last-child::before { left: 17px; right: auto; top: 0; bottom: 0; width: 0; border-top: 0; border-left: 1.5px solid var(--chalk); }
.pipe li.opt::before { border-left-style: dashed; border-color: var(--chalk-3); }
.pipe li:last-child::before { bottom: auto; height: 20px; }
.pipe .n { position: absolute; left: 0; top: 0; }
.pipe h3 { margin-top: 0; padding-top: 5px; }
}
@media (max-width: 820px) {
.nav nav { display: none; }
.nav .btn { margin-left: auto; }
.hero { padding-top: 56px; }
.hero-foot { grid-template-columns: minmax(0, 1fr); }
.wbody { grid-template-columns: minmax(0, 1fr); }
.term { border-left: 0; border-top: 1px solid var(--a-rule); height: 170px; }
.seg { display: none !important; }
.agent small, .badge { display: none; }
.moments { grid-template-columns: repeat(2, minmax(0, 1fr)); border-top: 1px solid var(--line-2); }
.moments li { border-bottom: 1px solid var(--line-2); }
.sheet, .install { padding: 80px 0; }
.rules, .shots, .skills { grid-template-columns: minmax(0, 1fr); }
.rules li, .rules li:nth-child(even) { padding: 28px 0; border-left: 0; }
.stops ul { columns: 1; }
}
@media (max-width: 560px) {
:root { --gutter: 16px; }
body { font-size: 16px; }
.details { grid-template-columns: minmax(0, 1fr); }
.details li, .details li + li { padding: 24px 0 8px; border-left: 0; border-top: 1px solid var(--line-2); }
.details li:first-child { border-top: 0; }
.moments button { padding: 12px 12px 10px; font-size: 13.5px; }
.cmd { flex-direction: column; align-items: stretch; padding: 14px; }
.cmd pre { font-size: 11.5px; }
.brand span { display: none; }
}
@media (prefers-reduced-motion: reduce) {
html { scroll-behavior: auto; }
*, *::before, *::after { transition: none !important; animation: none !important; }
}
</style>
<style>
/* The layout on top of the blueprint: a centered headline, and the app tilted back over one light. */
:root { --mark-hi:#ffe08a;--light-1:#ffffff;--light-2:#7fa8f0;--nav-bg:rgba(11,33,80,.86); }
/* Concept 11: centered headline, the app tilted back over one light. */
.nav { background: var(--nav-bg); }
.btn.solid:hover, .copy:hover { background: var(--mark-hi); border-color: var(--mark-hi); }
.hero { text-align: center; padding: 88px 0 104px; }
.hero::before { display: none; }
.hero h1 { font-size: clamp(1.5rem, 6.9vw, 6.5rem); }
.hero-foot { display: block; margin-top: 28px; }
.hero-foot .lede { margin: 0 auto; }
.cta { justify-content: center; margin-top: 30px; }
.stage { margin-top: 72px; perspective: 1900px; text-align: left; }
.light { position: absolute; left: -3%; right: -3%; top: -110px; height: 560px; background: radial-gradient(ellipse 50% 50% at 50% 50%, var(--light-1), var(--light-2) 40%, transparent 72%); filter: blur(46px); pointer-events: none; }
.win { transform-origin: 50% 100%; transform: rotateX(var(--tilt, 0deg)); box-shadow: 0 0 0 1px var(--line-2), 0 -18px 70px -10px color-mix(in srgb, var(--light-2) 55%, transparent), 0 40px 90px rgba(0, 0, 0, 0.6); }
.moments, .stage .fig-note { position: relative; }
.tree, .before { background: color-mix(in srgb, var(--bp-950) 70%, transparent); }
.install { position: relative; overflow: hidden; }
.install::before { content: ""; position: absolute; left: 10%; right: 10%; bottom: -330px; height: 460px; background: radial-gradient(ellipse 50% 50% at 50% 50%, var(--light-1), var(--light-2) 40%, transparent 72%); filter: blur(60px); opacity: .5; pointer-events: none; }
.install .wrap { position: relative; }
.install-grid { grid-template-columns: minmax(0, 1fr); gap: 44px; max-width: 920px; }
.install-grid > div:first-child { text-align: center; }
.install-grid h2 { max-width: none; }
.install-grid .lede { margin-left: auto; margin-right: auto; }
@media (prefers-reduced-motion: no-preference) {
.light { animation: lightup 2.2s ease both; }
html.js .win { transition: transform 0.12s linear; }
}
@keyframes lightup { from { opacity: 0; transform: scale(0.7); } }
@media (max-width: 820px) { .hero { padding-top: 56px; } .stage { margin-top: 48px; } .light { height: 380px; top: -70px; } }
.hero h1 { font-weight: 900; font-stretch: 125%; letter-spacing: -0.035em; line-height: 0.94; }
.light { opacity: .8; }
@media (max-width: 560px) { .hero h1 { font-size: 1.75rem; } .hero h1 .drawn { -webkit-text-stroke-width: 1px; } }
</style>
</head>
<body>
<a class="skip" href="#main">Skip to the content</a>
<!-- Planny, drawn once. The status bar's Planny is inline so its mood can change. -->
<svg width="0" height="0" style="position:absolute" aria-hidden="true" focusable="false">
<defs>
<g id="pl-body"><rect class="foot" x="5.7" y="27.1" width="3.6" height="1.7" rx="0.85"/><rect class="foot" x="12.7" y="27.1" width="3.6" height="1.7" rx="0.85"/><rect class="shell" x="3" y="7" width="16" height="20" rx="3.2"/><path class="eye" d="M11 10.95 L11.79 12.91 L13.9 13.06 L12.28 14.42 L12.79 16.47 L11 15.35 L9.21 16.47 L9.72 14.42 L8.1 13.06 L10.21 12.91 Z"/><path class="smile" d="M8.3 18.4 Q11 21 13.7 18.4"/></g>
<g id="pl-down"><g class="arm"><path d="M3 16.5 L1.1 19.3"/><circle cx="1.1" cy="19.3" r="0.85"/></g><g class="arm"><path d="M19 16.5 L20.9 19.3"/><circle cx="20.9" cy="19.3" r="0.85"/></g></g>
<g id="pl-up"><g class="arm"><path d="M3 16.5 L1.1 13.7"/><circle cx="1.1" cy="13.7" r="0.85"/></g><g class="arm"><path d="M19 16.5 L20.9 13.7"/><circle cx="20.9" cy="13.7" r="0.85"/></g></g>
</defs>
</svg>
<header class="nav">
<div class="wrap">
<a class="brand" href="#main" aria-label="Plan2Code, back to the top"><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false"><use href="#pl-body"/><use href="#pl-down"/></svg><span>Plan2Code</span></a>
<nav aria-label="On this page">
<a href="#app">The app</a>
<a href="#loop">The loop</a>
<a href="#workflow">The workflow</a>
<a href="https://github.com/jparkerweb/plan2code">GitHub</a>
</nav>
<a class="btn solid" href="#install">Install</a>
</div>
</header>
<main id="main">
<section class="hero" aria-labelledby="hero-title">
<div class="wrap">
<h1 id="hero-title"><span class="drawn">Plan it. Approve it.</span><span>Let it build.</span></h1>
<div class="hero-foot">
<p class="lede">Plan2Code is a spec-driven workflow for AI coding agents. Its desktop app puts the plan, your agent and every sign-off in one window, and what you decide lands in your repo as plain files.</p>
<div class="cta">
<a class="btn solid" href="#install">Install Plan2Code</a>
<a class="btn line" href="#workflow">See the workflow</a>
</div>
</div>
</div>
<div class="stage" id="stage" data-dock="right">
<div class="light" aria-hidden="true"></div>
<!-- An illustration: the desktop app's window drawn in HTML around real screenshots of its pages. -->
<div class="win" role="group" aria-label="Illustration of the Plan2Code desktop app">
<svg class="draft" viewBox="0 0 100 100" preserveAspectRatio="none" aria-hidden="true">
<path d="M0.2 0.3 H99.8 V99.7 H0.2 Z"/>
<path d="M0 5 H100"/>
<path d="M0 11.5 H100"/>
<path d="M72 11.5 V93"/>
<path d="M0 93 H100"/>
<path d="M14 22 V93"/>
<path d="M17 30 H38 V48 H17 Z"/>
<path d="M17 55 H38 V78 H17 Z"/>
<path d="M41 55 H62 V78 H41 Z"/>
<path d="M75 70 H93 M75 76 H97 M75 82 H88 M75 88 H95"/>
</svg>
<div class="titlebar">
<div class="t"><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false"><use href="#pl-body"/><use href="#pl-down"/></svg>Plan2Code - task-api</div>
<div class="wc" aria-hidden="true"><span></span><span></span><span></span></div>
</div>
<div class="appbar">
<span class="chip"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M1.5 4.5h4.2l1.3 1.5h7.5v7h-13z"/></svg>task-api</span>
<span class="ns">New Session</span>
<span class="sp"></span>
<span class="agent"><span class="adot" aria-hidden="true"></span><b>Claude Code</b><small>opus, high effort</small></span>
<span class="badge">checks off</span>
</div>
<div class="wbody">
<div class="surface" id="surface">
<img class="on" src="screenshots/dashboard-plan-dark.webp" width="2560" height="1600" alt="The Plan2Code dashboard for a new task API project: the steps in order as cards, with the Plan card marked Suggested.">
<img src="screenshots/question-dark.webp" width="2560" height="1600" alt="A Plan question card, How tasks are paged, with three options, the first marked Suggested, each with its trade-off underneath.">
<img src="screenshots/build-dark.webp" width="2560" height="1600" alt="Phase 3 of the task API being built: 5 of 11 done on the progress bar, and the phase's task list with the first five ticked.">
<img src="screenshots/signoff-dark.webp" width="2560" height="1600" alt="The Approve this phase card, with a button to read the completion report and three choices: Review the code first, Approve this phase, and I want changes.">
<div class="stamp" id="stamp" aria-hidden="true">Approved<small>phase 3 of 4, by you</small></div>
</div>
<div class="term">
<div class="th">
<span>Agent terminal</span>
<span class="seg" role="group" aria-label="Dock the terminal">
<button type="button" data-dock="right" aria-pressed="true">Right</button>
<button type="button" data-dock="bottom" aria-pressed="false">Bottom</button>
</span>
</div>
<pre class="tb" id="tb" aria-label="Example agent output"><span class="d">$ plan2code</span>
<span class="g">Plan2Code skills loaded</span>
<span class="b">&gt; /plan2code</span>
<span>Dashboard open in this window</span>
<span class="d">Suggested: Plan</span></pre>
</div>
</div>
<div class="status">
<svg class="planny" id="pl" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="wave"><use href="#pl-body"/><g class="arms"><g class="a-down"><use href="#pl-down"/></g><g class="a-down-l"><g class="arm"><path d="M3 16.5 L1.1 19.3"/><circle cx="1.1" cy="19.3" r="0.85"/></g></g><g class="a-wave"><g class="arm"><path d="M19 16.5 L20.9 13.7"/><circle cx="20.9" cy="13.7" r="0.85"/></g></g><g class="a-up"><use href="#pl-up"/></g></g></svg>
<span id="st">Your move: pick what we are doing today.</span>
</div>
</div>
<ol class="moments" id="moments" aria-label="Four moments of a session">
<li><button type="button" aria-pressed="true"><strong>Pick a card</strong>Every step is a card, and the dashboard suggests the next one.</button></li>
<li><button type="button" aria-pressed="false"><strong>Answer the questions</strong>A few at a time, each option with its trade-off written under it.</button></li>
<li><button type="button" aria-pressed="false"><strong>Watch it build</strong>Tasks tick off in the spec as they land in your code.</button></li>
<li><button type="button" aria-pressed="false"><strong>Sign off</strong>Nothing is marked complete until you approve it.</button></li>
</ol>
<p class="fig-note">Illustration: the app's window drawn around real screenshots of its pages. The terminal lines are an example.</p>
</div>
</section>
<section class="sheet deep" id="app" aria-labelledby="app-title">
<div class="wrap">
<div class="head-row">
<h2 id="app-title">The plan on the left. The agent on the right.</h2>
<p class="lede">The desktop app opens on the dashboard and runs your agent in a terminal panel it owns. Every page of a session opens inside the window: questions, the living plan, the code review, the git board, your notebook. It is a small native app for Windows, macOS and Linux, and it talks to nothing but your own machine.</p>
</div>
<ul class="details">
<li>
<svg viewBox="0 0 160 96" aria-hidden="true"><rect x="8" y="8" width="144" height="80" rx="5"/><path d="M8 22 H152"/><path class="hi" d="M104 22 V88"/><path class="soft" d="M8 62 H104"/><path class="hi" d="M112 34 H140 M112 44 H132 M112 54 H144"/></svg>
<h3>Dock the terminal where you want it</h3>
<p>Right or bottom, collapsed to a strip, or maximized. A badge on a collapsed panel says when the agent may need you.</p>
</li>
<li>
<svg viewBox="0 0 160 96" aria-hidden="true"><rect class="soft" x="8" y="26" width="40" height="44" rx="5"/><path d="M66 30 H88 L94 36 V66 H66 Z"/><path d="M72 44 H88 M72 51 H88 M72 58 H82"/><rect class="hi" x="112" y="26" width="40" height="44" rx="5"/><path d="M52 48 H61 M57 44 L61 48 L57 52"/><path d="M98 48 H107 M103 44 L107 48 L103 52"/></svg>
<h3>New Session, in one click</h3>
<p>The app writes a brief from its own record of the session and starts a fresh agent on it, so a long conversation never gets to go stale.</p>
</li>
<li>
<svg viewBox="0 0 160 96" aria-hidden="true"><rect class="hi" x="20" y="8" width="120" height="20" rx="10"/><circle class="hi-fill" cx="32" cy="18" r="3"/><rect x="20" y="34" width="120" height="20" rx="10"/><rect x="20" y="60" width="120" height="20" rx="10"/><text x="42" y="21">Claude Code</text><text x="42" y="47">Devin</text><text x="42" y="73">Codex</text><path class="soft" d="M80 84 V94 M75 89 H85"/></svg>
<h3>Your agent, your model</h3>
<p>A launch card asks which agent, model and effort to start on. Claude Code, Devin and Codex are built in, and any other agent CLI can be added.</p>
</li>
<li>
<svg viewBox="0 0 160 96" aria-hidden="true"><path d="M8 70 H152"/><rect x="24" y="76" width="14" height="14" rx="3"/><rect x="46" y="76" width="14" height="14" rx="3"/><rect class="hi" x="68" y="76" width="14" height="14" rx="3"/><circle class="hi-fill" cx="83" cy="75" r="4.5"/><rect x="90" y="76" width="14" height="14" rx="3"/><rect class="soft" x="40" y="14" width="80" height="44" rx="5"/></svg>
<h3>It tells you when it is your move</h3>
<p>A dot on the taskbar entry turns green when a question or a sign-off is waiting, so the window can sit behind your other work.</p>
</li>
</ul>
</div>
</section>
<section class="sheet" id="loop" aria-labelledby="loop-title">
<div class="wrap">
<div class="loop-grid">
<div class="loop-copy">
<h2 id="loop-title">Start the loop. Go to lunch.</h2>
<p class="lede">The Implementation Loop builds every remaining phase of a spec, one after another, while you do something else. It lives in the desktop app.</p>
<ul class="facts">
<li><strong>A fresh agent for every phase</strong>A long spec never grows into one tired conversation.</li>
<li><strong>The app decides when a phase counts</strong>It reads the spec's marks, runs your quick check, then makes one local commit. It never pushes.</li>
<li><strong>A model per phase</strong>Thrifty for the boilerplate, Best for the hard part. A phase that crashes gets one retry, one step up.</li>
<li><strong>It reaches you where you are</strong>Discord, Slack, Teams, Google Chat or any webhook, when it waits on you or finishes.</li>
</ul>
</div>
<div>
<!-- An illustration of the loop's banner and its report, with example data. -->
<div class="loopwin" id="loopwin" role="img" aria-label="Illustration of the Implementation Loop on a four-phase spec: phases one and two are built, reviewed, checked and committed, phase three is building, and phase four is waiting.">
<div class="banner">
<span class="pips" id="pips"><i class="done"></i><i class="done"></i><i class="now"></i><i></i></span>
<b id="lb">Building Phase 3 of 4: API endpoints</b>
<span class="el" id="le">run 17m</span>
<span class="stop">Stop after this phase</span>
</div>
<div class="ledger-scroll">
<table class="ledger">
<thead><tr><th scope="col">Phase</th><th scope="col">Runs on</th><th scope="col">Build</th><th scope="col">Review</th><th scope="col">Quick check</th><th scope="col">Commit</th></tr></thead>
<tbody id="ledger">
<tr><th scope="row">1<small>Project setup</small></th><td data-s="keep"><span class="str">Thrifty</span></td><td data-s="done">4 tasks</td><td data-s="done">clean</td><td data-s="done">npm run build</td><td data-s="done">9c1e7f0</td></tr>
<tr><th scope="row">2<small>Tasks model</small></th><td data-s="keep"><span class="str">Balanced</span></td><td data-s="done">5 tasks</td><td data-s="done">2 fixed</td><td data-s="done">npm run build</td><td data-s="done">a41c9e2</td></tr>
<tr><th scope="row">3<small>API endpoints</small></th><td data-s="keep"><span class="str">Best</span></td><td data-s="now">task 6 of 11</td><td data-s="wait">fresh agent</td><td data-s="wait">npm run build</td><td data-s="wait">local only</td></tr>
<tr><th scope="row">4<small>Errors and docs</small></th><td data-s="keep"><span class="str">Thrifty</span></td><td data-s="wait">6 tasks</td><td data-s="wait">fresh agent</td><td data-s="wait">npm run build</td><td data-s="wait">local only</td></tr>
</tbody>
</table>
</div>
<div class="ping"><div><b>✅ Phase complete</b><span>Plan2Code loop on task-api: Phase 2 of 4 (Tasks model) is complete. Done: 5 tasks, committed "Add the tasks model" (a41c9e2). Next: Phase 3, API endpoints. Elapsed: phase 6m, run 14m.</span></div></div>
</div>
<p class="fig-note">Illustration with example data. The message is the one the loop sends to your chat.</p>
<div class="stops">
<h3>It would rather stop than guess. The loop ends on a stop screen, with the evidence, when:</h3>
<ul>
<li>the phase's tests or your quick check fail</li>
<li>a Critical finding is left after the re-check</li>
<li>a task is blocked, or the spec conflicts with itself</li>
<li>a commit is refused, by a pre-commit hook for example</li>
<li>a staged file looks like a secret</li>
<li>you press Stop, now or after this phase</li>
</ul>
</div>
</div>
</div>
</div>
</section>
<section class="sheet deep" id="workflow" aria-labelledby="workflow-title">
<div class="wrap">
<div class="head-row">
<h2 id="workflow-title">Underneath, it is skills and files.</h2>
<p class="lede">The app is optional. The workflow is a set of Agent Skills, and each step is a slash command that runs in your agent's own terminal. Every step writes Markdown the next one reads, so any session, any agent and any engineer can pick up cold.</p>
</div>
<ol class="pipe">
<li class="opt"><span class="n">0</span><h3>Pathfinder <small>optional</small></h3><p>A foggy idea becomes a list of decisions, settled one question at a time.</p><code>/plan2code-0-pathfinder</code><span class="out">writes pathfinder/map.md</span></li>
<li><span class="n">1</span><h3>Plan</h3><p>Requirements, your real codebase, the design. It will not finalize under 90% confidence.</p><code>/plan2code-1-plan</code><span class="out">writes PLAN-DRAFT.md</span></li>
<li><span class="n">2</span><h3>Document</h3><p>The plan becomes phases of small tasks, each phase readable on its own.</p><code>/plan2code-2-document</code><span class="out">writes overview.md, phase-N.md</span></li>
<li><span class="n">3</span><h3>Implement</h3><p>Builds the next phase task by task, ticks each one off, then asks for your sign-off.</p><code>/plan2code-3-implement</code><span class="out">writes code, ticks checkboxes</span></li>
<li class="opt"><span class="n">R</span><h3>Review <small>any time</small></h3><p>An independent second opinion. Every finding cites a file and a line.</p><code>/plan2code-review</code><span class="out">reads only, fixes what you pick</span></li>
<li><span class="n">4</span><h3>Finalize</h3><p>Checks every task against its spec, writes the summary, files the specs away.</p><code>/plan2code-4-finalize</code><span class="out">moves to specs--completed/</span></li>
</ol>
<div class="under">
<div>
<h3>The checkboxes are the state</h3>
<p>Progress lives in the spec files, not in the chat. Close the window mid-phase and nothing is lost.</p>
<pre class="tree" aria-label="Example spec folder"><b>specs/task-api/</b>
├─ PLAN-DRAFT-2026-11-02.md
├─ overview.md <span class="c">phases 1 and 2 done</span>
├─ phase-1.md <span class="x">[x] 4 of 4</span>
├─ phase-2.md <span class="x">[x] 5 of 5</span>
├─ phase-3.md <span class="w">[/] 5 of 11</span>
│ <span class="x">[x]</span> 3.5 PATCH /tasks/:id
│ <span class="w">[/]</span> 3.6 DELETE /tasks/:id
│ [ ] 3.7 One error shape
└─ phase-4.md [ ] 0 of 6</pre>
</div>
<div>
<h3>And a drawer of skills for any time</h3>
<p>Each one is a card on the dashboard and a command in the terminal.</p>
<ul class="skills">
<li><code>/plan2code-ui-prototype</code>Several versions of a screen on one page, tuned with live dials; never changes your code.</li>
<li><code>/plan2code-quick-task</code>Too small for the full process: a quick plan, then it builds.</li>
<li><code>/plan2code-diagnose</code>Finds a bug's cause and writes it up, without fixing it.</li>
<li><code>/plan2code-xray</code>Explains how and why an area of the code works.</li>
<li><code>/plan2code-pr-prep</code>Runs the checks your branch needs and writes the PR description.</li>
<li><code>/plan2code-test</code>Finds code with no tests and writes them in your project's style.</li>
<li><code>/plan2code-dead-code</code>Finds code nothing uses and removes only what you pick.</li>
<li><code>/plan2code-1b-revise-plan</code>Requirements moved mid-build: revise the specs, not the code.</li>
<li><code>/plan2code-handoff</code>Packs a session into a document a fresh one resumes from.</li>
<li><code>/plan2code-git</code>Branches, pull, push and commits, asking before anything leaves.</li>
<li><code>/plan2code-changelog</code>Picks the next version and drafts the entries.</li>
</ul>
</div>
</div>
<p class="agents">The skills install into every agent the skills CLI supports, including Claude Code, Cursor, GitHub Copilot, Windsurf, Codex, Devin, OpenCode, Gemini CLI, Cline, Goose and Zed. Each skill asks whether you want its page or plain terminal prompts, so the whole workflow also runs over SSH with no window at all.</p>
</div>
</section>
<section class="sheet" id="rules" aria-labelledby="rules-title">
<div class="wrap">
<h2 id="rules-title">Four rules do most of the work.</h2>
<ul class="rules">
<li><h3>Keep each session short.</h3><p>Start fresh when the session meter turns red, and always before a big plan or build step. Planning context leaking into implementation is where most agent drift starts.</p></li>
<li><h3>No code until the plan hits 90% confidence.</h3><p>Under the threshold the agent keeps asking and keeps reading your code, and writes every assumption down where you can argue with it.</p></li>
<li><h3>Checkboxes are the state, not the chat.</h3><p>Progress lives in the spec files. Any agent, in any session, resumes cold from them.</p></li>
<li><h3>Approve a phase to close it.</h3><p>On the sign-off card, or by replying <code>approved</code> in the terminal. Nothing advances on a guess about what you meant.</p></li>
</ul>
</div>
</section>
<section class="sheet deep" id="more" aria-labelledby="more-title">
<div class="wrap">
<div class="head-row">
<h2 id="more-title">More room to think than a prompt.</h2>
<p class="lede">The page is served on <code>127.0.0.1</code> by a small program with zero dependencies. No account, and nothing leaves your computer.</p>
</div>
<div class="shots">
<figure>
<img loading="lazy" src="screenshots/doc-dark.webp" width="2560" height="1600" alt="The living document What we've agreed for a task API: where the plan is headed, paging marked Assumed for now, and a short list still to work out.">
<figcaption><strong>A living plan.</strong> What has been agreed so far, with every assumption marked where you can argue with it.</figcaption>
</figure>
<figure>
<img loading="lazy" src="screenshots/ask-dark.webp" width="2560" height="1600" alt="The Ask tab: the question Where are tasks paged? and Plan2Code's answer naming the file.">
<figcaption><strong>Ask, beside the cards.</strong> A chat for anything you want to know, answered at the agent's next check-in. It never holds up your answers.</figcaption>
</figure>
<figure>
<img loading="lazy" src="screenshots/notepad-dark.webp" width="2560" height="1600" alt="The Notebook open over a question: two named tabs, and a heading, bullets and bold styled in place as they are typed.">
<figcaption><strong>A private notebook.</strong> Markdown and pictures, one pad per folder. The agent reads a tab only when you start a workflow from it.</figcaption>
</figure>
<figure>
<img loading="lazy" src="screenshots/finish-dark.webp" width="2560" height="1600" alt="The finished screen after Phase 3: what happened, a Next step box with the command to run and a Continue here button, and a Back to the dashboard button.">
<figcaption><strong>A clear next step.</strong> Every ending says what happened and what to run next, with one button to carry on in the same session.</figcaption>
</figure>
<figure>
<img loading="lazy" src="screenshots/dashboard-utilities-dark.webp" width="2560" height="1600" alt="The dashboard's utility cards: Get a PR ready, Write missing tests, Clear out dead code, Changelog, Git and Handoff, each with a line on what it does and its command.">
<figcaption><strong>Every skill is a card.</strong> The any-time skills sit on the dashboard beside the steps, each with what it does and the command behind it.</figcaption>
</figure>
<figure>
<img loading="lazy" src="screenshots/git-dark.webp" width="2560" height="1600" alt="The git board on feature/task-endpoints: the Changes tab opens on a Next step card reading Commit 3 files, above the three changed files ticked for the commit.">
<figcaption><strong>A git board.</strong> Changes, Branches and Sync, opening on your likely next step. It asks before anything is pushed, published or deleted, and it never force-pushes.</figcaption>
</figure>
</div>
<p class="aside"><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false"><use href="#pl-body"/><use href="#pl-up"/></svg><span>That is Planny. He waves when it is your turn, walks while the agent works, and throws his arms up when you approve a phase.</span></p>
</div>
</section>
<section class="install" id="install" aria-labelledby="install-title">
<div class="wrap install-grid">
<div>
<h2 id="install-title">One line installs all of it.</h2>
<p class="lede">The skills, the <code>plan2code</code> command and, if you say yes, the desktop app. Run it again any time to update. MIT licensed.</p>
</div>
<div>
<div class="before">
<h3>Before you start</h3>
<ul>
<li><strong>Node.js 18 or newer.</strong> Check with <code>node --version</code>. No Node? Get it from <a href="https://nodejs.org/">nodejs.org</a> (the LTS download), or run <code>winget install OpenJS.NodeJS.LTS</code> on Windows, <code>brew install node</code> on macOS, or use <code>nvm</code> on Linux. Then open a new terminal.</li>
<li><strong>Git.</strong> Check with <code>git --version</code>. The installer is fetched from GitHub with Git, and without it npm stops with <code>spawn git ENOENT</code>. No Git? Get it from <a href="https://git-scm.com/downloads">git-scm.com</a>, or run <code>winget install Git.Git</code> on Windows, <code>brew install git</code> on macOS, or use your package manager on Linux. Then open a new terminal.</li>
<li><strong>Start from your project.</strong> Open your terminal in the project you want to work on (<code>cd</code> into it) before you run anything. Plan2Code works on the folder you start it in.</li>
<li><strong>Ways in.</strong> <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</li>
<li><strong>No agent yet?</strong> Install Claude Code, Codex or Devin first, or let the <code>plan2code</code> command's setup page walk you through it.</li>
</ul>
</div>
<div class="cmd">
<pre><span aria-hidden="true">$ </span>npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git</pre>
<button class="copy" type="button" aria-label="Copy the install command">Copy</button>
</div>
<ul class="after">
<li><strong>Then, from your project, run <code>plan2code</code>.</strong> With the app installed it opens the app, and <code>plan2code --classic</code> keeps the agent in your terminal. Already inside your agent? Type <code>/plan2code</code> (<code>$plan2code</code> in Codex).</li>
<li><strong>The app is checked before it is kept.</strong> The installer downloads the build for your system (Windows x64, macOS on Apple silicon or Intel, Linux x64) and verifies it against the release's checksum list. This first release is unsigned, so your system may ask you to allow it once. <a href="https://github.com/jparkerweb/plan2code/blob/main/docs/desktop-app.md">Read the app guide</a>.</li>
<li><strong>Back at your prompt with nothing printed?</strong> The installer always opens a menu, so no output at all means npm could not reach the repository and hid the reason. <code>git ls-remote https://github.com/jparkerweb/plan2code.git</code> shows why.</li>
</ul>
</div>
</div>
</section>
</main>
<footer>
<div class="wrap">
<a class="brand" href="#main"><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false"><use href="#pl-body"/><use href="#pl-down"/></svg><span>Plan2Code</span></a>
<a href="https://github.com/jparkerweb/plan2code">GitHub</a>
<a href="https://github.com/jparkerweb/plan2code#readme">README</a>
<a href="https://github.com/jparkerweb/plan2code/releases">Releases</a>
<a href="https://github.com/jparkerweb/plan2code/blob/main/CHANGELOG.md">Changelog</a>
<span>MIT license</span>
</div>
</footer>
<script>
(function () {
var CMD = 'npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git';
var $ = function (i) { return document.getElementById(i); };
var calm = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
/* Copy the install command. */
var copy = document.querySelector('.copy');
var copyTimer;
function copied() {
copy.textContent = 'Copied';
clearTimeout(copyTimer);
copyTimer = setTimeout(function () { copy.textContent = 'Copy'; }, 1800);
}
function copyFallback() {
var ta = document.createElement('textarea');
ta.value = CMD;
ta.setAttribute('readonly', '');
ta.style.position = 'fixed';
ta.style.opacity = '0';
document.body.appendChild(ta);
ta.select();
try { document.execCommand('copy'); copied(); } catch (e) {}
document.body.removeChild(ta);
}
copy.addEventListener('click', function () {
if (navigator.clipboard && navigator.clipboard.writeText) navigator.clipboard.writeText(CMD).then(copied, copyFallback);
else copyFallback();
});
/* The window: four moments of one session, played in order until someone picks one. */
var BEAT = 6500;
var MOMENTS = [
{ mood: 'wave', st: 'Your move: pick what we are doing today.', term: [
['d', '$ plan2code'], ['g', 'Plan2Code skills loaded'], ['b', '> /plan2code'],
['', 'Dashboard open in this window'], ['d', 'Suggested: Plan']] },
{ mood: 'wave', st: 'Your turn: 3 questions waiting.', term: [
['b', '> /plan2code-1-plan'], ['', 'Reading src/routes and the schema'],
['', 'The plan stays open until confidence reaches 90%'], ['y', '3 questions waiting on the page']] },
{ mood: 'work', st: 'Task 6 of 11: deleting a task', term: [
['b', '> /plan2code-3-implement'], ['', 'Phase 3: API endpoints'],
['g', '\u2713 3.1 Register the /tasks routes plugin'], ['g', '\u2713 3.2 GET /tasks with cursor paging'],
['g', '\u2713 3.3 GET /tasks/:id'], ['g', '\u2713 3.4 POST /tasks with a Zod schema'],
['g', '\u2713 3.5 PATCH /tasks/:id'], ['', ' 3.6 DELETE /tasks/:id as a soft delete']] },
{ mood: 'wave', st: 'Your turn: 1 question waiting.', term: [
['g', '11 of 11 tasks done'], ['', 'Completion report written'],
['y', 'Nothing is marked complete until you approve']] }
];
var stage = $('stage'), tb = $('tb'), pl = $('pl'), st = $('st'), stamp = $('stamp'), moments = $('moments');
var imgs = $('surface').querySelectorAll('img');
var btns = moments.querySelectorAll('button');
/* The window starts tilted back and lies flat as it comes up the screen. */
if (!calm) {
var winEl = document.querySelector('.win'), ticking = false;
var tilt = function () {
ticking = false;
var top = stage.getBoundingClientRect().top;
var t = Math.max(0, Math.min(1, (top - 90) / (window.innerHeight * 0.55)));
winEl.style.setProperty('--tilt', (t * 20).toFixed(2) + 'deg');
};
window.addEventListener('scroll', function () { if (!ticking) { ticking = true; requestAnimationFrame(tilt); } }, { passive: true });
window.addEventListener('resize', tilt);
tilt();
}
var timers = [], at = 0, auto = !calm, seen = false;
moments.style.setProperty('--beat', BEAT + 'ms');
function later(fn, ms) { timers.push(setTimeout(fn, ms)); }
function line(l) {
var s = document.createElement('span');
if (l[0]) s.className = l[0];
s.textContent = l[1];
var cur = tb.querySelector('.cur');
tb.insertBefore(s, cur);
tb.insertBefore(document.createTextNode('\n'), cur);
}
function show(i) {
var m = MOMENTS[i], k;
at = i;
while (timers.length) clearTimeout(timers.pop());
for (k = 0; k < imgs.length; k++) imgs[k].classList.toggle('on', k === i);
for (k = 0; k < btns.length; k++) btns[k].setAttribute('aria-pressed', String(k === i));
moments.classList.toggle('auto', auto);
stamp.classList.remove('on');
pl.setAttribute('data-mood', m.mood);
st.textContent = m.st;
tb.textContent = '';
var cur = document.createElement('span');
cur.className = 'cur';
tb.appendChild(cur);
m.term.forEach(function (l, n) {
if (calm) line(l); else later(function () { line(l); }, 250 + n * 300);
});
if (i === 3) later(function () {
stamp.classList.add('on');
pl.setAttribute('data-mood', 'up');
st.textContent = 'Phase 3 approved. Phase 4 is next.';
line(['g', 'approved: Phase 3 closed']);
}, calm ? 0 : 3000);
if (auto) later(function () { show((i + 1) % MOMENTS.length); }, BEAT);
}
[].forEach.call(btns, function (b, i) {
b.addEventListener('click', function () { auto = false; show(i); });
});
[].forEach.call(document.querySelectorAll('.seg button'), function (b) {
b.addEventListener('click', function () {
var d = b.getAttribute('data-dock');
stage.setAttribute('data-dock', d);
[].forEach.call(document.querySelectorAll('.seg button'), function (o) {
o.setAttribute('aria-pressed', String(o === b));
});
});
});
/* Start once the window has been drafted and built, and only while it is on screen. */
if ('IntersectionObserver' in window && !calm) {
new IntersectionObserver(function (es) {
var on = es[0].isIntersecting;
if (on && !seen) { seen = true; later(function () { show(0); }, 2400); }
else if (on && auto) show(at);
else if (!on) while (timers.length) clearTimeout(timers.pop());
}, { threshold: 0.35 }).observe(stage);
}
/* The loop: phases tick through build, review, check and commit while it is on screen. */
var PHASES = [
{ name: 'Project setup', cells: ['4 tasks', 'clean', 'npm run build', '9c1e7f0'] },
{ name: 'Tasks model', cells: ['5 tasks', '2 fixed', 'npm run build', 'a41c9e2'] },
{ name: 'API endpoints', cells: ['11 tasks', '1 fixed', 'npm run build', '3be07d5'] },
{ name: 'Errors and docs', cells: ['6 tasks', 'clean', 'npm run build', 'f2206ac'] }
];
var WAIT = ['', 'fresh agent', 'npm run build', 'local only'];
var NOW = ['building', 'reviewing', 'running', 'committing'];
var VERB = ['Building', 'Reviewing', 'Checking', 'Committing'];
var rows = $('ledger').querySelectorAll('tr'), pips = $('pips').children, lb = $('lb'), le = $('le');
var step = 8, loopTimer = null;
function drawLoop() {
var done = step >= 16;
for (var p = 0; p < 4; p++) {
var tds = rows[p].querySelectorAll('td');
for (var c = 0; c < 4; c++) {
var idx = p * 4 + c, td = tds[c + 1];
var s = idx < step ? 'done' : idx === step ? 'now' : 'wait';
td.setAttribute('data-s', s);
td.textContent = s === 'done' ? PHASES[p].cells[c] : s === 'now' ? NOW[c] : (c === 0 ? PHASES[p].cells[0] : WAIT[c]);
}
pips[p].className = (p + 1) * 4 <= step ? 'done' : Math.floor(step / 4) === p ? 'now' : '';
}
var ph = Math.min(3, Math.floor(step / 4));
lb.textContent = done ? 'Loop complete: 4 of 4 phases committed' : VERB[step % 4] + ' Phase ' + (ph + 1) + ' of 4: ' + PHASES[ph].name;
le.textContent = 'run ' + (1 + step * 2) + 'm';
}
function tick() {
step = step >= 16 ? 0 : step + 1;
drawLoop();
loopTimer = setTimeout(tick, step >= 16 ? 4200 : 1300);
}
if ('IntersectionObserver' in window && !calm) {
new IntersectionObserver(function (es) {
clearTimeout(loopTimer);
if (es[0].isIntersecting) loopTimer = setTimeout(tick, 1300);
}, { threshold: 0.4 }).observe($('loopwin'));
}
})();
</script>
</body>
</html>