From 38c297f3cfb433a1bc172ece23d8f22ca14a0227 Mon Sep 17 00:00:00 2001 From: Million <15158090088@163.com> Date: Wed, 12 Aug 2026 10:13:01 +0800 Subject: [PATCH] docs: exempt simple self-contained changes from OpenSpec MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Clarify that only significant or structural changes require the OpenSpec workflow (/opsx:explore → /opsx:propose → /opsx:apply → /opsx:archive). Simple, self-contained changes — single-file fixes, small telemetry/logging adjustments, cosmetic refactors, docs updates — now skip OpenSpec and go straight to implementation, with explicit criteria for when OpenSpec is still required. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus --- AGENTS.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d2da9eac9..b8254e4f9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,7 +6,15 @@ AgentPool is a unified agent orchestration framework for YAML-based configuratio ## Development Workflow -All significant changes go through OpenSpec: `/opsx:explore` → `/opsx:propose` → `/opsx:apply` → `/opsx:archive`. +Significant or structural changes go through OpenSpec: `/opsx:explore` → `/opsx:propose` → `/opsx:apply` → `/opsx:archive`. + +Simple, self-contained changes skip OpenSpec and go straight to implementation: + +- **Scope**: a single file or a small set of related files, one logical change +- **No design decisions**: the approach is obvious from the request (bug fixes, small telemetry/logging adjustments, cosmetic refactors, docs/typo fixes) +- **No cross-module blast radius**: doesn't add new capabilities, change the manifest/schema, or alter protocol behavior + +If the change would need a design discussion, affects how agents are configured, or spans multiple modules, use OpenSpec. When in doubt, OpenSpec is the safer default. - Location: `openspec/` (24 capability specs, 34 archived changes) - CLI: `openspec` v1.4+ — see `openspec/config.yaml` @@ -139,7 +147,7 @@ Instrument critical-path code (RunLoop, Turn, delegation, protocol entry points) 1. Your AI tool reads this file automatically — it is the collaboration rulebook. 2. Humans should also read it (5 minutes). 3. For deeper context on a subsystem, read the sub-AGENTS.md in that directory. -4. Any significant change goes through OpenSpec: `/opsx:explore` → `/opsx:propose` → `/opsx:apply` → `/opsx:archive`. +4. Significant or structural changes go through OpenSpec: `/opsx:explore` → `/opsx:propose` → `/opsx:apply` → `/opsx:archive`. Simple, self-contained changes (single-file fixes, small telemetry/logging tweaks, cosmetic refactors, docs updates) skip OpenSpec and go straight to implementation — see "Development Workflow" above. 5. Unsure where documentation goes? Open an issue, don't create a new directory. ## Rules