version: 1
generated_by: maintain-architecture-decisions
decisions:
- id: harness.agent-boundary-and-protocol
status: accepted
scope: harness
decision_type: boundary
summary: Lucy is a local macOS/Linux harness with a default TUI, an automatic/explicit
JSONL mode, one OpenAI-compatible provider, `cmd`, and a bounded `spawn_subagent`
model tool.
applies_to:
- Cargo.toml
- src/**
- tests/**
- README.md
file: records/harness/agent-boundary-and-protocol.md
constrains: []
depends_on: []
supersedes: []
superseded_by: []
last_reviewed: '2026-07-19'
- id: harness.command-execution
status: accepted
scope: harness
decision_type: execution
summary: Lucy executes trusted finite shell commands locally with bounded time
and output.
applies_to:
- src/**
- tests/**
- README.md
file: records/harness/command-execution.md
constrains: []
depends_on:
- harness.agent-boundary-and-protocol
- harness.session-and-context-lifecycle
supersedes: []
superseded_by: []
last_reviewed: '2026-07-16'
- id: harness.configuration-and-provider
status: accepted
scope: harness
decision_type: configuration
summary: Lucy bootstraps a user-editable XDG config file, migrates the legacy
~/.lucy/config.toml once when needed, and reads provider credentials only from
the environment.
applies_to:
- src/**
- tests/**
- README.md
file: records/harness/configuration-and-provider.md
constrains: []
depends_on:
- harness.agent-boundary-and-protocol
supersedes: []
superseded_by: []
last_reviewed: '2026-07-19'
- id: harness.session-and-context-lifecycle
status: accepted
scope: harness
decision_type: lifecycle
summary: Lucy persists named JSONL sessions, interruption records, and an immutable
boot-context snapshot on resume.
applies_to:
- src/**
- tests/**
- README.md
file: records/harness/session-and-context-lifecycle.md
constrains: []
depends_on:
- harness.agent-boundary-and-protocol
- harness.configuration-and-provider
supersedes: []
superseded_by: []
last_reviewed: '2026-07-19'