PyAutoScientist 3b-1: implement spawn + RTD template-family walkthrough

[Jammy2211]

Overview

Implement the fresh-slate generator against the settled spec — --auto supervised (launched in-session 2026-07-10, "continue --auto"). Spec: PyAutoMind/docs/pyautobrain/spawn_spec.md (followed mechanically; ambiguities batch as questions here, never decided ad hoc). Includes the RTD template-family walkthrough folded in by human direction.

Plan (written at launch per the supervised contract)

1. PyAutoMind/scripts/spawn.py — partition tables from the spec as data; walks git ls-files of the live Mind/Memory checkouts; actions KEEP/EMPTY/SKELETON/SUBSTITUTE/DROP, first-match, unmatched→WARN; --write DIR, --check DIR (regenerate+diff), dry-run default; built-in canary privacy test; SPAWNED_FROM provenance; --stamp-family DIR for the family's mechanical layers (LICENSE, CONTRIBUTING, config skeletons — workflows deferred to 3b-2 per spec).
2. Templates published: PyAutoLabs/PyAutoMind-template + PyAutoLabs/PyAutoMemory-template, created private + template-flagged (flip-public parks as a batched question, same pattern as the family).
3. CI drift job: .github/workflows/spawn-drift.yml in PyAutoMind — scheduled + dispatch; clones the templates, runs --check, opens/updates a drift issue on failure.
4. /spawn skill in PyAutoMind/skills/spawn/ (dry-run default; --apply = the sanctioned force-sync publication, human-gated).
5. RTD walkthrough (PyAutoBrain PR): adoption guide gains the "Use this template" path (family + spawned templates as concrete steps); satellites page cross-links.

Ship: one PR per repo (PyAutoMind, PyAutoBrain), normal gate. Heart-ack: the 6-reason YELLOW set acknowledged repeatedly in-session 2026-07-10; binds to exactly that set.

Acceptance (from the spec)

Dry-run zero unmatched-WARN on live repos; canary test passes; --check round-trips clean after --write; repos_sync.py --check runs green inside a written PyAutoMind-template (scratch root); RTD builds warning-free (baseline 0).

🤖 Generated with Claude Code

[Jammy2211]

Implementation complete — parked at ship sign-off per the supervised contract (changes uncommitted in the worktree).

Built + validated:

• scripts/spawn.py — dry-run zero unmatched, canary scan clean, --write → --check round-trips clean, drift negative test fires correctly, repos_sync.py --check exits 0 inside a written PyAutoMind-template. 54 files generated across the two templates.
• Templates published private + template-flagged: PyAutoMind-template · PyAutoMemory-template (SPAWNED_FROM provenance inside).
• spawn_drift.yml (weekly + dispatch), /spawn skill (dry-run default, --apply = the sanctioned force-sync), RTD walkthrough (adoption guide steps rebuilt around "Use this template", satellites cross-link) — Sphinx 0 warnings.

Classifications settled during bring-up (spec amended in the same PR — the dry run surfaced 14 unmatched files + 1 canary hit):

• Mind: dashboard.md/overview.md (generated/personal) + legacy autolens/ prompt dir → DROP; docs/ resolved as work-type SKELETON (the spec's DROP row was self-contradictory — outcome: dir kept, scoping notes dropped).
• Memory: scripts/ + tests/ (citation-validation tooling) → KEEP; legacy paper-notes families (CTI/, DarkMatterModels/, Medical/, LightProFFits/, loose stubs, euclid.sty) → DROP.
• The wiki schema: the live lensing_wiki/CLAUDE.md is lensing-flavoured throughout (title, SLACS/H0LiCOW examples) — a verbatim copy fails the canary. Replaced with a domain-neutral schema asset preserving the full pattern (page types, statuses, frontmatter, claim-support rules). Memory README likewise generated (asset > brittle text surgery).
• Family workspace pin stays 0.1.0 (must MATCH the template library's __version__), not the 0000.0.0.0 placeholder.

Batched questions:

• Ship the 2 PRs (Mind: spawn+spec+CI+skill; Brain: docs walkthrough)?
• Approve the bring-up classifications above?
• Flip PyAutoMind-template + PyAutoMemory-template public?
• Follow-up worth filing: scripts/prompt_sync.sh hardcodes $HOME/Code/PyAutoLabs (ships verbatim in the template; breaks any adopter whose root differs) — micro maintenance prompt to make it self-locating like repos_sync.py?

[Jammy2211]

All four batched questions human-approved in-session. Shipped: PyAutoMind#47 (spawn + spec amendments + drift CI + /spawn skill) and PyAutoBrain#72 (RTD walkthrough, pending-release). Templates flipped public: PyAutoMind-template + PyAutoMemory-template. Follow-up filed: maintenance/pyautomind/prompt_sync_self_locating.md (draft). Awaiting merge.

[Jammy2211]

Both PRs merged 2026-07-10. spawn is live on Mind main; drift CI armed (weekly); adoption walkthrough live on the RTD after its next build. Closing.