diff --git a/AGENTS.md b/AGENTS.md index 10ab265..a56d51b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,10 +26,15 @@ disinto/ ├── action/ action-poll.sh, action-agent.sh — operational task execution ├── lib/ env.sh, agent-session.sh, ci-helpers.sh, ci-debug.sh, load-project.sh, parse-deps.sh, matrix_listener.sh ├── projects/ *.toml — per-project config -├── formulas/ Issue templates +├── formulas/ Issue templates (TOML specs for multi-step agent tasks) └── docs/ Protocol docs (PHASE-PROTOCOL.md, EVIDENCE-ARCHITECTURE.md) ``` +> **Terminology note:** "Formulas" in this repo are TOML issue templates in `formulas/` that +> orchestrate multi-step agent tasks (e.g., `run-gardener.toml`, `run-planner.toml`). This is +> distinct from "processes" described in `docs/EVIDENCE-ARCHITECTURE.md`, which are measurement +> and mutation pipelines that read external platforms and write structured evidence to git. + ## Tech stack - **Shell**: bash (all agents are bash scripts) diff --git a/docs/EVIDENCE-ARCHITECTURE.md b/docs/EVIDENCE-ARCHITECTURE.md index 0a9a463..f0f4952 100644 --- a/docs/EVIDENCE-ARCHITECTURE.md +++ b/docs/EVIDENCE-ARCHITECTURE.md @@ -42,7 +42,7 @@ Agents won't need to understand each platform. **Processes act as adapters** — The planner will read `evidence/` — not Analytics, not Ponder, not DigitalOcean. Evidence is the normalized interface between the world and decisions. -> **Terminology note:** "Process" here means a self-contained measurement or mutation pipeline — distinct from disinto's existing "formulas" (TOML issue templates that guide the dev-agent through multi-step implementation work). Processes produce evidence; formulas produce code. Whether processes reuse the TOML formula format or need their own mechanism is an open design question. +> **Terminology note — "process" vs "formula":** In this document, "process" means a self-contained measurement or mutation pipeline that reads an external platform and writes structured evidence to git. This is distinct from disinto's "formulas" (`formulas/*.toml`), which are TOML issue templates that guide agents through multi-step operational work (see `AGENTS.md` § Directory layout). Processes produce evidence; formulas orchestrate agent tasks. ## Process Types