# Heuristic System Records

This directory holds curated, retained records for agent-kit Heuristic System
operation. It sits outside `docs/` because these entries are system-level
feedback loops, not ordinary project documentation or temporary coordination
artifacts.

See `HEURISTIC_SYSTEM.md` for the framework, activation triggers, triage rules,
promotion ladder, and compression rule. This directory README only documents
what lives under each subdirectory.

## Subdirectories

- `error-inbox/` — active and archived workflow-gap trackers. Each active
  case is a folder `<slug>/` containing `ENTRY.md` and an `evidence/`
  subfolder for redacted artifacts. Completed cases keep the same folder
  shape under `error-inbox/archive/YYYY/<slug>/`. See `error-inbox/README.md`
  for the entry template and lifecycle. Use the `heuristic-error-inbox`
  workflow skill for list, verify, new, set-status, ingest-evidence, and
  archive operations.
- `operation-records/` — compressed proof that retained evidence became
  durable system behavior (tests, scripts, runbooks, primitives, or skill
  policy). Each record is a folder `<slug>/` containing `RECORD.md` plus an
  `evidence/` subfolder for validation artifacts. Raw runtime evidence is
  linked, not copied.

Both subdirectories link or summarize raw evidence from its project location.
Do not copy raw runtime evidence, secrets, credentials, or terminal dumps into
committed records. The `heuristic-inbox` nils-cli primitive (invoked through
the `heuristic-error-inbox` workflow skill) enforces a redaction guardrail
for anything written under `evidence/`; see
`HEURISTIC_SYSTEM.md#case-layout`.
