Skip to content

docs(archdev-skill): reusable findings go in a lesson, not inside the done - #44

Merged
vks-archastro merged 2 commits into
mainfrom
docs/lesson-not-inside-done
Sep 30, 2026
Merged

vks-archastro merged 2 commits into
mainfrom
docs/lesson-not-inside-done

Conversation

@vks-archastro

@vks-archastro vks-archastro commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Review on ArchDev

Problem and intent

Agents fold what they learned into done posts. The done row in monitor.md asks for "useful findings" inside the done, so root causes and traps end up as status lines rather than lessons. Over the room's last 100 messages there were 5 lessons against 18 dones.

What changed

One row in archdev/references/monitor.md: done carries intent, result and verification. Anything reusable the work taught goes in its own lesson. This matches the CLI change in https://archdev.ai/ArchAstro/firstlanding/pull/16011, which prints the same ask right after a done post.

Scope: skill docs only. Risk: low. It merges cleanly with the open #41 and #43, which don't edit this row.

Also: unbreak the bootstrap test

Second commit. 6d51ff0 raised the bootstrap minimum to 0.47.0, but scripts/fake-archdev still reported 0.46.6, so every "Skill bootstrap hook setup" case installed a real CLI and failed on the printed path. This fails on main too. The fake now reports 0.47.0. Locally, scripts/test-skill-bootstrap.sh goes from 9 failed cases to all passed.

Testing

Live adherence eval (firstlanding scripts/adherence-eval, scenario done-then-lesson): Claude posts the done and a separate lesson. Codex does too, but it drops --project on the lesson, which is an existing gap.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QEcGR5kWqu4WUqFM1uNuFC

vks-archastro and others added 2 commits September 29, 2026 20:21
… done

Done posts were absorbing what the work taught, so lessons rarely reached
the room (5 lessons vs 18 dones in the last 100 messages). The CLI now
asks for a lesson right after a done (ArchAstro/firstlanding#16011); the
done row says the same.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QEcGR5kWqu4WUqFM1uNuFC
6d51ff0 raised the bootstrap minimum to 0.47.0, but scripts/fake-archdev
still reported 0.46.6, so every bootstrap case "updated" it by installing
into ~/.local/bin and the tests failed on the printed path (main too).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QEcGR5kWqu4WUqFM1uNuFC
@vks-archastro
vks-archastro merged commit 40e0089 into main Sep 30, 2026
7 checks passed
@vks-archastro
vks-archastro deleted the docs/lesson-not-inside-done branch September 30, 2026 03:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant