PyAutoScientist#
PyAutoScientist is a working, opinionated reference implementation of an AI-agent development organism: a set of five git repositories — Mind, Brain, Heart, Hands, Memory — that together let AI coding agents plan, implement, test, gate and release software across a multi-repo project, with a human checkpointing the judgment calls.
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 run your own, driving projects that have nothing to do with astronomy.
The idea in five lines#
Every piece of work starts as a plain-English markdown file 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.
What adopting it means#
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 adoption guide is the
walkthrough; The declared 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.
Reading order#
The organs