. Sidecar Pattern for Browser Isolation
ADR-001: Sidecar Pattern for Browser Isolation — Accepted. Architectural decision record for the helmdeck control-plane.
. Golang for the Control Plane
ADR-002: Golang for the Control Plane — Accepted. Architectural decision record for the helmdeck control-plane.
. Capability Packs as the Primary Product Surface
ADR-003: Capability Packs as the Primary Product Surface — Accepted. Architectural decision record for the helmdeck control-plane.
. Ephemeral Stateless Browser Sessions
ADR-004: Ephemeral Stateless Browser Sessions — Accepted. Architectural decision record for the helmdeck control-plane.
. OpenAI-Compatible Multi-Provider AI Gateway
ADR-005: OpenAI-Compatible Multi-Provider AI Gateway — Accepted. Architectural decision record for the helmdeck control-plane.
. MCP Server Registry with stdio / SSE / WebSocket Transports
ADR-006: MCP Server Registry with stdio / SSE / WebSocket Transports — Accepted. Architectural decision record for the helmdeck control-plane.
. Credential Vault with Placeholder-Token Injection
ADR-007: Credential Vault with Placeholder-Token Injection — Accepted. Architectural decision record for the helmdeck control-plane.
. Closed-Set Typed Error Codes on All Pack Outputs
ADR-008: Closed-Set Typed Error Codes on All Pack Outputs — Accepted. Architectural decision record for the helmdeck control-plane.
. Dual-Tier Deployment: Docker Compose and Kubernetes via Helm
ADR-009: Dual-Tier Deployment: Docker Compose and Kubernetes via Helm — Accepted. Architectural decision record for the helmdeck control-plane.
0. KEDA Autoscaling on Custom Session Metrics
ADR-010: KEDA Autoscaling on Custom Session Metrics — Accepted. Architectural decision record for the helmdeck control-plane.
1. Tiered Session Isolation: Docker, gVisor, Firecracker
ADR-011: Tiered Session Isolation: Docker, gVisor, Firecracker — Accepted. Architectural decision record for the helmdeck control-plane.
2. WebAssembly Executor for Custom Pack Handlers
ADR-012: WebAssembly Executor for Custom Pack Handlers — Proposed. Architectural decision record for the helmdeck control-plane.
3. OpenTelemetry with GenAI Semantic Conventions
ADR-013: OpenTelemetry with GenAI Semantic Conventions — Accepted. Architectural decision record for the helmdeck control-plane.
4. Pack: slides.render
ADR-014: Pack: `slides.render` — Accepted. Architectural decision record for the helmdeck control-plane.
5. Pack: slides.video
ADR-015: Pack: `slides.video` — Accepted. Architectural decision record for the helmdeck control-plane.
6. Pack: web.login_and_fetch
ADR-016: Pack: `web.login_and_fetch` — Accepted. Architectural decision record for the helmdeck control-plane.
7. Pack: web.scrape_spa
ADR-017: Pack: `web.scrape_spa` — Accepted. Architectural decision record for the helmdeck control-plane.
8. Pack: desktop.run_app_and_screenshot
ADR-018: Pack: `desktop.run_app_and_screenshot` — Accepted. Architectural decision record for the helmdeck control-plane.
9. Pack: doc.ocr
ADR-019: Pack: `doc.ocr` — Accepted. Architectural decision record for the helmdeck control-plane.
0. Pack: web.fill_form
ADR-020: Pack: `web.fill_form` — Accepted. Architectural decision record for the helmdeck control-plane.
1. Pack: browser.screenshot_url
ADR-021: Pack: `browser.screenshot_url` — Accepted. Architectural decision record for the helmdeck control-plane.
2. Pack: repo.fetch
ADR-022: Pack: `repo.fetch` — Accepted. Architectural decision record for the helmdeck control-plane.
3. Pack: repo.push
ADR-023: Pack: `repo.push` — Accepted. Architectural decision record for the helmdeck control-plane.
4. User-Authored Pack Extensibility
ADR-024: User-Authored Pack Extensibility — Accepted. Architectural decision record for the helmdeck control-plane.
5. First-Class MCP Client Integrations: Claude Code, Claude Desktop, OpenClaw, Gemini CLI
ADR-025: First-Class MCP Client Integrations: Claude Code, Claude Desktop, OpenClaw, Gemini CLI — Accepted. Architectural decision record for the helmdeck control-plane.
6. A2A Agent Card Endpoint
ADR-026: A2A Agent Card Endpoint — Proposed. Architectural decision record for the helmdeck control-plane.
7. Dual-Mode Action API: Structured (CDP) and Vision
ADR-027: Dual-Mode Action API: Structured (CDP) and Vision — Proposed. Architectural decision record for the helmdeck control-plane.
8. WebRTC Live Session Streaming
ADR-028: WebRTC Live Session Streaming — Proposed. Architectural decision record for the helmdeck control-plane.
9. Four-Tier Agent Memory API
ADR-029: Four-Tier Agent Memory API — Proposed. Architectural decision record for the helmdeck control-plane.
0. helmdeck-mcp Bridge Packaging and Distribution
ADR-030: `helmdeck-mcp` Bridge Packaging and Distribution — Accepted. Architectural decision record for the helmdeck control-plane.
1. Object Store: Garage as Bundled Default, Pluggable External S3
ADR-031: Object Store: Garage as Bundled Default, Pluggable External S3 — Accepted. Architectural decision record for the helmdeck control-plane.
ADR 032 — Artifact Explorer & MCP Inline Image Content
ADR-032: Artifact Explorer & MCP Inline Image Content — Proposed. Architectural decision record for the helmdeck control-plane.
ADR 033 — GitHub Webhook Listener
ADR-033: GitHub Webhook Listener — Proposed. Architectural decision record for the helmdeck control-plane.
ADR 034 — Pack Marketplace (App Store for Capability Packs)
ADR-034: Pack Marketplace (App Store for Capability Packs) — Proposed. Architectural decision record for the helmdeck control-plane.
ADR 035 — MCP Server Hosting & Capability Pack Evolution
ADR-035: MCP Server Hosting & Capability Pack Evolution — Proposed. Architectural decision record for the helmdeck control-plane.
ADR 036 — Pack: repo.map (Aider-style structural symbol map)
ADR-036: Pack: `repo.map` (Aider-style structural symbol map) — Proposed. Architectural decision record for the helmdeck control-plane.
ADR 037 — Upstream Package Version Management for Sidecar-Bundled Tools
ADR-037: Upstream Package Version Management for Sidecar-Bundled Tools — Proposed. Architectural decision record for the helmdeck control-plane.
ADR 038 — Marketplace pack execution via dedicated sidecar
ADR-038: Marketplace pack execution via dedicated sidecar — Proposed. Architectural decision record for the helmdeck control-plane.
9. Universal Memory Delivery Layer
ADR-039: Universal Memory Delivery Layer — Proposed. Architectural decision record for the helmdeck control-plane.
0. Persistent Repos Volume and Cross-Session Clone Reuse
ADR-040: Persistent Repos Volume and Cross-Session Clone Reuse — Proposed. Architectural decision record for the helmdeck control-plane.
1. Pipelines as a First-Class Resource
ADR-041: Pipelines as a First-Class Resource — Proposed. Architectural decision record for the helmdeck control-plane.
3. Actionable Gateway Model/Provider Errors
ADR-043: Actionable Gateway Model/Provider Errors — Accepted. Architectural decision record for the helmdeck control-plane.
4. CI/CD-like Pipeline Execution: Resume, Retry, Re-run
ADR-044: CI/CD-like Pipeline Execution: Resume, Retry, Re-run — Accepted. Architectural decision record for the helmdeck control-plane.
5. Pack Resource Sizing via CPU Profiles
ADR-045: Pack Resource Sizing via CPU Profiles — Accepted. Architectural decision record for the helmdeck control-plane.
6. Coding Pipelines + Agent-Integration Roadmap
ADR-046: Coding Pipelines + Agent-Integration Roadmap — Accepted. Architectural decision record for the helmdeck control-plane.
7. Catalog Metadata, Memory-Driven Routing, and Gap Analysis
ADR-047: Catalog Metadata, Memory-Driven Routing, and Gap Analysis — Accepted. Architectural decision record for the helmdeck control-plane.
8. Memory Write Surface and OpenClaw Memory-Corpus Bridge
ADR-048: Memory Write Surface and OpenClaw Memory-Corpus Bridge — Accepted. Architectural decision record for the helmdeck control-plane.
9. Intent Decomposition and the Self-Learning Plan Pack
ADR-049: Intent Decomposition and the Self-Learning Plan Pack — Accepted. Architectural decision record for the helmdeck control-plane.
0. LLM Context Manager for Catalog-Heavy Packs
ADR-050: LLM Context Manager for Catalog-Heavy Packs — Accepted. Architectural decision record for the helmdeck control-plane.
1. Failure-Mode-Aware Dispatch for Mixed-Tier Model Deployments
ADR-051: Failure-Mode-Aware Dispatch for Mixed-Tier Model Deployments — Accepted. Architectural decision record for the helmdeck control-plane.
2. AV Output Validation as a Default-On Post-Encode Step
ADR-052: AV Output Validation as a Default-On Post-Encode Step — Accepted. Architectural decision record for the helmdeck control-plane.
3. Tier-Aware Prompt Templates for helmdeck.plan
ADR-053: Tier-Aware Prompt Templates for `helmdeck.plan` — Accepted. Architectural decision record for the helmdeck control-plane.