docs/decisions/README.md

Decisions

Decision records explain why important product, architecture, or harness choices were made.

Use docs/templates/decision.md when adding a new decision.

After adding or updating a markdown decision file, also add or refresh the durable decision row:

scripts/bin/harness-cli decision add \
  --id 0008-auth-boundary \
  --title "Auth Boundary" \
  --doc docs/decisions/0008-auth-boundary.md

Trace fields such as --decisions summarize task-level choices. They do not count as the Harness decision log.

Add a decision when:

• A locked technical choice changes.
• A product rule changes meaningfully.
• A validation requirement is added, removed, or weakened.
• A high-risk feature chooses one design over another.
• Auth, authorization, data ownership, audit/security, or API behavior changes.
• The source-of-truth hierarchy changes.