From 5fe272a1a0ffa106e61d727705933786ac2c2051 Mon Sep 17 00:00:00 2001 From: Wild Wind Date: Sat, 2 May 2026 21:11:43 -0700 Subject: [PATCH] Document public response file flow --- docs/local_agent_loop.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/local_agent_loop.md b/docs/local_agent_loop.md index a8c7e5a..03159a8 100644 --- a/docs/local_agent_loop.md +++ b/docs/local_agent_loop.md @@ -53,6 +53,8 @@ flowchart LR Runner --> Logs AgentCLIs --> AgentDirs + AgentCLIs --> ResponseFiles[(Public response files
/tmp/coding-review-agent-loop/responses)] + ResponseFiles --> Orchestrator GhCLI --> GitHub[(GitHub repo
issues / PRs / comments / checks)] Followups --> GitHubOps ``` @@ -67,6 +69,7 @@ sequenceDiagram participant Memory as Agent memory participant Coder as Coder agent CLI participant Reviewer as Reviewer agent CLI(s) + participant Resp as Public response files participant GH as GitHub via gh User->>CLI: agent-loop issue | task | pr @@ -75,7 +78,8 @@ sequenceDiagram Orch->>Memory: prepare advisory repo memory alt issue or task Orch->>Coder: create or update PR - Coder-->>Orch: output with AGENT_PR marker + Coder-->>Resp: write public response if supported + Coder-->>Orch: response file or parsed stdout with AGENT_PR marker Orch->>GH: validate PR and post coder output else existing PR Orch->>GH: validate open PR @@ -83,14 +87,17 @@ sequenceDiagram loop until all reviewers approve or max rounds reached Orch->>Reviewer: review PR - Reviewer-->>Orch: AGENT_STATE approved or blocking + Reviewer-->>Resp: write public response if supported + Reviewer-->>Orch: response file or parsed stdout with AGENT_STATE Orch->>GH: post review comment alt any blocking review Orch->>Coder: address combined feedback + Coder-->>Resp: write public response if supported Coder-->>Orch: AGENT_STATE blocking Orch->>GH: post coder update else approved review has same-PR follow-ups in a fix-and mode Orch->>Coder: address same-PR follow-ups + Coder-->>Resp: write public response if supported Coder-->>Orch: AGENT_STATE blocking Orch->>GH: post coder update else all approved @@ -414,4 +421,9 @@ agents run: [agent-loop 12:00:31] Claude still running (30s); log: /path/to/.agent-loop-logs/20260425-120001-claude.log ``` -Use `tail -f` on the displayed path to see live output. The log directory gets its own `.gitignore` on first use. +Use `tail -f` on the displayed path to see live output. Logs are diagnostic +output and may include CLI status text or tool narration. For Claude and +Gemini, prompts also include a public response-file path under +`/tmp/coding-review-agent-loop/responses/`; when that file exists and is +non-empty, the loop posts the file contents to GitHub instead of stdout. The log +directory gets its own `.gitignore` on first use.