Skip to content

Commit d3bc654

Browse files
committed
docs: drop stale branch pointer from ADR-001, add retrospective note
1 parent 8eee990 commit d3bc654

2 files changed

Lines changed: 11 additions & 3 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ Key additions for production: `ENVIRONMENT=production`, `ADMIN_PASSWORD`, `CORS_
135135

136136
## Key Decisions
137137

138-
- **Pre-pivot code**: preserved on branch `pre-pivot/v1`
138+
- **Pre-pivot code**: archived on a local-only branch (not on the public remote)
139139
- **No pydantic-ai**: AI orchestration handled by Claude Code CLI in containers, not Python agent code
140140
- **BYOK via dashboard**: Claude OAuth tokens (from `claude setup-token`) stored per installation, encrypted with Fernet, injected as `CLAUDE_CODE_OAUTH_TOKEN` env var into containers. Zero API cost (uses user's Claude subscription).
141141
- **Dashboard over SQLAdmin**: user-facing operations (installation list, session history, token config) go through the dashboard UI; SQLAdmin is the superadmin escape hatch

docs/adr-001-claude-code-container-pivot.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
> **Date**: 2026-04-17
55
> **Decision makers**: Marius Pruvot (Project Lead)
66
> **Supersedes**: Current pydantic-ai agent architecture
7-
> **Backup branch**: `pre-pivot/v1`
7+
> **Backup**: pre-pivot code archived on a local branch
88
99
## Context
1010

@@ -145,7 +145,7 @@ Community can contribute additional skills via the open-source repository.
145145

146146
## Implementation order
147147

148-
1. Backup current state (`pre-pivot/v1` branch) -- **done**
148+
1. Backup current state on a local archive branch -- **done**
149149
2. This ADR -- **done**
150150
3. Clean project documentation (CLAUDE.md, docs/) to reflect new architecture
151151
4. Remove comprehension module and pydantic-ai dependency
@@ -159,3 +159,11 @@ Community can contribute additional skills via the open-source repository.
159159

160160
- The project targets open-source release, designed for self-hosting with existing Claude licenses.
161161
- The skill-as-agent model means the repository itself must be "agent-ready" -- CLAUDE.md and docs must be precise enough for a fresh Claude Code instance to understand the project without prior context.
162+
163+
## Retrospective (2026-07)
164+
165+
Three months in, the decision has held up:
166+
167+
- The container model works as designed -- sessions run end-to-end (clone, skill execution, SSE streaming, scorecard) with ~4-8s startup after parallel-fetch optimizations.
168+
- The skill lineup evolved with usage: `challenge-me` shipped as planned, but the catalog grew toward comprehension-oriented skills (`eli5`, `hot-seat`, `pair-debug`, `test-me`) rather than the review/audit skills sketched above.
169+
- Credential injection moved from `ANTHROPIC_API_KEY` to Claude OAuth tokens (`CLAUDE_CODE_OAUTH_TOKEN`, via `claude setup-token`), letting self-hosters run on their Claude subscription at zero marginal API cost.

0 commit comments

Comments
 (0)