2026-05-19 Example ADR

Decision ID: ADR-2026-05-19-001 Status: Example Date: 2026-05-19 Owner: Founder

Context

Multiple AI workers may contribute to Prox OS, but unscoped parallel edits can create merge risk and codebase cognitive debt.

Decision

Opt-in multi-agent tasks use a dated task graph that defines agent assignment, allowed paths, forbidden paths, acceptance checks, and integration plan.

Consequences

• More planning before implementation.
• Less accidental overlap between workers.
• Better run logs and integration reports.

Alternatives Considered

• Continue with single large prompts.
• Let workers self-coordinate without hard paths.

Follow-up Tasks

• Add task graph examples.
• Add worker prompt templates.
• Add integration report template.