# Decisions

| ADR | Status | Summary | Read when |
|---|---|---|---|
| ADR-0001 | Active | Pi Claude Code bridge boundary |  |
| ADR-0002 | Superseded | Reliable Persistent-Memory Reconciliation |  |
| ADR-0003 | Superseded | Non-Blocking Reason-Aware Persistent-Memory Consolidation |  |
| ADR-0004 | Active | Pi Subagents | changing subagent sessions, role definitions, agent-definition discovery or precedence, nested spawning, concurrency, workflow gating, or parent/child isolation |
| ADR-0005 | Superseded | Pinned Default Persistent-Memory Model Resolution |  |
| ADR-0006 | Superseded | Chunked Persistent-Memory Reconciliation |  |
| ADR-0007 | Active | Workflow modes direct subagent delegation by prompt |  |
| ADR-0008 | Superseded | Persistent-memory reconcile connection ownership and observability |  |
| ADR-0009 | Superseded | Bridge staging validity and malformed quarantine |  |
| ADR-0010 | Active | Global subagent idle timeout with max-total backstop | Changing subagent timeout policy, role-agent schemas, or timeout debugging |
| ADR-0011 | Superseded | Per-Candidate Persistent-Memory Reconciliation |  |
| ADR-0012 | Active | Per-mode ponytail lazy-senior-dev reflex |  |
| ADR-0013 | Superseded | Manual Single-Writer Persistent-Memory Consolidation | changing persistent-memory lifecycle hooks, /memory consolidate/recover/reconcile, staging cleanup, dead-letter recovery, reinforcement, or mode-transition reminders |
| ADR-0014 | Superseded | Persistent Memory Inherits Session Model | changing persistent-memory model calls, save_to_memory, /memory consolidate/reconcile, model selection, settings persistence, or ADR-0005 history |
| ADR-0015 | Superseded | Agent-Driven Persistent-Memory Save Turn | changing `/memory` modal Consolidate, save_to_memory, persistent-memory write invariants, missed-tool nudges, or ADR-0013 manual consolidation flow |
| ADR-0016 | Active | Memory = engineering-docs plus user-global personal memory | changing /notes promote, /remember, memory capture or recall, bridge recall/capture behavior, personal-memory injection, engineering-docs memory boundaries, or persistent-memory history |
| ADR-0017 | Active | Indexed user-global personal memory | changing personal-memory storage, guided /remember, remember slug upsert, recall_memory, recall_memory_entry, save_memory, or legacy ~/.pi/memory.md migration |
| ADR-0018 | Active | Engineering docs root spokes | changing engineering-docs init/check, manifest.generated, AGENTS.md/CLAUDE.md generation, or marker-block merge behavior |
| ADR-0019 | Active | Multi-harness bridge and Cursor parity | changing bridge protocol fields, adding new harness clients, changing Cursor hooks/templates, changing read-only enforcement, or extending ADR-0001 bridge boundaries |
| ADR-0020 | Superseded | Durable workflow plan store |  |
| ADR-0021 | Superseded | Session-branch workflow plans |  |
| ADR-0022 | Active | Network-allowed read-only Review sandbox | changing Review mode command policy, sandbox wrapping, fallback behavior, or GitHub review workflows |
| ADR-0023 | Active | Workspace source and runtime separation | changing package resources or allowlists, dependencies, launcher flags, repository/runtime ownership, project agent discovery, ignored state, npm installation, or migration policy |
| ADR-0024 | Active | Design mode and design docs root | changing Design prompts, design scaffolds, token parsing, preview themes, base-library guidance, build prompt composition, frontend component guidance, or bridge prompt recall |
| ADR-0025 | Active | Workflow mode announcement channel | changing workflow-mode prompt composition, mode transitions, before_agent_start messages, tool block reasons, compaction behavior, or provider continuation/cache behavior |
| ADR-0026 | Active | Session-scoped workflow plan files and task tracking | changing /plan save/select/view/clear, plan-file paths or retention, task seeding/ticking, workflow markers, bridge plan access, or session ancestry semantics |
| ADR-0027 | Active | Static host access and agent-directory injection | changing Pi host imports, agent-directory or plan/memory path resolution, extension test isolation, or workspace package checks |
| ADR-0028 | Active | Title-addressable workflow plan task ticks | changing workflow_plan_tick, task reference resolution, tracker recovery, workflow markers, CustomMessage conversion, prompt-cache behavior, or bridge plan tools |