Guided Learning - #1

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

…oach-me

Rename `guided-coding-implement-and-learn-by-example` to
`guided-coding-implement-show-me` and `guided-coding-implement-and-learn-by-solving`
to `guided-coding-implement-coach-me`. The previous names described the mechanism
rather than the choice a user has to make, and were too long to type as slash
commands. The new names sit alongside `guided-coding-implement` so the three paths
through the Implementing Phase read as one family.

Align both skills with `guided-coding-implement`: same target selection, same frozen
plan verification, and no restated reading list.

Add `guided-coding-implement` to the portable and Claude skill name lists in
PackageValidationTests, which were missed when the skill was introduced, and to the
README skill table. Regenerate the Claude adapter.

Co-Authored-By: Claude Opus 5 <[email protected]>

The three implement skills carry an identical `Establish the Target` section.
Skills are standalone units, so the duplication is intended, but nothing kept
the copies in sync.

Compare the skills against each other rather than against an expected string,
so that deliberate rewording passes once it is applied everywhere and only a
one-sided edit fails. Sections are matched by heading text with the leading
number stripped, because the numbering differs per skill.

Co-Authored-By: Claude Opus 5 <[email protected]>

…sues

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

The show-me and coach-me skills now read ~/.guided-learning/profile.md
before creating the milestone roadmap and update it after each milestone.
Both skills ship an empty profile template as an asset, which also carries
the agent's rules for reading and maintaining the file.

Show-me builds its roadmap layer by layer, coach-me from vertical slices,
and every milestone includes its tests. Tests keep the shared profile
sections and the duplicated templates identical across both skills.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

The profile at ~/.guided-learning/profile.md now holds only data: goals,
preferences, and the knowledge tree. The rules for reading and maintaining
it moved from the template into the shared skill sections, so improving
the skills also reaches existing profiles.

The profile folder is a mandatory git repository on a single main branch.
Commit history replaces the records, the Updated line, node dates, and
evidence fields. Carry Forward, Recurring Themes, and decay are gone.

Before the roadmap, the skills check the user's goals and preferences.
Technology nodes follow ecosystem, technology, and area, and discipline
nodes follow a fixed list of roots, then topic and subarea.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Signed-off-by: Kenny Pflug <[email protected]>

Remove filler from the intro, roadmap, milestone, and plan-issue sections
of the show-me and coach-me skills without dropping any instruction. Both
skills now share the same wording for plan issues, and coach-me states its
Beginning-stage exception next to the rule about providing code.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

Milestone design is left to the agent, so the profile keeps only
preferences and knowledge. The skills ask for preferences in the session
that creates the profile and otherwise restate them with the roadmap.

Also remove the stage-mismatch warning, drop the "one question, not a
quiz" aside in show-me, and let users tick Acceptance Criteria before
committing so that the ticks land in the milestone's commit.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

The Guided Learning skills now share every section by default, and only
the sections declared as intentionally different may diverge. A second
test keeps that declaration from going stale. Lists that follow a shared
lead-in line, such as the timestamp commands in freeze-plan and
write-deviations, must also stay identical.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

Users now tick only the Acceptance Criteria a milestone fully satisfies,
as early layers in show-me often complete none. Plan issues are worked
out and taught rather than fixed by the agent, and each milestone adds
nodes for areas the profile does not cover yet.

Also drop the undefined term "pass" and coach-me's quiz aside.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

The README explains which Guided Learning skill fits which stage and how
the private, git-backed profile at ~/.guided-learning/ works. The
changelog records the profile, and the manifests gain a "learning"
keyword.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>

Signed-off-by: Kenny Pflug <[email protected]>