FREE · understand

Decision Memory

Preserve evidence-backed reasoning while it is still recoverable and flag the parts that need confirmation.

01 · THE SITUATION

“The client asks why refund approvals work this way, and the rationale is scattered across a pull request, ticket, and prompt change.”

Important rationale is scattered across pull requests, tickets, commits, and the memories of the delivery team.

REPOSITORY → ACTION → ARTIFACT → OUTCOME

Watch the work move.

02 · WHAT IT READS

acme-support-agent/fictional fixture
  • src/
    • agent/orchestrator.py
  • prompts/
    • refund-triage.md
  • tools/
    • refund_api.py
  • evals/
    • probes/refund-routing.yaml
  • config/
    • routing.toml
  • docs/
    • runbook.md
  • events/commit-7ac21f.jsonChanges and messages recorded during delivery.
  • events/pr-184.jsonReview discussion and implementation evidence.
  • events/ticket-ACME-91.jsonClient requirement and acceptance rationale.
  • repo/prompts/refund-triage.md + repo/config/routing.tomlThe shipped expression of the approval decision.

03 · WHAT THE FDE DOES

workbenchIllustrative planned interaction

Recover decision evidence

Planned workflow — illustrative.

coding agentIllustrative planned interaction

Trace the decision

Find evidence for the refund approval decision; cite each source and mark unsupported rationale for confirmation.

Planned coding-agent workflow — illustrative.

  1. 01Find changes that altered an important system behavior.
  2. 02Correlate contemporaneous repository and delivery evidence.
  3. 03Draft a rationale with confidence and confirmation state.

04 · WHAT GETS PRODUCED

outputs/decisions.jsonIllustrative fixture

Evidence-linked decision record

decision
two approvers above threshold
evidence
PR-184 · ACME-91
business intent
owner confirmation required

A decision card connecting the approval rule to its source evidence and confirmation state.

05 · WORK AVOIDED

You no longer reconstruct the decision from memory or old chat threads months later.

06 · CREDIBILITY BOUNDARY

What this cannot know or do.

  • When recoverable evidence does not explain the rationale, Decision Memory marks it unknown and asks a human to confirm it.

07 · NEXT STEP

Try the workflow in context.

Use the fictional repository demo to inspect the whole free-layer sequence before touching a real project.