diff --git a/ORGANISM.md b/ORGANISM.md index 9391c5f..fffa8c6 100644 --- a/ORGANISM.md +++ b/ORGANISM.md @@ -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 | diff --git a/docs/concepts/workflow.md b/docs/concepts/workflow.md index 2f549a3..8409b6e 100644 --- a/docs/concepts/workflow.md +++ b/docs/concepts/workflow.md @@ -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 `//.md` — plain English, no template. +1. **Intent is written down first.** A task starts as a markdown file you + write in the Mind under `//.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: diff --git a/docs/index.md b/docs/index.md index bae8dc5..c886bc7 100644 --- a/docs/index.md +++ b/docs/index.md @@ -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.