docs(work): scaffold sandcastle-subscription-auth-v1 epic

This commit is contained in:
2026-05-13 09:27:02 +02:00
parent 3f0d60e082
commit b6948fa881
3 changed files with 72 additions and 2 deletions

View File

@@ -0,0 +1,21 @@
---
id: 01-subscription-first
epic: sandcastle-subscription-auth-v1
title: Subscription-first dispatch — mount ~/.claude, install claude CLI, docs
type: technical-story
status: in-progress
feature: tooling
depends-on: []
blocks: []
---
## Tasks
- [ ] Story scaffold
- [ ] Update .sandcastle/Dockerfile to install @anthropic-ai/claude-code CLI
- [ ] Update scripts/work/dispatch.mjs: resolveClaudeAuth helper + sandbox mount + fallback to API key
- [ ] Tests for resolveClaudeAuth
- [ ] Update runbook "Using Sandcastle" section: subscription is primary flow
- [ ] Update ADR-019: subscription auth as primary, API key as fallback
- [ ] Update .env.example + .sandcastle/.env.example: reframe ANTHROPIC_API_KEY as fallback
- [ ] Final verification + closeout

View File

@@ -0,0 +1,29 @@
---
id: sandcastle-subscription-auth-v1
prd: null
title: Sandcastle subscription auth as primary flow
type: epic
status: in-progress
features: [tooling, ci]
created: 2026-05-13
---
## Goal
Subscription-based Claude Code auth (via host `~/.claude` mount) becomes
the default for `pnpm work dispatch --execute`. API-key auth remains as a
fallback. Works for any developer who has run `claude login` on their
host — zero per-user configuration in the repo.
## Why
The sandcastle community has explicitly rejected native subscription
support (issue #191, wontfix). But the host's `~/.claude/` directory
contains the logged-in session; mounting it into the sandbox lets the
container's Claude Code CLI use that session. This pattern is
environment-agnostic (each developer has their own `~/.claude`) and
spends zero per-task agent tokens for Pro/Max subscribers.
## Stories
- [ ] [01 — Subscription-first dispatch + Dockerfile + docs](01-subscription-first/_story.md)