Design decisions

Decision summaries from the 19 September 2026 source package. Each entry is a design decision, not a test report.

ADR-001 / 2026-09-19

AOS name and scope

An environment coordinating agent tasks; not a new kernel or Linux distribution.

Design decision
ADR-002 / 2026-09-19

Two roles, one control owner

Supervisor produces plans. Operator owns the loop with one active task and action.

Design decision
ADR-003 / 2026-09-19

Model-independent roles

Initial choices are Bonsai-2 for Supervisor and Decider-2B for decision support. Joint operation is unverified.

Design decision
ADR-004 / 2026-09-19

Separate environments

Local inference on the host; Ubuntu/XFCE/noVNC Agent Computer in Docker. CachyOS is a target preference.

Design decision
ADR-005 / 2026-09-19

Prefer suitable structured tools

API → file/process/shell → DOM/CDP → accessibility → visual control. Every route passes policy checks.

Design decision
ADR-006 / 2026-09-19

Capability and registry based selection

Model, adapter, deployment and benchmark have distinct identities; selection uses only compatible, allowed candidates.

Design decision
ADR-007 / 2026-09-19

Adaptation is an experiment

One specialization LoRA for System-2; delta/continued training for System-1 are targets. Backend and adapter compatibility await verification.

Design decision
ADR-008 / 2026-09-19

From records to reviewed data

Raw records are not training data. Verification, redaction, label review and dataset splitting are required.

Design decision
ADR-009 / 2026-09-19

Explicit promotion and rollback

Held-out evaluation, authorized decision, controlled activation and rollback. No automatic production promotion.

Design decision
ADR-010 / 2026-09-19

Canonical state outside chat

The Turkish user request is retained; decision input is prepared as typed canonical English state.

Design decision
ADR-011 / 2026-09-19

Application technology direction

Tauri/React, Python/FastAPI/SQLite/uv are planned for the separate application. This static site does not run them.

Design decision
ADR-012 / 2026-09-19

Minimal isolation in the first task

Even the first file test uses a minimal gateway and an authorized workspace.

Design decision
ADR-013 / 2026-09-19

Pinnable computer image

Ubuntu 24.04 is the proposed initial base; the image digest and actual compatibility remain to be verified.

Design decision
ADR-014 / 2026-09-19

Stop on version ambiguity

Model limits are not verified until backend, checkpoint and tokenizer revisions match.

Design decision