From b4f1666a80ce8ec88e08301e795fd703486138e7 Mon Sep 17 00:00:00 2001 From: openhands Date: Sat, 21 Mar 2026 18:07:37 +0000 Subject: [PATCH] chore: gardener housekeeping 2026-03-21 --- AGENTS.md | 2 +- action/AGENTS.md | 6 +++--- dev/AGENTS.md | 2 +- gardener/AGENTS.md | 6 ++++-- lib/AGENTS.md | 2 +- planner/AGENTS.md | 2 +- predictor/AGENTS.md | 2 +- review/AGENTS.md | 2 +- supervisor/AGENTS.md | 2 +- vault/AGENTS.md | 2 +- 10 files changed, 15 insertions(+), 13 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 1c800fe..64fba19 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,4 @@ - + # Disinto — Agent Instructions ## What this repo is diff --git a/action/AGENTS.md b/action/AGENTS.md index a50fd1c..f84a58a 100644 --- a/action/AGENTS.md +++ b/action/AGENTS.md @@ -1,4 +1,4 @@ - + # Action Agent **Role**: Execute operational tasks described by action formulas — run scripts, @@ -12,13 +12,13 @@ issues labeled `action` that have no active tmux session, then spawns **Key files**: - `action/action-poll.sh` — Cron scheduler: finds open action issues with no active tmux session, spawns action-agent.sh -- `action/action-agent.sh` — Orchestrator: fetches issue body + prior comments, creates tmux session (`action-{issue_num}`) with interactive `claude`, injects formula prompt with phase protocol, enters `monitor_phase_loop` (shared via `dev/phase-handler.sh`) for CI/review lifecycle or direct completion +- `action/action-agent.sh` — Orchestrator: fetches issue body + prior comments, creates tmux session (`action-{project}-{issue_num}`) with interactive `claude`, injects formula prompt with phase protocol, enters `monitor_phase_loop` (shared via `dev/phase-handler.sh`) for CI/review lifecycle or direct completion **Session lifecycle**: 1. `action-poll.sh` finds open `action` issues with no active tmux session. 2. Spawns `action-agent.sh `. 3. Agent creates Matrix thread, exports `MATRIX_THREAD_ID` so Claude's output streams to the thread via a Stop hook (`on-stop-matrix.sh`). -4. Agent creates tmux session `action-{issue_num}`, injects prompt (formula + prior comments + phase protocol). +4. Agent creates tmux session `action-{project}-{issue_num}`, injects prompt (formula + prior comments + phase protocol). 5. Agent enters `monitor_phase_loop` (shared with dev-agent via `dev/phase-handler.sh`). 6. **Path A (git output):** Claude pushes branch → `PHASE:awaiting_ci` → handler creates PR, polls CI → injects failures → Claude fixes → push → re-poll → CI passes → `PHASE:awaiting_review` → handler polls reviews → injects REQUEST_CHANGES → Claude fixes → approved → merge → cleanup. 7. **Path B (no git output):** Claude posts results as comment, closes issue → `PHASE:done` → handler cleans up (kill session, docker compose down, remove temp files). diff --git a/dev/AGENTS.md b/dev/AGENTS.md index f051c9c..5bb44bc 100644 --- a/dev/AGENTS.md +++ b/dev/AGENTS.md @@ -1,4 +1,4 @@ - + # Dev Agent **Role**: Implement issues autonomously — write code, push branches, address diff --git a/gardener/AGENTS.md b/gardener/AGENTS.md index cd0e3c8..bc91186 100644 --- a/gardener/AGENTS.md +++ b/gardener/AGENTS.md @@ -1,8 +1,10 @@ - + # Gardener Agent **Role**: Backlog grooming — detect duplicate issues, missing acceptance -criteria, oversized issues, stale issues, and circular dependencies. Invoke +criteria, oversized issues, stale issues, and circular dependencies. Enforces +the quality gate: strips the `backlog` label from issues that lack acceptance +criteria checkboxes (`- [ ]`) or an `## Affected files` section. Invokes Claude to fix or escalate to a human via Matrix. **Trigger**: `gardener-run.sh` runs 4x/day via cron. It creates a tmux diff --git a/lib/AGENTS.md b/lib/AGENTS.md index d25d0d9..20827be 100644 --- a/lib/AGENTS.md +++ b/lib/AGENTS.md @@ -1,4 +1,4 @@ - + # Shared Helpers (`lib/`) All agents source `lib/env.sh` as their first action. Additional helpers are diff --git a/planner/AGENTS.md b/planner/AGENTS.md index a8eaa39..ba94099 100644 --- a/planner/AGENTS.md +++ b/planner/AGENTS.md @@ -1,4 +1,4 @@ - + # Planner Agent **Role**: Strategic planning, executed directly from cron via tmux + Claude. diff --git a/predictor/AGENTS.md b/predictor/AGENTS.md index 86df19e..3d46d8b 100644 --- a/predictor/AGENTS.md +++ b/predictor/AGENTS.md @@ -1,4 +1,4 @@ - + # Predictor Agent **Role**: Infrastructure pattern detection (the "goblin"). Runs a 3-step diff --git a/review/AGENTS.md b/review/AGENTS.md index 6677a1a..fe6bfed 100644 --- a/review/AGENTS.md +++ b/review/AGENTS.md @@ -1,4 +1,4 @@ - + # Review Agent **Role**: AI-powered PR review — post structured findings and formal diff --git a/supervisor/AGENTS.md b/supervisor/AGENTS.md index e39f5a7..d19cb97 100644 --- a/supervisor/AGENTS.md +++ b/supervisor/AGENTS.md @@ -1,4 +1,4 @@ - + # Supervisor Agent **Role**: Health monitoring and auto-remediation, executed as a formula-driven diff --git a/vault/AGENTS.md b/vault/AGENTS.md index dbf507e..c14d9d3 100644 --- a/vault/AGENTS.md +++ b/vault/AGENTS.md @@ -1,4 +1,4 @@ - + # Vault Agent **Role**: Safety gate for dangerous or irreversible actions. Actions enter a