mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-17 04:45:33 -08:00
Add Learning, move tool folders under .plan2code, and the Loop, Snake and console changes
AI Assisted
This commit is contained in:
1 parent
de8a05b958
commit
bb5bd5986d
87 files changed
+9163
-256
No files matched your search
@@ -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/<package>-upgrade/UPGRADE-<date>.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>
|
||||
|
||||
Reference in new issue
Block a user