Add Learning, move tool folders under .plan2code, and the Loop, Snake and console changes

AI Assisted
This commit is contained in:
jparkerweb committed 2026-11-13 23:29:12 -08:00
1 parent de8a05b958
commit bb5bd5986d
87 files changed
+9163 -256

No files matched your search

+211 -10
View File
@@ -446,6 +446,13 @@
<circle cx="14.5" cy="11" r="1.5" />
<path d="M10 19v2M12 19v2M14 19v2" />
</symbol>
<!-- Update dependencies: a package box with an arrow rising out of it. -->
<symbol id="ci-deps" viewBox="0 0 24 24" fill="none">
<path d="M4 10l8 4 8-4" />
<path d="M4 10v8l8 4 8-4v-8" />
<path d="M12 14v8" />
<path d="M12 2v8M9 5l3-3 3 3" />
</symbol>
<!-- UI Prototype: a framed screen with three sliders. -->
<symbol id="ci-ui-prototype" viewBox="0 0 24 24" fill="none">
<rect x="3" y="4" width="18" height="16" rx="2" />
@@ -974,6 +981,29 @@
</g>
</g>
</svg>
<!-- Update dependencies: he holds up a package box and an arrow rises
out of it, his star following it up. -->
<svg class="pose pose-deps" data-pose="deps" viewBox="0 4 240 216" aria-hidden="true" focusable="false">
<ellipse class="shadow" cx="126" cy="198" rx="44" ry="5" />
<g class="bob">
<g class="dp-arrow">
<path class="lt" d="M187 102 L187 78" />
<path class="lt" d="M179 86 L187 78 L195 86" />
</g>
<path class="dp-box" d="M170 112 L187 104 L204 112 L204 132 L187 140 L170 132 Z" />
<path class="lt" d="M170 112 L187 120 L204 112 M187 120 L187 140" />
<g transform="translate(-14 0)">
<rect class="fl foot f1" x="94" y="179" width="20" height="10" rx="5" />
<rect class="fl foot f2" x="126" y="179" width="20" height="10" rx="5" />
<rect class="sh" x="80" y="72" width="80" height="108" rx="16" />
<path class="ln" d="M80 126 L66 150" /><circle class="fl" cx="66" cy="150" r="5.5" />
<g class="dp-look"><path class="ey blink" d="M126 86 L129.64 94.98 L139.31 95.67 L131.9 101.92 L134.23 111.33 L126 106.2 L117.77 111.33 L120.1 101.92 L112.69 95.67 L122.36 94.98 Z" /></g>
<path class="es" d="M110 120 Q122 129 134 120" />
<line class="ln" x1="160" y1="126" x2="180" y2="134" />
<circle class="fl" cx="184" cy="134" r="5.5" />
</g>
</g>
</svg>
<!-- Agent setup: waving hello at a terminal window, its prompt waiting
for the command line that brings an agent. -->
<svg class="pose pose-setup" data-pose="setup" viewBox="0 4 240 216" aria-hidden="true" focusable="false">
@@ -1046,6 +1076,10 @@
<rect x="4" y="13" width="7" height="7" rx="1.5" />
<rect x="13" y="13" width="7" height="7" rx="1.5" />
</symbol>
<symbol id="hi-learning" viewBox="0 0 24 24" fill="none">
<path d="M9 18h6M10 21h4" />
<path d="M12 3a6 6 0 0 0-3.5 10.9c.6.5 1 1.2 1 2V16h5v-.1c0-.8.4-1.5 1-2A6 6 0 0 0 12 3z" />
</symbol>
<symbol id="hi-meter" viewBox="0 0 24 24" fill="none">
<circle cx="12" cy="12" r="8" />
<path d="M12 4a8 8 0 0 1 7.6 10.5" />
@@ -1065,6 +1099,12 @@
<circle cx="18" cy="7" r="2" />
<path d="M6 7v10M18 9a7 7 0 0 1-7 7H6" />
</symbol>
<symbol id="hi-deps" viewBox="0 0 24 24" fill="none">
<path d="M4 10l8 4 8-4" />
<path d="M4 10v8l8 4 8-4v-8" />
<path d="M12 14v8" />
<path d="M12 2v8M9 5l3-3 3 3" />
</symbol>
<symbol id="hi-subagents" viewBox="0 0 24 24" fill="none">
<circle cx="7" cy="12" r="3.5" />
<circle cx="18" cy="5" r="2" />
@@ -2142,7 +2182,120 @@
</p>
</section>
<!-- Tab 11: Session meter -->
<!-- Tab 11: Learning -->
<section class="help-panel" data-tab="learning">
<h3>Learning</h3>
<p class="help-lead">
Plan2Code can learn your codebase as your team works in it. A step
offers what it learned at the end of a run; you choose what to keep,
and the next run, yours or a teammate's, starts out knowing it.
</p>
<h4>What a lesson is</h4>
<p>
A lesson is one sentence about the code, with why it holds, a kind
(a correction, a convention, how something works, or a command) and
the files it is about. Lessons are about the code, never about you.
</p>
<div class="help-example">
<p><strong>A game's saved number goes through the flat keys in looks.json, never browser storage.</strong></p>
<p>Why: you corrected this while fixing Bounce Road's best score.</p>
<p>About: <code>src/web-console/public/activities/</code></p>
</div>
<h4>The four states</h4>
<p>
The dashboard's Learning row says which one the project is in:
</p>
<ul>
<li>
<strong>Not set up</strong>: nobody has chosen yet. Runs read
nothing, and the first time a run learns something it asks whether
to switch Learning on, showing that lesson.
</li>
<li>
<strong>Off</strong>: the team said no for this project. Runs
work as they did before Learning.
</li>
<li>
<strong>On</strong>: runs read the lessons that fit the files they
work on, and the steps that build, review, test, diagnose or explain code offer
what they learned at the end.
</li>
<li>
<strong>Paused for you</strong>: Learning stays on for the team,
but your own runs neither read nor offer lessons until you switch
<strong>Pause for me</strong> back. Nobody else is affected.
</li>
</ul>
<p>
On and Off are the team's choice and travel with the repository;
the pause is yours alone. <strong>More</strong> on the row switches
Learning off, moves the failure log in <code>AGENTS.md</code> into
lessons, or removes all lessons. When lessons are waiting, a banner
above the title offers <strong>Review</strong>.
</p>
<h4>Choosing what to keep</h4>
<p>
At the end of a run each item gets its own choice, in words that fit
it. Nothing is picked for you.
</p>
<table>
<thead>
<tr>
<th>The item</th>
<th>Its choices</th>
</tr>
</thead>
<tbody>
<tr>
<td>A new lesson</td>
<td>Keep, Reword, Drop</td>
</tr>
<tr>
<td>A saved lesson the step doubts</td>
<td>Keep, Reword, Retire</td>
</tr>
<tr>
<td>A fix to <code>AGENTS.md</code></td>
<td>Apply, Reword, Drop</td>
</tr>
<tr>
<td>A failure log line</td>
<td>Move, Reword and move, Leave in the log</td>
</tr>
<tr>
<td>A new area of code</td>
<td>Create, Rename, Drop</td>
</tr>
</tbody>
</table>
<p>
Nothing is saved without your approval, and nothing is committed for
you: what you keep shows up as changed files, to commit with the rest
of the work. A lesson you have not decided on yet stays waiting for
30 days.
</p>
<h4>Where lessons are kept</h4>
<table>
<thead>
<tr>
<th>Where</th>
<th>What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td>The project's lessons (<code>.plan2code/lessons/</code>, saved with the repository)</td>
<td>The lessons your team kept, one file per area of code plus a general one, and the Learning switch beside them. Commit it; it is how your teammates get them.</td>
</tr>
<tr>
<td>On this machine only (<code>~/.plan2code/</code>)</td>
<td>Lessons waiting for your review and your own pause. Never shared.</td>
</tr>
</tbody>
</table>
</section>
<!-- Tab 12: Session meter -->
<section class="help-panel" data-tab="meter">
<h3>Session meter</h3>
<p class="help-lead">
@@ -2197,7 +2350,7 @@
</p>
</section>
<!-- Tab 12: Watching a build -->
<!-- Tab 13: Watching a build -->
<section class="help-panel" data-tab="build">
<h3>Watching a build</h3>
<p class="help-lead">
@@ -2413,7 +2566,7 @@
</p>
</section>
<!-- Tab 13: The git board -->
<!-- Tab 14: The git board -->
<section class="help-panel" data-tab="git">
<h3>The git board</h3>
<p class="help-lead">
@@ -2537,7 +2690,54 @@
</p>
</section>
<!-- Tab 14: Helpers (subagents) -->
<!-- Tab 15: Update dependencies -->
<section class="help-panel" data-tab="deps">
<h3>Update dependencies</h3>
<p>
The <strong>Update dependencies</strong> card clears a dependency
backlog in one sitting. It scans every manifest in the project (npm,
pnpm and Yarn, Cargo, pip and uv, Go and .NET), labels each update,
applies the ones you pick in batches, runs your install and checks
after each batch, and puts back whatever breaks.
</p>
<h4>The labels</h4>
<ul>
<li><strong>Safe</strong>: in range, notes read, nothing breaking found. All Safe is the suggested pick.</li>
<li><strong>Check first</strong>: a bigger jump or notes it could not read. Applied one at a time, with its own checks.</li>
<li><strong>Warning</strong>: the notes say something your code uses changed. Tick it to write an upgrade brief instead of applying it.</li>
<li><strong>Held back</strong> and <strong>Not scanned</strong>: shown for the record, never picked.</li>
</ul>
<h4>The pick list</h4>
<ul>
<li>Rows are grouped by label. Open a row to read its notes, the breaking lines and where your code calls the package.</li>
<li>The count under the list says how many check rounds your picks take.</li>
<li>Nothing is updated until you send.</li>
</ul>
<h4>When a batch breaks</h4>
<p>
A batch whose install or checks fail is put back exactly as it was
found and reinstalled, then narrowed down to the pick that broke it.
That pick is marked failed with its output; the rest go on. Stopping
mid-run keeps the batches that passed.
</p>
<h4>Upgrade briefs</h4>
<p>
A ticked Warning writes <code>specs/&lt;package&gt;-upgrade/UPGRADE-&lt;date&gt;.md</code>.
The dashboard shows that folder as <strong>Upgrade ready</strong>, with
Quick task and Plan lit: Quick task applies it, Plan plans a big one.
Once Quick task has applied it and its checks pass, the folder shows as
<strong>Upgrade done</strong>, offered for archiving, and deleted after
one confirm like a fixed bug.
</p>
<h4>What it never does</h4>
<p>
It never commits, installs a tool, edits your source code or updates
anything you did not pick. The changed manifests and lockfiles wait
for you to commit.
</p>
</section>
<!-- Tab 16: Helpers (subagents) -->
<section class="help-panel" data-tab="subagents">
<h3>Helpers (subagents)</h3>
<p>
@@ -2624,7 +2824,7 @@
</ul>
</section>
<!-- Tab 15: Ask a quick question -->
<!-- Tab 17: Ask a quick question -->
<section class="help-panel" data-tab="ask">
<h3>Ask a quick question</h3>
<p class="help-lead">
@@ -2728,7 +2928,7 @@
</p>
</section>
<!-- Tab 16: Activities -->
<!-- Tab 18: Activities -->
<section class="help-panel" data-tab="activities">
<h3>Activities</h3>
<p class="help-lead">
@@ -3197,7 +3397,7 @@
</p>
</section>
<!-- Tab 17: Stopping and finishing -->
<!-- Tab 19: Stopping and finishing -->
<section class="help-panel" data-tab="finishing">
<h3>Stopping and finishing</h3>
<p class="help-lead">
@@ -3304,7 +3504,7 @@
</p>
</section>
<!-- Tab 18: Keyboard and preferences -->
<!-- Tab 20: Keyboard and preferences -->
<section class="help-panel" data-tab="prefs">
<h3>Keyboard and preferences</h3>
<p class="help-lead">
@@ -3535,7 +3735,7 @@
</ul>
</section>
<!-- Tab 19: Setting up an agent -->
<!-- Tab 21: Setting up an agent -->
<section class="help-panel" data-tab="setup">
<h3>Setting up an agent</h3>
<p class="help-lead">
@@ -3587,7 +3787,7 @@
</p>
</section>
<!-- Tab 20: Privacy and where things are saved -->
<!-- Tab 22: Privacy and where things are saved -->
<section class="help-panel" data-tab="privacy">
<h3>Privacy and where things are saved</h3>
<p class="help-lead">
@@ -4227,6 +4427,7 @@
</dialog>
<footer class="footer">
<div class="pick-count-live" id="pick-count-live" aria-live="polite"></div>
<div class="footer-summary" id="footer-summary" aria-live="polite">
Nothing to send yet.
</div>