PyAutoScientist Phase 2: RTD docs, adoption guide, CONTRIBUTING, hub card #68

Overview

Phase 2 of the PyAutoScientist generalisation (Phase 1 = #65, merged 2026-07-10): the pyautoscientist ReadTheDocs, sourced from PyAutoBrain/docs/, plus the adoption guide, per-organ CONTRIBUTING disclaimers, and the hub card. All new prose — it documents the skills, it never rewrites them. Scope per PyAutoMind/issued/pyautoscientist_generalisation.md items 5–7 and the settled direction (§4/§8 of the companion assessment — config-diff fork, one live organism, lensing stays as the labelled worked example).

Plan

• RTD skeleton in PyAutoBrain/docs/ (Sphinx + Furo + MyST markdown), published as the pyautoscientist RTD project: concepts (organism, call chain, conductors/faculties, growth rule — sourced from ORGANISM.md, not duplicated), per-organ reference, the category contract (what each satellite kind is for and what the organism expects of it), the adoption guide written against the fork model (fork → replace config surfaces → body map → repos_sync --write → go; prerequisites stated plainly as what PyAutoScientist is), and the worked example (the live lensing instance, labelled).
• Docs CI + theming, matching the pattern shipped for Fit/Galaxy/Lens (2026-07-10): thin docs.yml caller → Heart's reusable docs-build.yml; docs/sphinx_warning_baseline.txt = 0 (fresh tree, strict); shared docs/_static/pyauto.css brand layer; Furo accent pair for pyautoscientist. Heart's reusable workflow gains an additive docs-only case (PyAutoBrain has no pip package — install docs/requirements.txt instead of ./repo[optional,docs]); existing callers unchanged.
• CONTRIBUTING + stability disclaimer in each organ: living reference implementation, main moves fast, copy/fork-and-pull, no compatibility promises. Canonical text in PyAutoBrain; short pointer versions in Mind/Heart/Memory/Build.
• README RTD link — one line added to each organ README (the "once live" hook left by Phase 1), pointing at https://pyautoscientist.readthedocs.io.
• Hub card on pyautolabs.github.io: a PyAutoScientist section (mini-card style) linking the RTD + PyAutoBrain, plus a footer link.
• Human leg (post-merge): import the pyautoscientist project on readthedocs.org pointing at PyAutoLabs/PyAutoBrain.

docs/
├── conf.py                  # Furo + myst_parser, pyautoscientist accents
├── requirements.txt         # sphinx, furo, myst-parser
├── sphinx_warning_baseline.txt   # 0
├── _static/pyauto.css       # shared brand layer (identical file)
├── index.md                 # what PyAutoScientist is; who it's for; honest prerequisites
├── concepts/organism.md     # organs, boundaries, call chain (links ORGANISM.md)
├── concepts/agents.md       # conductors vs faculties, consult DAG, growth rule
├── concepts/workflow.md     # prompt → issue → worktree → ship; autonomy contract
├── organs/{mind,brain,heart,build,memory}.md   # per-organ reference
├── satellites.md            # the category contract
├── adoption/guide.md        # the config-diff fork walkthrough
├── adoption/config_surfaces.md  # declared surfaces + tenant firewall
└── example.md               # the live lensing instance, labelled worked example

Original Prompt

Anchor: PyAutoMind/issued/pyautoscientist_generalisation.md (Phase 2 = items 5–7; full text on #65).

🤖 Generated with Claude Code