Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions ORGANISM.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ The **one canonical page** for the organs, their boundaries, and the call
chain. Every other repo links here instead of restating this — if you are
editing organism prose anywhere else, stop and edit this file.

The organism is an agentic AI ecosystem for **human-led, natural-language
software development**: you describe what you want in plain English, the
organs plan, build, test and release it, and you make every judgment call.

## The organs

| Organ | Repo | Role and boundary |
Expand Down
5 changes: 3 additions & 2 deletions docs/concepts/workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,9 @@ idea → prompt file → issue → worktree → PR(s) → merge →
(Mind) (GitHub) (isolated) (gated) (human) (Mind)
```

1. **Intent is written down first.** A task starts as a markdown file in the
Mind under `<work-type>/<target>/<name>.md` — plain English, no template.
1. **Intent is written down first.** A task starts as a markdown file you
write in the Mind under `<work-type>/<target>/<name>.md` — plain English,
no template.
The work-type folder (`feature/`, `bug/`, `refactor/`, `docs/`, …) tells
the Brain what kind of reasoning the task needs.
2. **`start_dev`** routes the prompt through the Brain's Feature Agent:
Expand Down
14 changes: 8 additions & 6 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,22 @@
# 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.
**AI-agent development organism** for human-led, natural-language software
development: a set of five git repositories — Mind, Brain, Heart, Hands,
Memory — 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](https://pyautolabs.github.io) 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
can **fork it and lead 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**.
- 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.
Expand Down
Loading