Skip to content

Commit e5366c8

Browse files
Jammy2211claude
authored andcommitted
docs: human-led natural-language tone sweep (PyAutoBrain#81)
Reword organism framing to the human-led voice settled on the org front page: you lead in plain English, agents plan/build/test/release, you make every judgment call. Tone only - no boundary changes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 5bd2ea6 commit e5366c8

4 files changed

Lines changed: 19 additions & 11 deletions

File tree

ORGANISM.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ The **one canonical page** for the organs, their boundaries, and the call
44
chain. Every other repo links here instead of restating this — if you are
55
editing organism prose anywhere else, stop and edit this file.
66

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

913
| Organ | Repo | Role and boundary |

README.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,9 @@ gets done: it classifies incoming tasks, plans them, and routes them to
55
specialist agents, delegating execution to the other organs. It holds no
66
state, runs no health checks, and never releases anything itself.
77

8-
The organism is described once in [ORGANISM.md](ORGANISM.md). The short
9-
version:
8+
The organism — an agentic AI ecosystem for human-led, natural-language
9+
software development — is described once in [ORGANISM.md](ORGANISM.md). The
10+
short version:
1011

1112
| Organ | Repo | Job |
1213
|-------|------|-----|
@@ -31,5 +32,5 @@ bash bin/install.sh # symlink every organ's skills into ~/.claude
3132
Runs straight from its checkout — no pip install. Agent contracts and the
3233
organ boundary are in [AGENTS.md](AGENTS.md); how much a run may do without
3334
a human is the autonomy contract, [AUTONOMY.md](AUTONOMY.md). The full
34-
organism documentation — including how to fork and run your own — is at
35+
organism documentation — including how to fork it and lead your own — is at
3536
<https://pyautoscientist.readthedocs.io> (source: `docs/`).

docs/concepts/workflow.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,9 @@ idea → prompt file → issue → worktree → PR(s) → merge →
77
(Mind) (GitHub) (isolated) (gated) (human) (Mind)
88
```
99

10-
1. **Intent is written down first.** A task starts as a markdown file in the
11-
Mind under `<work-type>/<target>/<name>.md` — plain English, no template.
10+
1. **Intent is written down first.** A task starts as a markdown file you
11+
write in the Mind under `<work-type>/<target>/<name>.md` — plain English,
12+
no template.
1213
The work-type folder (`feature/`, `bug/`, `refactor/`, `docs/`, …) tells
1314
the Brain what kind of reasoning the task needs.
1415
2. **`start_dev`** routes the prompt through the Brain's Feature Agent:

docs/index.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,22 @@
11
# PyAutoScientist
22

33
PyAutoScientist is a working, opinionated reference implementation of an
4-
**AI-agent development organism**: a set of five git repositories — Mind,
5-
Brain, Heart, Hands, Memory — that together let AI coding agents plan,
6-
implement, test, gate and release software across a multi-repo project,
7-
with a human checkpointing the judgment calls.
4+
**AI-agent development organism** for human-led, natural-language software
5+
development: a set of five git repositories — Mind, Brain, Heart, Hands,
6+
Memory — through which you lead a multi-repo project in plain English. You
7+
describe what you want; AI agents plan, implement, test, gate and release
8+
it; you make every judgment call.
89

910
It is not a framework you install. It is the live system that develops the
1011
[PyAuto astronomy stack](https://pyautolabs.github.io) every day — tens of
1112
repositories, nightly releases, hundreds of tasks — documented so that you
12-
can **fork it and run your own**, driving projects that have nothing to do
13+
can **fork it and lead your own**, driving projects that have nothing to do
1314
with astronomy.
1415

1516
## The idea in five lines
1617

17-
- Every piece of work starts as a plain-English markdown file in the **Mind**.
18+
- Every piece of work starts as a plain-English markdown file you write in
19+
the **Mind**.
1820
- The **Brain** classifies it, plans it, and routes it through specialist agents.
1921
- Work happens on task worktrees and ships as pull requests, gated by the
2022
**Heart**'s health verdict.

0 commit comments

Comments
 (0)