mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-16 04:45:33 -08:00
1051 lines
73 KiB
HTML
1051 lines
73 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 and build with your AI agent</title>
|
|
<meta name="description" content="Plan2Code is a short, structured workflow for AI-assisted development. Your agent asks, you decide, and the specs land in your repo as plain files. Version 3 adds an optional desktop app, an Implementation Loop and two new utilities.">
|
|
<meta name="color-scheme" content="light dark">
|
|
<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">
|
|
<script>document.documentElement.className+=" js"</script>
|
|
<style>
|
|
/* The web console's palette and type (src/web-console/public/styles/tokens.css), so the
|
|
site and the product look like one thing, with the Plan2Code blue as the
|
|
accent: #2455a4 in light, and the console's Ocean highlight (palette.js),
|
|
which the screenshots use, in dark. System fonts only, like the console. */
|
|
:root {
|
|
--bg: #f6f3ee;
|
|
--panel: #ffffff;
|
|
--panel-2: #fbf9f6;
|
|
--ink: #1d1a17;
|
|
--ink-2: #5d564d;
|
|
--ink-3: #8f8779;
|
|
--rule: #e4ddd1;
|
|
--rule-2: #cfc6b6;
|
|
--accent: #2455a4;
|
|
--accent-soft: #ecf2f9;
|
|
--accent-ink: #ffffff;
|
|
--accent-line: #9ab4d3;
|
|
--ok: #2f6b45;
|
|
--warn: #8a5a0b;
|
|
--sand: #b9a982;
|
|
--focus: #1f6feb;
|
|
--code-bg: #1d1a17;
|
|
--code-ink: #f0ece5;
|
|
--code-dim: #a39b8e;
|
|
--shadow: 0 1px 2px rgba(29, 26, 23, 0.05), 0 8px 24px rgba(29, 26, 23, 0.06);
|
|
--shadow-lg: 0 2px 4px rgba(29, 26, 23, 0.06), 0 24px 60px rgba(29, 26, 23, 0.12);
|
|
--sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
|
|
--serif: "Iowan Old Style", Charter, Georgia, Cambria, serif;
|
|
--mono: ui-monospace, SFMono-Regular, "Cascadia Mono", Menlo, Consolas, monospace;
|
|
--radius: 10px;
|
|
--width: 1120px;
|
|
--gutter: 24px;
|
|
}
|
|
@media (prefers-color-scheme: dark) {
|
|
:root {
|
|
--bg: #171513;
|
|
--panel: #201d1a;
|
|
--panel-2: #262220;
|
|
--ink: #f0ece5;
|
|
--ink-2: #b6afa3;
|
|
--ink-3: #8b8376;
|
|
--rule: #332e29;
|
|
--rule-2: #46403a;
|
|
--accent: #619fe5;
|
|
--accent-soft: #1a2533;
|
|
--accent-ink: #0c1117;
|
|
--accent-line: #3d5978;
|
|
--ok: #74c28f;
|
|
--warn: #e0a24a;
|
|
--sand: #7d6f50;
|
|
--focus: #6aa3ff;
|
|
--code-bg: #0f0d0c;
|
|
--code-ink: #f0ece5;
|
|
--code-dim: #9a9286;
|
|
--shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 8px 24px rgba(0, 0, 0, 0.35);
|
|
--shadow-lg: 0 2px 4px rgba(0, 0, 0, 0.45), 0 24px 60px rgba(0, 0, 0, 0.5);
|
|
}
|
|
}
|
|
|
|
* { box-sizing: border-box; }
|
|
html { scroll-behavior: smooth; }
|
|
body {
|
|
margin: 0;
|
|
background: var(--bg);
|
|
color: var(--ink);
|
|
font: 17px/1.6 var(--sans);
|
|
-webkit-font-smoothing: antialiased;
|
|
overflow-wrap: break-word;
|
|
}
|
|
img { max-width: 100%; height: auto; }
|
|
a { color: var(--accent); text-underline-offset: 3px; }
|
|
a:hover { text-decoration-thickness: 2px; }
|
|
code { font-family: var(--mono); font-size: 0.88em; }
|
|
:focus-visible { outline: 2px solid var(--focus); outline-offset: 3px; border-radius: 4px; }
|
|
h1, h2, h3 { font-family: var(--serif); font-weight: 600; line-height: 1.15; margin: 0; }
|
|
h2 { font-size: clamp(1.8rem, 4vw, 2.5rem); margin-bottom: 12px; }
|
|
h3 { font-size: 1.45rem; margin: 8px 0; }
|
|
.muted { color: var(--ink-2); }
|
|
.wrap { max-width: var(--width); margin: 0 auto; padding: 0 var(--gutter); }
|
|
.narrow { max-width: 780px; margin: 0 auto; padding: 0 var(--gutter); text-align: center; }
|
|
.skip { position: absolute; left: -9999px; top: 0; background: var(--panel); color: var(--ink); padding: 10px 16px; z-index: 10; }
|
|
.skip:focus { left: 0; }
|
|
.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
|
|
|
|
/* Planny: shell, star eye, lip. The eye is always the star in the accent color; the
|
|
arms show the mood: down (rest, working), one waving (asking), both up (celebrating),
|
|
none (the agent is not running, dimmed). */
|
|
.planny { display: block; width: 44px; height: 60px; overflow: visible; flex: none; }
|
|
.planny .shell { fill: var(--panel); stroke: var(--ink-2); stroke-width: 1.3; }
|
|
.planny .smile, .planny .arm path { fill: none; stroke: var(--ink-2); stroke-linecap: round; }
|
|
.planny .smile { stroke-width: 0.9; }
|
|
.planny .arm path { stroke-width: 1.2; }
|
|
.planny .arm circle, .planny .foot { fill: var(--ink-2); }
|
|
.planny .eye { fill: var(--accent); 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[data-mood="none"] { opacity: 0.55; }
|
|
.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; }
|
|
.planny.dyn[data-mood="up"] { animation: hop 0.5s ease-out 2; }
|
|
@keyframes wave { from { transform: rotate(-8deg); } to { transform: rotate(20deg); } }
|
|
@keyframes spin { to { transform: rotate(360deg); } }
|
|
@keyframes hop { 50% { transform: translateY(-4px); } }
|
|
|
|
/* Screenshots: framed like a window, one per theme via <picture>. */
|
|
.shot { display: block; border: 1px solid var(--rule-2); border-radius: var(--radius); overflow: hidden; background: var(--panel); box-shadow: var(--shadow); }
|
|
.shot img { display: block; width: 100%; }
|
|
|
|
/* The install command and its copy button. */
|
|
.cmd { position: relative; display: inline-flex; align-items: center; gap: 12px; max-width: 100%; background: var(--code-bg); color: var(--code-ink); border-radius: var(--radius); padding: 10px 10px 10px 18px; text-align: left; }
|
|
.cmd pre { margin: 0; min-width: 0; overflow-x: auto; font: 14.5px/1.5 var(--mono); white-space: pre; }
|
|
.cmd pre span { color: var(--accent-line); user-select: none; }
|
|
.copy { flex: none; display: inline-flex; align-items: center; gap: 6px; border: 0; border-radius: 7px; background: var(--accent); color: var(--accent-ink); font: 700 13px/1 var(--sans); padding: 10px 12px; cursor: pointer; min-height: 40px; }
|
|
.copy:hover { filter: brightness(1.08); }
|
|
.copy svg { width: 16px; height: 16px; fill: none; stroke: currentColor; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; }
|
|
.copy .tick { display: none; }
|
|
.copy.-done .clip { display: none; }
|
|
.copy.-done .tick { display: block; }
|
|
.before { margin: 22px auto 0; max-width: 640px; text-align: left; background: var(--panel); border: 1px solid var(--rule-2); border-radius: var(--radius); padding: 14px 18px; font-size: 15px; }
|
|
.before h3 { margin: 0 0 8px; font: 700 1.05rem var(--serif); }
|
|
.before ul { margin: 0; padding-left: 20px; color: var(--ink-2); }
|
|
.before li { margin: 4px 0; }
|
|
.before strong { color: var(--ink); }
|
|
.then { margin: 12px 0 0; color: var(--ink-2); font-size: 15px; }
|
|
.links-row { margin: 16px 0 0; font-size: 15px; display: flex; flex-wrap: wrap; justify-content: center; gap: 6px 22px; }
|
|
|
|
/* Hero: centered headline and install, then the desktop window. */
|
|
.hero { padding: 48px 0 24px; background: linear-gradient(to bottom, var(--panel), var(--bg)); }
|
|
.hero .narrow { max-width: 860px; }
|
|
.hero h1 { font-size: clamp(2.2rem, 5.6vw, 3.7rem); line-height: 1.06; margin: 0 0 14px; }
|
|
.hero .lede { font-size: 1.2rem; color: var(--ink-2); margin: 0 auto 24px; max-width: 60ch; }
|
|
.stage { max-width: 1280px; margin: 0 auto; padding: 8px var(--gutter) 64px; }
|
|
.honest { max-width: 66ch; margin: 18px auto 0; text-align: center; color: var(--ink); }
|
|
.caption { max-width: 66ch; margin: 8px auto 0; text-align: center; color: var(--ink-2); font-size: 14px; }
|
|
|
|
/* The desktop app window: an illustration drawn in HTML and CSS around a real screenshot. */
|
|
.win { background: var(--panel); border: 1px solid var(--rule-2); border-radius: 12px; box-shadow: var(--shadow-lg); overflow: hidden; max-width: 1240px; margin: 0 auto; }
|
|
.titlebar { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 8px 12px; background: var(--panel-2); border-bottom: 1px solid var(--rule); font-size: 13px; color: var(--ink-2); }
|
|
.titlebar .t { display: flex; align-items: center; gap: 8px; min-width: 0; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
|
|
.titlebar .planny { width: 11px; height: 15px; }
|
|
.wc { display: flex; gap: 14px; flex: none; }
|
|
.wc span { display: block; width: 10px; height: 10px; border: 1px solid var(--ink-2); border-radius: 2px; opacity: 0.7; }
|
|
.appbar { display: flex; flex-wrap: wrap; align-items: center; gap: 10px; padding: 9px 12px; border-bottom: 1px solid var(--rule); font-size: 14px; }
|
|
.chip { display: inline-flex; align-items: center; gap: 7px; padding: 5px 11px; border: 1px solid var(--rule-2); border-radius: 7px; background: var(--bg); font: 500 13.5px var(--sans); }
|
|
.chip svg { width: 14px; height: 14px; stroke: var(--ink-2); fill: none; stroke-width: 1.6; }
|
|
.appbar .sp { flex: 1; }
|
|
.ns { font: 600 13.5px var(--sans); padding: 7px 13px; min-height: 34px; border-radius: 7px; border: 1px solid var(--accent); background: var(--accent); color: var(--accent-ink); cursor: pointer; }
|
|
.ns[disabled] { opacity: 0.6; cursor: progress; }
|
|
.agent { display: inline-flex; align-items: center; gap: 7px; padding: 3px 4px 3px 10px; border: 1px solid var(--rule-2); border-radius: 7px; background: var(--bg); }
|
|
.adot { width: 9px; height: 9px; border-radius: 50%; background: var(--ok); flex: none; transition: background 0.2s; }
|
|
.adot[data-s="busy"] { background: var(--warn); }
|
|
.adot[data-s="off"] { background: var(--ink-3); }
|
|
.agent select { font: 500 13.5px var(--sans); color: var(--ink); background: transparent; border: 0; padding: 4px 2px; cursor: pointer; max-width: 100%; }
|
|
.agent select option { background: var(--panel); color: var(--ink); }
|
|
.vt { display: none; font: 500 13.5px var(--sans); padding: 7px 12px; min-height: 34px; border-radius: 7px; border: 1px solid var(--rule-2); background: var(--bg); color: var(--ink); cursor: pointer; }
|
|
.win[data-dock="hidden"] .vt { display: inline-block; }
|
|
.wbody { display: grid; height: clamp(440px, 50vw, 660px); background: var(--bg); }
|
|
.win[data-dock="right"] .wbody { grid-template-columns: minmax(0, 1fr) clamp(250px, 28%, 340px); grid-template-rows: minmax(0, 1fr); }
|
|
.win[data-dock="bottom"] .wbody { grid-template-columns: minmax(0, 1fr); grid-template-rows: minmax(0, 1fr) 38%; }
|
|
.win[data-dock="hidden"] .wbody { grid-template-columns: minmax(0, 1fr); grid-template-rows: minmax(0, 1fr); }
|
|
.win[data-dock="hidden"] .term { display: none; }
|
|
.surface { position: relative; overflow: hidden; background: var(--panel-2); min-height: 0; min-width: 0; }
|
|
.surface picture, .surface img { display: block; width: 100%; height: 100%; }
|
|
.surface img { object-fit: cover; object-position: top left; }
|
|
.term { display: flex; flex-direction: column; min-width: 0; min-height: 0; background: var(--code-bg); color: var(--code-ink); border-left: 1px solid var(--rule); }
|
|
.win[data-dock="bottom"] .term { border-left: 0; border-top: 1px solid var(--rule); }
|
|
.th { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 6px 10px; background: rgba(255, 255, 255, 0.07); font-size: 12.5px; color: var(--code-dim); border-bottom: 1px solid rgba(255, 255, 255, 0.08); flex-wrap: wrap; }
|
|
.seg { display: inline-flex; border: 1px solid rgba(255, 255, 255, 0.22); border-radius: 6px; overflow: hidden; }
|
|
.seg button { font: 500 12.5px var(--sans); padding: 5px 10px; background: transparent; color: var(--code-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(--accent); color: var(--accent-ink); }
|
|
.seg button:focus-visible { outline-offset: -2px; }
|
|
.wtb { flex: 1; margin: 0; padding: 10px 12px; overflow: hidden; font: 12.5px/1.55 var(--mono); white-space: pre-wrap; word-break: break-word; display: flex; flex-direction: column; justify-content: flex-end; }
|
|
.wtb .d { color: var(--code-dim); }
|
|
.wtb .g { color: #7fd29a; }
|
|
.wtb .b { color: #8fb8f0; }
|
|
.wtb .cur { display: inline-block; width: 7px; height: 13px; background: var(--code-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(--rule); background: var(--panel); font-size: 13.5px; color: var(--ink-2); min-height: 46px; }
|
|
.status .planny { width: 18px; height: 25px; }
|
|
.flow { position: absolute; left: 50%; top: 14px; transform: translateX(-50%); width: min(440px, calc(100% - 24px)); background: var(--panel); border: 1px solid var(--rule-2); border-radius: 10px; padding: 12px 14px; box-shadow: var(--shadow-lg); }
|
|
.flow[hidden] { display: none; }
|
|
.flow p { margin: 0 0 8px; font: 700 15px var(--sans); }
|
|
.flow ol { list-style: none; margin: 0; padding: 0; display: grid; gap: 7px; }
|
|
.flow li { display: flex; align-items: center; gap: 10px; font-size: 14px; color: var(--ink-2); }
|
|
.flow li i { width: 20px; height: 20px; border-radius: 50%; border: 1.5px solid var(--rule-2); display: grid; place-items: center; font: 600 11px var(--sans); font-style: normal; flex: none; transition: all 0.2s; }
|
|
.flow li[data-s="now"] { color: var(--ink); }
|
|
.flow li[data-s="now"] i { border-color: var(--accent); color: var(--accent); }
|
|
.flow li[data-s="done"] { color: var(--ink); }
|
|
.flow li[data-s="done"] i { background: var(--ok); border-color: var(--ok); color: var(--panel); }
|
|
|
|
/* Sections. */
|
|
section.s { padding: 72px 0; }
|
|
section.alt { background: var(--panel); border-block: 1px solid var(--rule); }
|
|
.intro { max-width: 62ch; margin: 0; }
|
|
.tag { display: inline-block; font: 700 11.5px/1.5 var(--sans); padding: 1px 9px; border-radius: 999px; border: 1px solid var(--rule-2); color: var(--ink-2); vertical-align: middle; white-space: nowrap; }
|
|
.tag.new { background: var(--accent); border-color: var(--accent); color: var(--accent-ink); }
|
|
|
|
/* How a session goes: alternating screenshot and text rows. */
|
|
.row { display: grid; grid-template-columns: minmax(0, 7fr) minmax(0, 5fr); gap: 48px; align-items: center; margin-top: 56px; }
|
|
.row.flip { grid-template-columns: minmax(0, 5fr) minmax(0, 7fr); }
|
|
.row.flip .shot { order: 2; }
|
|
.row .kk { display: flex; align-items: flex-end; gap: 14px; }
|
|
.row .k { font-family: var(--serif); font-size: 3rem; line-height: 1; color: var(--accent); }
|
|
.row .kk .planny { width: 34px; height: 46px; }
|
|
.row p { color: var(--ink-2); margin: 0; }
|
|
|
|
/* The workflow map. */
|
|
.map { position: relative; background: var(--panel); border: 1px solid var(--rule-2); border-radius: 14px; padding: 8px 24px 26px; margin-top: 28px; overflow: hidden; }
|
|
.map h3.rowhead { font: 700 15px var(--sans); color: var(--ink-2); margin: 22px 0 0; }
|
|
.mline, .mbranch { list-style: none; margin: 0; padding: 0; display: flex; }
|
|
.mline li, .mbranch li { position: relative; flex: 1 1 0; min-width: 0; text-align: center; }
|
|
.mline li { height: 214px; padding-top: 100px; }
|
|
.mline li::before { content: ""; position: absolute; left: -50%; width: 100%; top: calc(100px + 13px - 2px); height: 4px; background: var(--accent); z-index: 0; }
|
|
.mline li:first-child::before { display: none; }
|
|
.mline li:nth-child(2)::before { background: repeating-linear-gradient(90deg, var(--accent) 0 10px, transparent 10px 18px); }
|
|
.mbranch { margin-top: 6px; }
|
|
.mbranch li { padding-top: 64px; height: 178px; }
|
|
.mbranch li::before { content: ""; position: absolute; left: -50%; width: 100%; top: calc(64px + 9px - 2px); height: 4px; background: var(--ink-2); }
|
|
.mbranch li:first-child::before { display: none; }
|
|
.mst { display: block; text-decoration: none; color: var(--ink); padding: 0 4px; position: relative; z-index: 1; }
|
|
.mdot { display: block; margin: 0 auto 8px; width: 26px; height: 26px; border-radius: 50%; background: var(--panel); border: 4px solid var(--accent); position: relative; z-index: 1; }
|
|
.mline li:first-child .mdot { border-style: dashed; }
|
|
.mbranch .mdot { width: 18px; height: 18px; border-color: var(--ink-2); box-shadow: 0 0 0 3px var(--sand); }
|
|
.mbranch .new .mdot { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-line); }
|
|
.mnm { display: block; font: 700 15px/1.25 var(--sans); }
|
|
.mbranch .mnm { font-size: 13.5px; }
|
|
.msb { display: block; font-size: 13px; line-height: 1.35; color: var(--ink-2); margin-top: 2px; }
|
|
.mst .tag { margin-top: 4px; font-size: 11px; padding: 0 7px; }
|
|
.mst:hover .mnm { text-decoration: underline; }
|
|
.mst[aria-current="true"] .mdot { background: var(--accent); }
|
|
.mbranch .mst[aria-current="true"] .mdot { background: var(--ink-2); }
|
|
.mbranch .new .mst[aria-current="true"] .mdot { background: var(--accent); }
|
|
.mst[aria-current="true"] .mnm { color: var(--accent); }
|
|
.mst:focus-visible { outline-offset: 2px; }
|
|
.loop { position: absolute; left: 50%; top: 6px; width: 132px; height: 92px; transform: translateX(-50%); pointer-events: none; z-index: 0; }
|
|
.loop svg { width: 100%; height: 100%; overflow: visible; }
|
|
.loop path { fill: none; stroke: var(--accent); stroke-width: 4; stroke-linecap: round; }
|
|
.loop .ah { fill: var(--accent); stroke: none; }
|
|
.loop span { position: absolute; left: 50%; top: -4px; transform: translateX(-50%); font: 700 12px var(--sans); color: var(--accent); background: var(--panel); padding: 0 6px; white-space: nowrap; }
|
|
.loopnote { display: none; font-size: 12.5px; color: var(--accent); font-weight: 700; margin-top: 2px; }
|
|
.rider { display: none; position: absolute; left: 0; top: 0; width: 34px; height: 46px; z-index: 3; pointer-events: none; transition: transform 0.55s cubic-bezier(0.5, 0.1, 0.2, 1); }
|
|
html.js .rider { display: block; }
|
|
.rider .planny { width: 100%; height: 100%; }
|
|
.maphint { font-size: 14px; color: var(--ink-2); margin: 14px 0 0; }
|
|
.panel { margin-top: 16px; }
|
|
.panel article { background: var(--panel-2); border: 1px solid var(--rule-2); border-radius: 12px; padding: 22px; margin-bottom: 16px; display: grid; gap: 22px; grid-template-columns: minmax(0, 1fr); }
|
|
.panel article.has-fig { grid-template-columns: minmax(0, 1fr) minmax(0, 1.1fr); align-items: center; }
|
|
html.js .panel article[hidden] { display: none; }
|
|
.panel h3 { margin: 6px 0 8px; }
|
|
.panel p { margin: 0 0 12px; color: var(--ink-2); max-width: 62ch; }
|
|
.panel .meta { display: flex; gap: 8px; flex-wrap: wrap; }
|
|
.panel .cmd { margin-top: 2px; margin-right: 8px; }
|
|
.panel .cmd pre { font-size: 14px; }
|
|
.panel .copy { padding: 8px 12px; }
|
|
.panel figure { margin: 0; }
|
|
.panel figcaption { margin-top: 8px; font-size: 14px; color: var(--ink-2); }
|
|
.panel-fallback { font-size: 15px; color: var(--ink-2); margin: 24px 0 0; display: none; }
|
|
html:not(.js) .panel-fallback { display: block; }
|
|
|
|
/* Illustrations of v3 screens (drawn, not screenshots). */
|
|
.mock { border: 1px solid var(--rule-2); border-radius: 10px; background: var(--bg); padding: 12px 14px; font-size: 13.5px; line-height: 1.45; color: var(--ink); }
|
|
.mock .bar { height: 8px; border-radius: 4px; background: var(--rule-2); margin: 6px 0; }
|
|
.mock .mrow { display: flex; align-items: center; gap: 8px; padding: 5px 0; border-bottom: 1px dashed var(--rule-2); }
|
|
.mock .pill { padding: 0 8px; border-radius: 99px; border: 1px solid var(--rule-2); font-size: 12px; color: var(--ink-2); white-space: nowrap; }
|
|
.mock .pill.ok { border-color: var(--accent); color: var(--accent); }
|
|
.mock .box { border: 1px solid var(--rule-2); background: var(--panel); border-radius: 6px; padding: 8px 10px; margin-top: 8px; }
|
|
.mock .mono { font-family: var(--mono); font-size: 12.5px; }
|
|
.mock .verdict { display: inline-block; font-weight: 700; color: var(--accent); margin: 6px 0 0; }
|
|
|
|
.stage2 { margin-top: 56px; }
|
|
.stage2 .row { margin-top: 0; }
|
|
|
|
/* What's new in v3. */
|
|
.rows { margin: 32px 0 0; padding: 0; list-style: none; border-top: 1px solid var(--rule-2); }
|
|
.rows > li { display: grid; grid-template-columns: minmax(0, 17rem) minmax(0, 1fr); gap: 8px 32px; padding: 20px 0; border-bottom: 1px solid var(--rule-2); }
|
|
.rows h3 { font-size: 1.25rem; margin: 0; }
|
|
.rows p { margin: 0 0 8px; color: var(--ink-2); max-width: 68ch; }
|
|
.rows p:last-child { margin-bottom: 0; }
|
|
.rows code { background: var(--panel-2); border: 1px solid var(--rule); padding: 1px 6px; border-radius: 5px; }
|
|
.strip { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 8px; margin: 12px 0 0; padding: 0; list-style: none; max-width: 560px; }
|
|
.strip li { border: 1px solid var(--rule-2); border-radius: 8px; padding: 8px 10px; background: var(--bg); font-size: 13px; line-height: 1.4; }
|
|
.strip li.done { border-color: var(--accent); }
|
|
.strip li.run { border-style: dashed; border-color: var(--accent); }
|
|
.strip b { display: block; font-size: 13.5px; }
|
|
.bdg { display: inline-block; margin: 4px 0; padding: 0 8px; border-radius: 99px; border: 1px solid var(--rule-2); font: 700 11.5px/1.6 var(--sans); color: var(--ink); background: var(--panel); }
|
|
.bdg.t { border-color: var(--ok); }
|
|
.bdg.b { border-color: var(--accent); }
|
|
.bdg.s { border-color: var(--warn); }
|
|
.strip small { display: block; color: var(--ink-2); font-size: 12.5px; }
|
|
.illus { margin: 8px 0 0; font-size: 13.5px; color: var(--ink-2); }
|
|
|
|
/* What the page gives you: a two-column list. */
|
|
.feat { columns: 2; column-gap: 56px; margin-top: 36px; }
|
|
.feat div { break-inside: avoid; padding: 18px 0; border-top: 1px solid var(--rule); }
|
|
.feat h3 { font-size: 1.2rem; margin: 0 0 4px; }
|
|
.feat p { margin: 0; color: var(--ink-2); }
|
|
.feat-shots { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 24px; margin-top: 40px; }
|
|
.feat-shots figure { margin: 0; }
|
|
.feat-shots figcaption { margin-top: 10px; font-size: 14.5px; color: var(--ink-2); }
|
|
|
|
/* The rules: numbered. */
|
|
ol.rules { list-style: none; padding: 0; margin: 32px 0 0; counter-reset: r; }
|
|
ol.rules li { counter-increment: r; display: grid; grid-template-columns: 3.5rem minmax(0, 1fr); gap: 16px; padding: 22px 0; border-top: 1px solid var(--rule-2); }
|
|
ol.rules li::before { content: counter(r); font-family: var(--serif); font-size: 2.6rem; line-height: 1; color: var(--accent); }
|
|
ol.rules h3 { font-family: var(--sans); font-size: 1.15rem; font-weight: 650; margin: 0 0 4px; }
|
|
ol.rules p { margin: 0; color: var(--ink-2); }
|
|
.calm { display: flex; align-items: center; gap: 16px; border-top: 1px solid var(--rule-2); padding-top: 22px; }
|
|
.calm .planny { width: 40px; height: 54px; }
|
|
.calm p { margin: 0; color: var(--ink-2); max-width: 62ch; }
|
|
|
|
/* Prefer the terminal? */
|
|
.term-band { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 48px; align-items: center; }
|
|
pre.termbox { background: var(--code-bg); color: var(--code-ink); border-radius: var(--radius); padding: 22px; margin: 0; font: 14.5px/1.8 var(--mono); overflow-x: auto; }
|
|
pre.termbox .d { color: var(--code-dim); }
|
|
|
|
/* Closing install and footer. */
|
|
.close { text-align: center; }
|
|
.close .muted { margin: 0 0 22px; }
|
|
.close .app-note { max-width: 62ch; margin: 22px auto 0; color: var(--ink-2); font-size: 15.5px; }
|
|
footer { border-top: 1px solid var(--rule); padding: 26px 0 32px; color: var(--ink-2); font-size: 14.5px; }
|
|
footer .wrap { display: flex; flex-wrap: wrap; justify-content: center; gap: 8px 22px; }
|
|
footer a { color: inherit; }
|
|
|
|
@media (max-width: 900px) {
|
|
.map { padding: 8px 16px 22px 36px; }
|
|
.mline, .mbranch { display: block; position: relative; padding-left: 64px; }
|
|
.mline li, .mbranch li { height: auto; text-align: left; padding: 0 0 22px; }
|
|
.mline li::before, .mbranch li::before { left: -45px; width: 4px; top: -22px; bottom: auto; height: 100%; background: var(--accent); }
|
|
.mline li:nth-child(2)::before { background: repeating-linear-gradient(180deg, var(--accent) 0 8px, transparent 8px 14px); }
|
|
.mline li:first-child::before { display: none; }
|
|
.mbranch li::before { background: var(--ink-2); }
|
|
.mbranch li:first-child::before { display: block; top: 12px; }
|
|
.mline li:last-child::before, .mbranch li:last-child::before { height: 36px; }
|
|
.mst { min-height: 44px; padding: 0; }
|
|
.mdot, .mbranch .mdot { position: absolute; left: -54px; top: 2px; margin: 0; }
|
|
.mbranch .mdot { left: -50px; }
|
|
.loop { display: none; }
|
|
.loopnote { display: block; }
|
|
.rider { width: 26px; height: 35px; }
|
|
.panel article.has-fig { grid-template-columns: minmax(0, 1fr); }
|
|
}
|
|
@media (max-width: 820px) {
|
|
.row, .row.flip, .term-band, .feat-shots { grid-template-columns: minmax(0, 1fr); gap: 20px; }
|
|
.row.flip .shot { order: 0; }
|
|
.row { margin-top: 44px; }
|
|
.feat { columns: 1; }
|
|
.rows > li { grid-template-columns: minmax(0, 1fr); }
|
|
section.s { padding: 56px 0; }
|
|
}
|
|
@media (max-width: 720px) {
|
|
.win[data-dock="right"] .wbody { grid-template-columns: minmax(0, 1fr); grid-template-rows: minmax(0, 1fr) 40%; }
|
|
.wbody { height: 560px; }
|
|
}
|
|
@media (max-width: 600px) {
|
|
:root { --gutter: 16px; }
|
|
body { font-size: 16px; }
|
|
.hero { padding-top: 40px; }
|
|
.cmd { display: flex; }
|
|
.cmd pre { font-size: 13px; }
|
|
ol.rules li { grid-template-columns: 2.5rem minmax(0, 1fr); }
|
|
.strip { grid-template-columns: repeat(2, minmax(0, 1fr)); }
|
|
.panel article { padding: 16px; }
|
|
}
|
|
@media (prefers-reduced-motion: reduce) {
|
|
html { scroll-behavior: auto; }
|
|
* { transition: none !important; animation: none !important; }
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<a class="skip" href="#main">Skip to the content</a>
|
|
<main id="main">
|
|
|
|
<section class="hero" aria-labelledby="hero-title">
|
|
<div class="narrow">
|
|
<svg class="planny" style="margin:0 auto 6px" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="up"><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 class="arms"><g class="a-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></g></svg>
|
|
<h1 id="hero-title">Your agent and your plan, in one window.</h1>
|
|
<p class="lede">Plan2Code is a short, structured workflow where your AI agent asks, you decide, and the specs land in your repo as plain files. Version 3 adds an optional desktop app that holds the dashboard and your agent side by side.</p>
|
|
<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>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 id="install-cmd"><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"><svg class="clip" viewBox="0 0 24 24" aria-hidden="true"><rect x="9" y="9" width="11" height="12" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg><svg class="tick" viewBox="0 0 24 24" aria-hidden="true"><path d="M4 12.5 9.5 18 20 6.5"/></svg><span class="label">Copy</span></button>
|
|
</div>
|
|
<p class="then">then, from your project, run <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</p>
|
|
<p class="links-row"><a href="#terminal">Prefer the terminal?</a> <a href="#workflow">See the workflow</a> <a href="#v3">What is new in v3</a></p>
|
|
</div>
|
|
</section>
|
|
|
|
<div class="stage">
|
|
<!-- Illustration, not a screenshot: the desktop app window is drawn in HTML and CSS around the real web console screenshot of the dashboard. -->
|
|
<div class="win" id="win" data-dock="right" role="group" aria-label="Illustration of the Plan2Code desktop app">
|
|
<div class="titlebar">
|
|
<div class="t"><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="rest"><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 class="arms"><g class="a-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></svg>Plan2Code - my-project</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>my-project</span>
|
|
<button class="ns" id="ns" type="button">New Session</button>
|
|
<span class="sp"></span>
|
|
<button class="vt" id="vt" type="button">View Agent Terminal</button>
|
|
<span class="agent"><span class="adot" id="dot" data-s="on" aria-hidden="true"></span>
|
|
<label class="sr" for="agentSel">Agent</label>
|
|
<select id="agentSel"><option>Claude Code</option><option>Devin</option><option>Codex</option><option>Your own agent</option></select>
|
|
</span>
|
|
</div>
|
|
<div class="wbody">
|
|
<div class="surface">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/dashboard-dark.webp">
|
|
<img src="screenshots/dashboard-light.webp" width="2560" height="1600" alt="The Plan2Code dashboard for a task API that is half built: a Set up card, then the steps in order, with the Implement card marked Suggested and reading Phase 3 of 4 is next.">
|
|
</picture>
|
|
<div class="flow" id="flow" hidden>
|
|
<p>New Session</p>
|
|
<ol>
|
|
<li id="f1"><i>1</i>Brief written from the session</li>
|
|
<li id="f2"><i>2</i>Fresh agent starts</li>
|
|
<li id="f3"><i>3</i>Work carried over</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
<div class="term" id="term" role="region" aria-label="Agent terminal panel">
|
|
<div class="th">
|
|
<span id="termTitle">Agent Terminal: Claude Code</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>
|
|
<button type="button" data-dock="hidden" aria-pressed="false">Hide</button>
|
|
</span>
|
|
</div>
|
|
<pre class="wtb" id="tb" aria-label="Example agent output"></pre>
|
|
</div>
|
|
</div>
|
|
<div class="status">
|
|
<svg class="planny dyn" id="pl" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="rest"><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 class="arms"><g class="a-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 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"><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></g></svg>
|
|
<span id="stText" aria-live="polite">Agent running. Planny is keeping an eye on it.</span>
|
|
</div>
|
|
</div>
|
|
<p class="honest">The app is optional. The workflow, the specs and the skills are the same either way, and <code>plan2code --classic</code> keeps the terminal flow.</p>
|
|
<p class="caption">An illustration: the desktop app drawn around a real screenshot of the dashboard. Try the dock buttons and New Session.</p>
|
|
</div>
|
|
|
|
<section class="s alt" id="workflow" aria-labelledby="workflow-title">
|
|
<div class="wrap">
|
|
<h2 id="workflow-title">The workflow, as a map</h2>
|
|
<p class="intro muted">Every step is a card on the dashboard, and each one writes files the next one reads, so any session can pick up cold. Pick a station.</p>
|
|
|
|
<div class="map" id="mapbox">
|
|
<!-- Planny rides to the selected station (JS only). -->
|
|
<div class="rider" id="rider" aria-hidden="true"><svg class="planny rider" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="rest"><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 class="arms"><g class="a-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 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"><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></g></svg></div>
|
|
|
|
<h3 class="rowhead">The line: four steps and an optional start</h3>
|
|
<ol class="mline" aria-label="Main workflow">
|
|
<li><a class="mst" href="#d-pathfinder" data-mood="wave"><span class="mdot"></span><span class="mnm">Pathfinder</span><span class="msb">Step 0, optional. Settle a foggy idea.</span></a></li>
|
|
<li><a class="mst" href="#d-plan" data-mood="wave"><span class="mdot"></span><span class="mnm">Plan</span><span class="msb">Requirements, design, your approval.</span></a></li>
|
|
<li><a class="mst" href="#d-document" data-mood="rest"><span class="mdot"></span><span class="mnm">Document</span><span class="msb">The plan becomes small tasks.</span></a></li>
|
|
<li>
|
|
<div class="loop" aria-hidden="true">
|
|
<svg viewBox="0 0 132 92"><path d="M10 90 C6 6 126 6 122 84"/><path class="ah" d="M113 80 L122 92 L131 80 Z"/></svg>
|
|
<span>once per phase</span>
|
|
</div>
|
|
<a class="mst" href="#d-implement" data-mood="work"><span class="mdot"></span><span class="mnm">Implement</span><span class="msb">One phase at a time, then your sign-off.</span><span class="loopnote">Loops once per phase</span></a>
|
|
</li>
|
|
<li><a class="mst" href="#d-finalize" data-mood="up"><span class="mdot"></span><span class="mnm">Finalize</span><span class="msb">Check, summarize, file the specs.</span></a></li>
|
|
</ol>
|
|
|
|
<h3 class="rowhead">The any-time line: take a branch whenever you need it</h3>
|
|
<ul class="mbranch" aria-label="Any-time utilities">
|
|
<li><a class="mst" href="#d-quick" data-mood="rest"><span class="mdot"></span><span class="mnm">Quick task</span></a></li>
|
|
<li><a class="mst" href="#d-review" data-mood="rest"><span class="mdot"></span><span class="mnm">Review</span></a></li>
|
|
<li><a class="mst" href="#d-handoff" data-mood="rest"><span class="mdot"></span><span class="mnm">Handoff</span></a></li>
|
|
<li><a class="mst" href="#d-xray" data-mood="rest"><span class="mdot"></span><span class="mnm">Codebase X-ray</span></a></li>
|
|
<li><a class="mst" href="#d-diagnose" data-mood="rest"><span class="mdot"></span><span class="mnm">Diagnose a bug</span></a></li>
|
|
<li><a class="mst" href="#d-changelog" data-mood="rest"><span class="mdot"></span><span class="mnm">Changelog</span></a></li>
|
|
<li><a class="mst" href="#d-git" data-mood="rest"><span class="mdot"></span><span class="mnm">Git</span></a></li>
|
|
<li class="new"><a class="mst" href="#d-pr" data-mood="up"><span class="mdot"></span><span class="mnm">Get a PR ready</span><span class="tag new">New in v3</span></a></li>
|
|
<li class="new"><a class="mst" href="#d-test" data-mood="up"><span class="mdot"></span><span class="mnm">Write missing tests</span><span class="tag new">New in v3</span></a></li>
|
|
</ul>
|
|
<p class="maphint">Click a station, or tab to one and press Enter. Arrow keys move between stations.</p>
|
|
</div>
|
|
|
|
<p class="panel-fallback">JavaScript is off, so every station is listed in full below.</p>
|
|
<div class="panel" id="panel" aria-live="polite">
|
|
|
|
<article id="d-pathfinder" class="has-fig">
|
|
<div>
|
|
<div class="meta"><span class="tag">Step 0</span><span class="tag">Optional</span></div>
|
|
<h3>Pathfinder</h3>
|
|
<p>A foggy idea becomes a clear list of decisions, settled one question at a time. The agent asks a few at a time, each option with its trade-off written under it, and you pick. Skip it when you already know what you want.</p>
|
|
<div class="cmd"><pre>/plan2code-0-pathfinder</pre><button class="copy" type="button" data-copy="/plan2code-0-pathfinder" aria-label="Copy /plan2code-0-pathfinder"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
<figure><picture class="shot"><source media="(prefers-color-scheme: dark)" srcset="screenshots/question-dark.webp"><img loading="lazy" src="screenshots/question-light.webp" width="2560" height="1600" alt="A question card, How tasks are paged, with three options, the first marked Suggested, each with its trade-off underneath."></picture><figcaption>Questions arrive a few at a time on a page in your browser.</figcaption></figure>
|
|
</article>
|
|
|
|
<article id="d-plan" class="has-fig">
|
|
<div>
|
|
<div class="meta"><span class="tag">Step 1</span></div>
|
|
<h3>Plan</h3>
|
|
<p>Requirements, technical design and your approval: the shape of what gets built. No code is written until the plan hits 90% confidence. In the desktop app, Plan and Revise Plan can offer helpers matched to the job.</p>
|
|
<div class="cmd"><pre>/plan2code-1-plan</pre><button class="copy" type="button" data-copy="/plan2code-1-plan" aria-label="Copy /plan2code-1-plan"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
<figure><picture class="shot"><source media="(prefers-color-scheme: dark)" srcset="screenshots/doc-dark.webp"><img loading="lazy" src="screenshots/doc-light.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, still open, and a short list still to work out."></picture><figcaption>The plan so far, with every assumption written down where you can argue with it.</figcaption></figure>
|
|
</article>
|
|
|
|
<article id="d-document">
|
|
<div>
|
|
<div class="meta"><span class="tag">Step 2</span></div>
|
|
<h3>Document</h3>
|
|
<p>The plan becomes a checklist of small tasks, grouped into phases, that a developer can just do. They are checkboxes in spec files in your repo.</p>
|
|
<div class="cmd"><pre>/plan2code-2-document</pre><button class="copy" type="button" data-copy="/plan2code-2-document" aria-label="Copy /plan2code-2-document"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-implement" class="has-fig">
|
|
<div>
|
|
<div class="meta"><span class="tag">Step 3</span><span class="tag">Once per phase</span></div>
|
|
<h3>Implement</h3>
|
|
<p>Builds the next phase, task by task, with a report and your sign-off at the end. <strong>Implement + review</strong> adds a careful review of the changes before the sign-off.</p>
|
|
<p>In the desktop app, the <strong>Implementation Loop</strong> can build a whole spec phase by phase instead, each phase in a fresh agent, and write a report.</p>
|
|
<div class="cmd"><pre>/plan2code-3-implement</pre><button class="copy" type="button" data-copy="/plan2code-3-implement" aria-label="Copy /plan2code-3-implement"><span class="label">Copy</span></button></div>
|
|
<div class="cmd"><pre>/plan2code-3-implement-review</pre><button class="copy" type="button" data-copy="/plan2code-3-implement-review" aria-label="Copy /plan2code-3-implement-review"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
<figure><picture class="shot"><source media="(prefers-color-scheme: dark)" srcset="screenshots/build-dark.webp"><img loading="lazy" src="screenshots/build-light.webp" width="2560" height="1600" alt="A phase of a task API being built: 5 of 11 done on the progress bar, and the phase's task list with the first five ticked."></picture><figcaption>Tasks tick off as they land.</figcaption></figure>
|
|
</article>
|
|
|
|
<article id="d-finalize" class="has-fig">
|
|
<div>
|
|
<div class="meta"><span class="tag">Step 4</span></div>
|
|
<h3>Finalize</h3>
|
|
<p>Checks the work, writes the summary, files the specs away and suggests the commit message.</p>
|
|
<div class="cmd"><pre>/plan2code-4-finalize</pre><button class="copy" type="button" data-copy="/plan2code-4-finalize" aria-label="Copy /plan2code-4-finalize"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
<figure><picture class="shot"><source media="(prefers-color-scheme: dark)" srcset="screenshots/finish-dark.webp"><img loading="lazy" src="screenshots/finish-light.webp" width="2560" height="1600" alt="The finished screen after a phase: what happened, the next command with a Copy button, and a Back to the dashboard button."></picture><figcaption>Every ending says what to run next.</figcaption></figure>
|
|
</article>
|
|
|
|
<article id="d-quick">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Quick task</h3>
|
|
<p>Too small for the full process? A quick plan, then it just builds it.</p>
|
|
<div class="cmd"><pre>/plan2code-quick-task</pre><button class="copy" type="button" data-copy="/plan2code-quick-task" aria-label="Copy /plan2code-quick-task"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-review">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Review</h3>
|
|
<p>A second opinion on the changes. Problems ranked, and you pick what gets fixed.</p>
|
|
<div class="cmd"><pre>/plan2code-review</pre><button class="copy" type="button" data-copy="/plan2code-review" aria-label="Copy /plan2code-review"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-handoff">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Handoff</h3>
|
|
<p>Pack the current session into a document a fresh session can pick up cold.</p>
|
|
<div class="cmd"><pre>/plan2code-handoff</pre><button class="copy" type="button" data-copy="/plan2code-handoff" aria-label="Copy /plan2code-handoff"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-xray">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Codebase X-ray</h3>
|
|
<p>Explains how and why an area works, or ranks the rough spots worth fixing into a brief for planning.</p>
|
|
<div class="cmd"><pre>/plan2code-xray</pre><button class="copy" type="button" data-copy="/plan2code-xray" aria-label="Copy /plan2code-xray"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-diagnose">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Diagnose a bug</h3>
|
|
<p>Finds a bug's cause and writes it up without fixing it, then hands the fix to Quick task, or to Plan when it is big.</p>
|
|
<div class="cmd"><pre>/plan2code-diagnose</pre><button class="copy" type="button" data-copy="/plan2code-diagnose" aria-label="Copy /plan2code-diagnose"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-changelog">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Changelog</h3>
|
|
<p>Picks the next version and drafts the entries, which you edit before Git commits them.</p>
|
|
<div class="cmd"><pre>/plan2code-changelog</pre><button class="copy" type="button" data-copy="/plan2code-changelog" aria-label="Copy /plan2code-changelog"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-git">
|
|
<div>
|
|
<div class="meta"><span class="tag">Any time</span></div>
|
|
<h3>Git</h3>
|
|
<p>A board for branches, pull, push and commits that opens on the likely next step. The screenshot is just below the map.</p>
|
|
<div class="cmd"><pre>/plan2code-git</pre><button class="copy" type="button" data-copy="/plan2code-git" aria-label="Copy /plan2code-git"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-pr" class="has-fig">
|
|
<div>
|
|
<div class="meta"><span class="tag new">New in v3</span><span class="tag">Any time</span></div>
|
|
<h3>Get a PR ready</h3>
|
|
<p>Picks the checks that cover your branch's changes, runs them, and says Ready, Ready with notes or Not ready. Then it writes a PR description for you to copy. It never commits, pushes or opens the PR, and it can read an optional test map.</p>
|
|
<div class="cmd"><pre>/plan2code-pr-prep</pre><button class="copy" type="button" data-copy="/plan2code-pr-prep" aria-label="Copy /plan2code-pr-prep"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
<!-- Illustration, not a screenshot. -->
|
|
<div>
|
|
<div class="mock" role="img" aria-label="Illustration of a PR check run ending in the verdict Ready with notes, and a PR description to copy.">
|
|
<strong>Checks for this branch</strong>
|
|
<div class="mrow"><span class="pill ok">passed</span> A check chosen for the changed files</div>
|
|
<div class="mrow"><span class="pill ok">passed</span> Another check for the changed files</div>
|
|
<div class="mrow"><span class="pill">note</span> One thing worth a look before review</div>
|
|
<span class="verdict">Ready with notes</span>
|
|
<div class="box"><span class="mono">PR description</span><div class="bar"></div><div class="bar" style="width:80%"></div><div class="bar" style="width:60%"></div><span class="pill">Copy description</span></div>
|
|
</div>
|
|
<p class="illus">An illustration, not a screenshot.</p>
|
|
</div>
|
|
</article>
|
|
|
|
<article id="d-test" class="has-fig">
|
|
<div>
|
|
<div class="meta"><span class="tag new">New in v3</span><span class="tag">Any time</span></div>
|
|
<h3>Write missing tests</h3>
|
|
<p>Finds source files that no test covers. Once you approve its plan, it writes tests in your project's own style. It never changes source code, and it can read an optional test map.</p>
|
|
<div class="cmd"><pre>/plan2code-test</pre><button class="copy" type="button" data-copy="/plan2code-test" aria-label="Copy /plan2code-test"><span class="label">Copy</span></button></div>
|
|
</div>
|
|
<!-- Illustration, not a screenshot. -->
|
|
<div>
|
|
<div class="mock" role="img" aria-label="Illustration of a list of source files with no test, and a plan waiting for your approval.">
|
|
<strong>Source files with no test</strong>
|
|
<div class="mrow"><span class="pill">no test</span> <span class="mono">a source file</span></div>
|
|
<div class="mrow"><span class="pill">no test</span> <span class="mono">another source file</span></div>
|
|
<div class="mrow"><span class="pill ok">covered</span> <span class="mono">a file with tests</span></div>
|
|
<div class="box"><span class="mono">Plan: tests to write, in your style</span><div class="bar"></div><div class="bar" style="width:70%"></div><span class="pill ok">Approve plan</span></div>
|
|
</div>
|
|
<p class="illus">An illustration, not a screenshot.</p>
|
|
</div>
|
|
</article>
|
|
</div>
|
|
|
|
<div class="row stage2" id="git-board">
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/git-dark.webp">
|
|
<img src="screenshots/git-light.webp" width="2560" height="1600" loading="lazy" alt="The git board on feature/task-endpoints: the Changes tab, badged 3, opens on a Next step card reading Commit 3 files, above the three changed files ticked for the commit. Branches and Sync tabs and a Done with git button sit beside it.">
|
|
</picture>
|
|
<div>
|
|
<h3>The git board</h3>
|
|
<p>Three tabs, <strong>Changes</strong>, <strong>Branches</strong> and <strong>Sync</strong>, and it opens on the one holding your likely next step: commit, pull, push, publish, open a pull request or tidy up branches. That step is one main button. Each tab badges what is waiting on it, a stopped rebase or merge gets one block with every file marked, and nothing is pushed, published or deleted without asking. It never force-pushes.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="s" id="v3" aria-labelledby="v3-title">
|
|
<div class="wrap">
|
|
<h2 id="v3-title">What is new in v3</h2>
|
|
<p class="intro muted">Version 3.0.0 adds a desktop app and what runs inside it, plus two utilities. None of it replaces the page or the terminal flow.</p>
|
|
<ul class="rows">
|
|
<li>
|
|
<h3>The desktop app</h3>
|
|
<div>
|
|
<p>One window: the dashboard as the main surface and your agent in a terminal panel the app owns (Claude Code, Devin, Codex or your own). <strong>New Session</strong> replaces the agent with a fresh one on a brief the app builds from its own record of the session, so in-progress work carries over. <strong>Update skills</strong> brings the installed skills level with the app, and the taskbar shows when Plan2Code needs you. Ask, Workspace, Help, Preferences, Git and Notebook open inside the window.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>The Implementation Loop</h3>
|
|
<div>
|
|
<p>Builds a whole spec phase by phase, each phase in a fresh agent, and writes a report. It lives in the desktop app and replaces the old <code>plan2code-loop</code> CLI. <strong>Set strength per phase</strong> runs each phase on the model and effort of a strength you choose: Thrifty, Balanced, Best or Match my session. The loop strip and the report show what each phase ran on.</p>
|
|
<!-- Illustration, not a screenshot: the loop strip. -->
|
|
<ol class="strip" role="img" aria-label="Illustration of the loop strip: four phases, each showing the strength it ran on.">
|
|
<li class="done"><b>Phase 1</b><span class="bdg b">Balanced</span><small>done</small></li>
|
|
<li class="done"><b>Phase 2</b><span class="bdg s">Best</span><small>done</small></li>
|
|
<li class="run"><b>Phase 3</b><span class="bdg b">Balanced</span><small>running</small></li>
|
|
<li><b>Phase 4</b><span class="bdg t">Thrifty</span><small>waiting</small></li>
|
|
</ol>
|
|
<p class="illus">An illustration of the loop strip, not a screenshot.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>Helpers matched to the job</h3>
|
|
<div>
|
|
<p>Helpers (subagents) run at a strength and effort chosen for their task, never tied to one vendor. Plan and Revise Plan offer them now. A Subagents dialog turns them on or off per project and skill, with a Helper strength choice (Balanced, Thrifty, Best or Match my session), and a Subagents tab shows what each helper ran with.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>Bring any agent</h3>
|
|
<div>
|
|
<p>Add your own agent CLI under User Preferences. A first-run setup page shows which built-in agents are found, install commands for your OS, and a Check again button.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>Get a PR ready</h3>
|
|
<div>
|
|
<p><code>/plan2code-pr-prep</code> picks the checks that cover your branch's changes, runs them, says Ready, Ready with notes or Not ready, and writes a PR description to copy. It never commits, pushes or opens the PR.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>Write missing tests</h3>
|
|
<div>
|
|
<p><code>/plan2code-test</code> finds source files no test covers and, once you approve its plan, writes tests in the project's own style. It never changes source code.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>Activities</h3>
|
|
<div>
|
|
<p>A die in the console's top bar opens thirteen small games to play while you wait. A game pauses the moment Plan2Code needs you. They are off until you turn them on.</p>
|
|
</div>
|
|
</li>
|
|
<li>
|
|
<h3>Start from your Notebook</h3>
|
|
<div>
|
|
<p>Start Pathfinder, Plan, Quick Task or Revise plan from a Notebook tab. The agent reads the tab only once you send it.</p>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="s alt" id="session" aria-labelledby="session-title">
|
|
<div class="wrap">
|
|
<h2 id="session-title">How a session goes</h2>
|
|
<p class="intro muted">One page, from the first card to the sign-off. Your agent does the work in its terminal (or the app's terminal panel); you do your part here.</p>
|
|
|
|
<div class="row">
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/question-dark.webp">
|
|
<img src="screenshots/question-light.webp" width="2560" height="1600" loading="lazy" alt="A Plan question card, How tasks are paged, with three options, the first marked Suggested, each with its trade-off underneath.">
|
|
</picture>
|
|
<div>
|
|
<div class="kk"><span class="k" aria-hidden="true">1</span><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="wave"><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 class="arms"><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></svg></div>
|
|
<h3>Pick a card, answer on the page</h3>
|
|
<p>Pick a step on the dashboard and it starts right there. Questions arrive a few at a time, each option with its trade-off written under it.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="row flip">
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/build-dark.webp">
|
|
<img src="screenshots/build-light.webp" width="2560" height="1600" loading="lazy" alt="A phase of a task API being built: 5 of 11 done on the progress bar, and the phase's task list with the first five ticked.">
|
|
</picture>
|
|
<div>
|
|
<div class="kk"><span class="k" aria-hidden="true">2</span><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="work"><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 class="arms"><g class="a-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></svg></div>
|
|
<h3>Watch it build</h3>
|
|
<p>Tasks tick off as they land, and the line beside Planny says what is being worked on right now.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="row">
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/signoff-dark.webp">
|
|
<img src="screenshots/signoff-light.webp" width="2560" height="1600" loading="lazy" 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.">
|
|
</picture>
|
|
<div>
|
|
<div class="kk"><span class="k" aria-hidden="true">3</span><svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="up"><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 class="arms"><g class="a-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></g></svg></div>
|
|
<h3>Sign off</h3>
|
|
<p>Read the completion report, then approve the phase or ask for changes. In Implement, you can also have the code reviewed first.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="s" id="features" aria-labelledby="features-title">
|
|
<div class="wrap">
|
|
<h2 id="features-title">What the page gives you</h2>
|
|
<p class="intro muted">The same workflow as the terminal, with more room to think. The page is there whether or not you use the desktop app.</p>
|
|
<div class="feat">
|
|
<div><h3>Trade-offs in plain view</h3><p>Questions arrive a few at a time, each option with its trade-off written under it, so you choose rather than guess.</p></div>
|
|
<div><h3>Review before you approve</h3><p>Review the code first, on the sign-off card, reviews exactly the files the phase changed. You tick which findings get fixed, then approve.</p></div>
|
|
<div><h3>The Ask tab</h3><p>A chat beside the cards for anything you want to know. It is answered at the agent's next check-in and never holds up your answers.</p></div>
|
|
<div><h3>Attachments on notes</h3><p>Paste a screenshot or attach a document to a note on any question, and show instead of describe.</p></div>
|
|
<div><h3>A notebook of your own</h3><p>A private pad for each project folder, in Markdown with pictures. It never goes into your project, and the agent reads a tab only when you start a workflow from it and send it.</p></div>
|
|
<div><h3>Workspace folders</h3><p>Add a shared library or a design folder as read-only context, and point at it by its <code>@name</code>.</p></div>
|
|
<div><h3>Session meter</h3><p>A ring in the top bar turns from green to red as a session grows long, and suggests when a fresh one would serve you better.</p></div>
|
|
<div><h3>Runs on your machine</h3><p>A small program Plan2Code starts for you serves the page on <code>127.0.0.1</code>. No account, no dependencies, and nothing leaves your computer.</p></div>
|
|
</div>
|
|
<div class="feat-shots">
|
|
<figure>
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/ask-dark.webp">
|
|
<img src="screenshots/ask-light.webp" width="2560" height="1600" loading="lazy" alt="The Ask tab: the question Where are tasks paged? and Plan2Code's answer naming the file.">
|
|
</picture>
|
|
<figcaption>The Ask tab, answered between tasks.</figcaption>
|
|
</figure>
|
|
<figure>
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/finish-dark.webp">
|
|
<img src="screenshots/finish-light.webp" width="2560" height="1600" loading="lazy" alt="The finished screen after a phase: what happened, the next command with a Copy button, and a Back to the dashboard button.">
|
|
</picture>
|
|
<figcaption>Every ending says what to run next.</figcaption>
|
|
</figure>
|
|
<figure style="grid-column:1/-1;max-width:calc(50% - 12px);justify-self:center">
|
|
<picture class="shot">
|
|
<source media="(prefers-color-scheme: dark)" srcset="screenshots/notepad-dark.webp">
|
|
<img src="screenshots/notepad-light.webp" width="2560" height="1600" loading="lazy" alt="The Notebook open over a question: two named tabs, and a heading, bullets and bold styled in place as they are typed.">
|
|
</picture>
|
|
<figcaption>Your own notebook, private to the folder.</figcaption>
|
|
</figure>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="s alt" id="rules" aria-labelledby="rules-title">
|
|
<div class="wrap">
|
|
<h2 id="rules-title">The rules</h2>
|
|
<p class="intro muted">Four rules do most of the work.</p>
|
|
<ol class="rules">
|
|
<li><div><h3>Keep each session short.</h3><p>Chaining a couple of small skills on the dashboard is fine. Start a fresh console session when the session meter turns red, and always before a big planning or build step. The specs on disk carry everything between sessions.</p></div></li>
|
|
<li><div><h3>No code until the plan hits 90% confidence.</h3><p>Step 1 will not finalize below the threshold. Under it, the agent keeps asking and keeps reading your code, and writes every assumption down where you can argue with it.</p></div></li>
|
|
<li><div><h3>Checkboxes are the state, not the chat.</h3><p>Progress lives in the spec files. Any agent, any session, resumes cold from them.</p></div></li>
|
|
<li><div><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></div></li>
|
|
</ol>
|
|
<div class="calm">
|
|
<svg class="planny" viewBox="0 0 22 30" aria-hidden="true" focusable="false" data-mood="none"><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 class="arms"></g></svg>
|
|
<p>When the agent is not running, you lose nothing. The plan, the tasks and the ticks are files in your repo, so a fresh session picks up where the last one stopped.</p>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="s" id="terminal" aria-labelledby="terminal-title">
|
|
<div class="wrap term-band">
|
|
<div>
|
|
<h2 id="terminal-title">Prefer the terminal?</h2>
|
|
<p class="muted">The desktop app is optional, and the workflow, the specs and the skills are the same without it. <code>plan2code --classic</code> keeps the terminal flow, and every skill also runs right in the terminal. Each one asks at the start whether you want the page or the terminal; add <code>--web</code> to skip the question and go straight to the page.</p>
|
|
<p><a href="https://github.com/jparkerweb/plan2code#prefer-the-terminal">See every command in the README</a></p>
|
|
</div>
|
|
<pre class="termbox"><span class="d"># the terminal flow</span>
|
|
plan2code --classic
|
|
<span class="d"># or, in your agent</span>
|
|
/plan2code
|
|
/plan2code-1-plan --web plan a REST API for tasks</pre>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="s alt close" id="install" aria-labelledby="install-title">
|
|
<div class="narrow">
|
|
<h2 id="install-title">Install</h2>
|
|
<p class="muted">Run it again any time to update.</p>
|
|
<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>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"><svg class="clip" viewBox="0 0 24 24" aria-hidden="true"><rect x="9" y="9" width="11" height="12" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg><svg class="tick" viewBox="0 0 24 24" aria-hidden="true"><path d="M4 12.5 9.5 18 20 6.5"/></svg><span class="label">Copy</span></button>
|
|
</div>
|
|
<p class="then">then, from your project, run <code>plan2code</code> (Claude Code, Devin or Codex), or type <code>/plan2code</code> in your agent (<code>$plan2code</code> in Codex).</p>
|
|
<p class="then">It always opens a menu; 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.</p>
|
|
<p class="app-note">The installer also offers the desktop app. Answer Y to install it: the file is checked against the release's checksum before it is kept. There are builds for Windows x64, macOS (Apple silicon and Intel) and Linux x64, and the app needs Node.js 18 or newer. Plan2Code works without it.</p>
|
|
</div>
|
|
</section>
|
|
|
|
</main>
|
|
|
|
<footer>
|
|
<div class="wrap">
|
|
<a href="https://github.com/jparkerweb/plan2code">Plan2Code on GitHub</a>
|
|
<span>MIT license</span>
|
|
<a href="https://github.com/jparkerweb/plan2code/releases">Releases</a>
|
|
</div>
|
|
</footer>
|
|
|
|
<script>
|
|
(function () {
|
|
var CMD = 'npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git';
|
|
var $ = function (i) { return document.getElementById(i); };
|
|
|
|
/* Copy buttons: the install command, or the slash command in data-copy. */
|
|
function wire(btn) {
|
|
var label = btn.querySelector('.label');
|
|
var text = btn.getAttribute('data-copy') || CMD;
|
|
var timer;
|
|
function done() {
|
|
btn.classList.add('-done');
|
|
label.textContent = 'Copied';
|
|
clearTimeout(timer);
|
|
timer = setTimeout(function () {
|
|
btn.classList.remove('-done');
|
|
label.textContent = 'Copy';
|
|
}, 1800);
|
|
}
|
|
function fallback() {
|
|
var ta = document.createElement('textarea');
|
|
ta.value = text;
|
|
ta.setAttribute('readonly', '');
|
|
ta.style.position = 'fixed';
|
|
ta.style.opacity = '0';
|
|
document.body.appendChild(ta);
|
|
ta.select();
|
|
try { document.execCommand('copy'); done(); } catch (e) {}
|
|
document.body.removeChild(ta);
|
|
}
|
|
btn.addEventListener('click', function () {
|
|
if (navigator.clipboard && navigator.clipboard.writeText) {
|
|
navigator.clipboard.writeText(text).then(done, fallback);
|
|
} else {
|
|
fallback();
|
|
}
|
|
});
|
|
}
|
|
var buttons = document.querySelectorAll('.copy');
|
|
for (var i = 0; i < buttons.length; i++) wire(buttons[i]);
|
|
|
|
/* The desktop window illustration. */
|
|
var win = $('win'), tb = $('tb'), pl = $('pl'), dot = $('dot'), ns = $('ns'), flow = $('flow'), stText = $('stText');
|
|
var agent = 'Claude Code', lastDock = 'right', busy = false;
|
|
function esc(s) { return s.replace(/&/g, '&').replace(/</g, '<'); }
|
|
function lines(arr) {
|
|
tb.innerHTML = arr.map(function (l) { return '<span class="' + l[0] + '">' + esc(l[1]) + '</span>'; }).join('\n') + '\n<span class="cur"></span>';
|
|
}
|
|
function base() {
|
|
lines([
|
|
['d', '$ ' + agent.toLowerCase().replace(/ /g, '-')],
|
|
['g', 'Plan2Code skills loaded'],
|
|
['b', '> /plan2code-3-implement'],
|
|
['', 'Phase 2: 4 of 6 tasks ticked'],
|
|
['', 'Checking the last task...'],
|
|
['d', 'Waiting for your sign-off on the page']
|
|
]);
|
|
}
|
|
function dock(d) {
|
|
win.setAttribute('data-dock', d);
|
|
if (d !== 'hidden') lastDock = d;
|
|
var bs = document.querySelectorAll('.seg button');
|
|
for (var k = 0; k < bs.length; k++) bs[k].setAttribute('aria-pressed', String(bs[k].getAttribute('data-dock') === d));
|
|
}
|
|
var segs = document.querySelectorAll('.seg button');
|
|
for (var s = 0; s < segs.length; s++) (function (b) {
|
|
b.addEventListener('click', function () { dock(b.getAttribute('data-dock')); });
|
|
})(segs[s]);
|
|
$('vt').addEventListener('click', function () {
|
|
dock(lastDock);
|
|
var f = document.querySelector('.seg button[aria-pressed="true"]');
|
|
if (f) f.focus();
|
|
});
|
|
$('agentSel').addEventListener('change', function (e) {
|
|
agent = e.target.value;
|
|
$('termTitle').textContent = 'Agent Terminal: ' + agent;
|
|
if (!busy) base();
|
|
});
|
|
function mood(m, t) { pl.setAttribute('data-mood', m); stText.textContent = t; }
|
|
function step(n, st) {
|
|
var li = $('f' + n);
|
|
li.setAttribute('data-s', st);
|
|
li.firstChild.textContent = st === 'done' ? '✓' : String(n);
|
|
}
|
|
ns.addEventListener('click', function () {
|
|
if (busy) return;
|
|
busy = true; ns.disabled = true;
|
|
step(1, ''); step(2, ''); step(3, '');
|
|
flow.hidden = false;
|
|
dot.setAttribute('data-s', 'busy');
|
|
var a = agent;
|
|
step(1, 'now'); mood('wave', 'Writing a brief from this session');
|
|
lines([['d', '$ plan2code: building the brief'], ['', 'Reading the session record...'], ['', 'Open task, phase 2: carried into the brief']]);
|
|
setTimeout(function () {
|
|
step(1, 'done'); step(2, 'now'); dot.setAttribute('data-s', 'off');
|
|
mood('none', 'Agent stopped. Starting a fresh one');
|
|
lines([['d', 'Previous ' + a + ' session closed'], ['', 'Starting a fresh ' + a + '...']]);
|
|
}, 1500);
|
|
setTimeout(function () {
|
|
step(2, 'done'); step(3, 'now'); dot.setAttribute('data-s', 'busy');
|
|
mood('rest', 'Fresh agent is reading the brief');
|
|
lines([['g', 'Fresh ' + a + ' started'], ['', 'Reading the brief...'], ['', 'Phase 2: 4 of 6 tasks ticked, picking up at task 5']]);
|
|
}, 2900);
|
|
setTimeout(function () {
|
|
step(3, 'done'); dot.setAttribute('data-s', 'on');
|
|
mood('up', 'Work carried over. Back to it');
|
|
lines([['g', 'Work carried over'], ['b', '> continuing phase 2, task 5'], ['d', 'Waiting for your sign-off on the page']]);
|
|
}, 4300);
|
|
setTimeout(function () {
|
|
flow.hidden = true;
|
|
mood('rest', 'Agent running. Planny is keeping an eye on it.');
|
|
ns.disabled = false; busy = false; base();
|
|
}, 6600);
|
|
});
|
|
base();
|
|
|
|
/* The workflow map: select a station, show its panel, move Planny beside it. */
|
|
var stations = [].slice.call(document.querySelectorAll('.mst'));
|
|
var arts = [].slice.call($('panel').querySelectorAll('article'));
|
|
var rider = $('rider'), riderPl = rider.querySelector('.planny'), box = $('mapbox');
|
|
var current = null;
|
|
function place() {
|
|
if (!current) return;
|
|
var d = current.querySelector('.mdot').getBoundingClientRect(), b = box.getBoundingClientRect();
|
|
var w = rider.offsetWidth, h = rider.offsetHeight, x, y;
|
|
if (window.matchMedia('(max-width:900px)').matches) {
|
|
x = d.left - b.left - w - 8; y = d.top - b.top + d.height / 2 - h / 2;
|
|
} else {
|
|
x = d.left - b.left + d.width / 2 - w / 2; y = d.top - b.top - h - 3;
|
|
}
|
|
rider.style.transform = 'translate(' + Math.round(x) + 'px,' + Math.round(y) + 'px)';
|
|
}
|
|
function select(st, hash) {
|
|
var id = st.getAttribute('href').slice(1);
|
|
stations.forEach(function (o) { o.removeAttribute('aria-current'); });
|
|
st.setAttribute('aria-current', 'true');
|
|
arts.forEach(function (a) { a.hidden = (a.id !== id); });
|
|
riderPl.setAttribute('data-mood', st.getAttribute('data-mood') || 'rest');
|
|
current = st; place();
|
|
if (hash && history.replaceState) history.replaceState(null, '', '#' + id);
|
|
}
|
|
stations.forEach(function (st, i) {
|
|
st.addEventListener('click', function (e) { e.preventDefault(); select(st, true); });
|
|
st.addEventListener('focus', function () { if (current !== st) select(st, false); });
|
|
st.addEventListener('keydown', function (e) {
|
|
var n = null;
|
|
if (e.key === 'ArrowRight' || e.key === 'ArrowDown') n = stations[i + 1] || stations[0];
|
|
if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') n = stations[i - 1] || stations[stations.length - 1];
|
|
if (n) { e.preventDefault(); n.focus(); }
|
|
});
|
|
});
|
|
var hs = location.hash && document.querySelector('.mst[href="' + location.hash + '"]');
|
|
select(hs || document.querySelector('.mst[href="#d-plan"]'), false);
|
|
window.addEventListener('resize', place);
|
|
window.addEventListener('load', place);
|
|
if (window.ResizeObserver) new ResizeObserver(place).observe(box);
|
|
})();
|
|
</script>
|
|
</body>
|
|
</html>
|