From 4e11112c0480901c78d8d96c99f4f60f625eea58 Mon Sep 17 00:00:00 2001 From: Ralph Bean Date: Tue, 7 Jul 2026 11:52:22 -0400 Subject: [PATCH 1/2] docs(vision): frame autonomy as configurable per workflow - Keeps "everything autonomous" as the lede - Adds per-workflow configurability: each SDLC phase can be human-driven, agent-driven, or both - Frames adoption as incremental - Uses "guardrails" consistently (generalizes beyond review agent) - Incorporates Romain's feedback on line 38 wording Assisted-by: Claude claude-opus-4-6 Signed-off-by: Ralph Bean --- docs/vision.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/vision.md b/docs/vision.md index 30a4a3bf52..67069f73fc 100644 --- a/docs/vision.md +++ b/docs/vision.md @@ -2,12 +2,12 @@ ## The goal -A GitHub organization's repos operate with fully autonomous agents handling the routine software development lifecycle: issue triage, implementation, code review, testing, and merge-to-production. Humans participate at two points: +Everything autonomous is the goal. A GitHub organization's repos operate with agents handling the full software development lifecycle: issue triage, implementation, code review, testing, and merge-to-production. Humans participate at two points: 1. **Strategic intent** — defining what the system should do and become. Features, architecture, direction. -2. **Guarded paths** — CODEOWNERS-enforced human approval for security-critical, API-changing, or architecturally significant code paths. +2. **Guardrails** — CODEOWNERS-enforced human approval for security-critical, API-changing, or architecturally significant code paths. -Everything else is autonomous. +Getting there is incremental. Each phase and transition in the [agentic SDLC](#the-agentic-sdlc) can be configured — per workflow — as human-driven, agent-driven, or both. A bugfix workflow might run fully autonomously while a feature workflow keeps a human in the loop at refinement and review. Teams adopt at whatever pace builds confidence, shifting one phase at a time rather than flipping a giant switch. ## The agentic SDLC @@ -35,7 +35,7 @@ The current bugfix workflow spans three phases. The remaining phases are planned ***Feedback*** ◄─── Monitor ◄─────── Delivery ``` -**Current (bugfix workflow):** An issue reports a bug (***feedback***). An agent triages, implements a fix (***execution***), and validates it against tests and review (***verification***). Humans set strategic intent and approve guarded paths; everything else is autonomous. +**Current (bugfix workflow):** An issue reports a bug (***feedback***). An agent triages, implements a fix (***execution***), and validates it against tests and review (***verification***). Humans must set strategic intent and approve guardrails; the rest may be fully autonomous based on configuration. **Planned:** Discovery (identifying what needs work from production signals and tech debt), refinement (scoping and decomposing work), prioritization (ordering the backlog), delivery (merge-to-production with graduated autonomy), and monitor (production observability feeding back into the loop). From 4b78af2310dc466dbddab81764b6a7aaaec9832b Mon Sep 17 00:00:00 2001 From: Ralph Bean Date: Thu, 9 Jul 2026 16:24:57 -0400 Subject: [PATCH 2/2] docs(vision): restore 'everything else' phrasing Preserve cross-doc consistency with human-factors.md which references this phrasing verbatim. Signed-off-by: Ralph Bean Assisted-by: Claude claude-opus-4-6 Signed-off-by: Ralph Bean --- docs/vision.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/vision.md b/docs/vision.md index 67069f73fc..37a3b09634 100644 --- a/docs/vision.md +++ b/docs/vision.md @@ -35,7 +35,7 @@ The current bugfix workflow spans three phases. The remaining phases are planned ***Feedback*** ◄─── Monitor ◄─────── Delivery ``` -**Current (bugfix workflow):** An issue reports a bug (***feedback***). An agent triages, implements a fix (***execution***), and validates it against tests and review (***verification***). Humans must set strategic intent and approve guardrails; the rest may be fully autonomous based on configuration. +**Current (bugfix workflow):** An issue reports a bug (***feedback***). An agent triages, implements a fix (***execution***), and validates it against tests and review (***verification***). Humans must set strategic intent and approve guardrails; everything else may be fully autonomous based on configuration. **Planned:** Discovery (identifying what needs work from production signals and tech debt), refinement (scoping and decomposing work), prioritization (ordering the backlog), delivery (merge-to-production with graduated autonomy), and monitor (production observability feeding back into the loop).