PyAutoScientist is a working, opinionated reference implementation of an
AI-agent development organism for human-led, natural-language software
development: a set of git repositories called organs (Brain, Mind,
Cortex, Memory and the rest; {doc}the organism <concepts/organism> lists
them all) through which you lead a multi-repo project in plain English. You
describe what you want; AI agents plan, implement, test, gate and release
it; you make every judgment call.
It is not a framework you install. It is the live system that develops the PyAuto astronomy stack every day — tens of repositories, nightly releases, hundreds of tasks — documented so that you can fork it and lead your own, driving projects that have nothing to do with astronomy.
- Every piece of work starts as a plain-English markdown file you write in the Mind.
- The Brain classifies it, plans it, and routes it through specialist agents.
- Work happens on task worktrees and ships as pull requests, gated by the Heart's health verdict.
- The Hands package and release what merges.
- The Memory holds the long-term domain knowledge the agents consult.
You fork the three framework organs (Brain, Heart, Hands), replace a small
set of declared config surfaces with your own repositories, write your own
Mind and Memory from the documented shapes, and git pull upstream
improvements cleanly from then on. One upstream, N private organisms — never
a shared deployment. The {doc}adoption guide <adoption/guide> is the
walkthrough; {doc}adoption/config_surfaces is the exact contract.
Be aware of what this is before investing: PyAutoScientist assumes
Claude Code (skills and commands installed under ~/.claude), the
GitHub CLI, a trunk-based single-maintainer flow with task worktrees,
and GitHub Actions + PyPI for releases. Those assumptions are the product,
not incidental debt — they are stated plainly in the adoption guide.
:maxdepth: 2
concepts/organism
concepts/agents
concepts/workflow
:caption: The organs
:maxdepth: 1
organs/brain
organs/mind
organs/cortex
organs/memory
organs/eyes
organs/ears
organs/heart
organs/hands
organs/pulse
organs/insight
organs/dna
organs/nerves
organs/broca
organs/gut
:caption: Adopting it
:maxdepth: 1
satellites
adoption/guide
adoption/config_surfaces
standards
board-sizing
board-navigation
board-orchestration
example
:hidden:
agent_failure_modes
codex_usage
agent_reference
context_efficiency
agent_harness_smoke
workspace_layout