Skip to content

docs: Connections design-of-record — glossary + ADRs 0001/0002 - #158

Merged
kateebonner merged 1 commit into
mainfrom
kate/connections-design-of-record
Jul 20, 2026
Merged

docs: Connections design-of-record — glossary + ADRs 0001/0002#158
kateebonner merged 1 commit into
mainfrom
kate/connections-design-of-record

Conversation

@kateebonner

Copy link
Copy Markdown
Contributor

Publishes the design-of-record for the Connections work (Kate's slice of the 7/18 cloud handoff + Pasqal):

  • CONTEXT.md — canonical glossary: Connection / Credential / Device / Submitter, Entitlement (both senses), Routing vs Solver mode.
  • ADR 0001 — credentials at rest are revocable tokens on disk under ~/.amico (0600, atomic mode-at-birth via the storage seam); Pasqal passwords are never persisted (in-memory token mint, session-only fallback).
  • ADR 0002 — the Connections credential seam lives in the vendored app server (server-route seam), with the hardening grafts as merge conditions and the recorded flip-back condition.

Produced via a 3-candidate / 3-judge design panel and a 3-round adversarial review verifying claims against amicode, the opencode fork, rchari/hp-cloud-key, and deployed aws-infra staging. Companion issues follow in this repo + aws-infra.

🤖 Generated with Claude Code

CONTEXT.md: canonical glossary for the Connections work (Connection /
Credential / Device / Submitter; Entitlement in both senses; Routing vs
Solver mode). ADR 0001: credentials at rest are revocable tokens on disk
under ~/.amico (0600, atomic mode-at-birth via the storage seam; Pasqal
passwords never persisted — in-memory token mint only). ADR 0002: the
Connections credential seam lives in the vendored app server (server-route
seam), with the hardening grafts as merge conditions and the recorded
flip condition.

Produced via 3-candidate design panel + 3-round adversarial review
(2026-07-19).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant