claude-agent-service/docs/adr
Viktor Barzin be81005186
Some checks are pending
Build and Push / lint-and-test (push) Waiting to run
Build and Push / build (push) Blocked by required conditions
Build and Push / deploy (push) Blocked by required conditions
Build and Push / notify-failure (push) Blocked by required conditions
docs: capture AFK implementation pipeline design + ADRs 0002-0004
Record the architecture for moving code implementation AFK, decided in a
design/grilling session. The owner wants the human-in-the-loop boundary to
stop at design + spec: once an issue is triaged ready-for-agent, an agent
should implement it test-first, push it, and see it to a healthy deploy on
its own, escalating only when it can't proceed.

Decisions captured:
- claude-agent-service is the control plane (poller + watcher + safety);
  a dedicated in-cluster T3 Code instance is the executor + cockpit, because
  T3 can only show sessions it launched itself -> we dispatch into it
  (ADR 0003).
- AFK code pushes straight to master; on a broken deploy it fix-forwards
  then freezes the broken state for forensics rather than reverting
  (ADR 0002).
- Implementation agents use persistent per-repo checkouts + git worktrees on
  SSD-NFS for warm caches, reversing the throwaway-clone rule for this path
  because concurrency is serial-within-repo (ADR 0004).

Pilot-gated: five integration unknowns must be validated against a dedicated
T3 instance before the poller is wired. No code yet.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 19:09:12 +00:00
..
0001-breakglass-security-architecture.md docs: capture breakglass design (CONTEXT glossary + ADR 0001) 2026-06-12 20:59:13 +00:00
0002-afk-autonomous-merge-and-failure-posture.md docs: capture AFK implementation pipeline design + ADRs 0002-0004 2026-06-14 19:09:12 +00:00
0003-t3-thin-executor-and-cockpit.md docs: capture AFK implementation pipeline design + ADRs 0002-0004 2026-06-14 19:09:12 +00:00
0004-persistent-worktrees-for-implementation-agents.md docs: capture AFK implementation pipeline design + ADRs 0002-0004 2026-06-14 19:09:12 +00:00