pharaoh-decision-review

name	pharaoh-decision-review
description	Use when auditing a single recorded decision (DR / ADR / design note) against the generic decision review axes in `shared/checklists/decision.md`. Checks context/alternatives/consequences structure, traceability to affected artefacts, rationale completeness. Emits structured findings JSON.
chains_from	["pharaoh-decision-record"]
chains_to	[]

pharaoh-decision-review

When to use

Invoke after pharaoh-decision-record wrote a decision memory. Part of the self-review invariant.

Atomicity

• (a) One decision + one checklist in → one findings JSON out.
• (b) Input: {target: <decision_rst_or_memory_id>, checklist_path: <path>, tailoring_path: <path>}. Output: findings JSON.
• (c) Reward: fixtures passing-decision.rst + failing-decision.rst with expected findings.
• (d) Reusable.
• (e) Read-only.

Input

• target: RST directive block for a decision directive, OR a Papyrus memory_id of type decision.
• checklist_path: shared/checklists/decision.md.

Output

{
  "need_id": "dr__example",
  "type": "decision",
  "axes": {
    "context_section_present":    {"passed": true},
    "alternatives_listed":        {"passed": true, "reason": "3 alternatives + chosen=4"},
    "consequences_section_present":{"passed": true},
    "trace_to_affected_artefacts":{"passed": true, "reason": "links 2 reqs and 1 arch"},
    "canonical_name_unique":      {"passed": true, "reason": "no dup in papyrus"},
    "rationale_quality":          {"score": 3}
  },
  "overall": "pass"
}

Review axes

See shared/checklists/decision.md.