ijfw-audit

Run the audit gate for the current (or named) phase of the active IJFW workflow. Every IJFW workflow phase has a built-in audit checklist -- this command fires it explicitly without advancing to the next phase.

Ledger gate (Damir Law 4 scope -- run before any gate): Read .ijfw/state/execute-issues.json at the start of every audit run:

read_issues() {
  local f=".ijfw/state/execute-issues.json"
  [ -f "$f" ] || { printf '{"issues":[]}'; return; }
  cat "$f"
}

If any entry has status: unresolved, halt with the list before running any phase gate:

ISSUE: unresolved-execute-issues
  count: <N>
  ids: [iss_001]
  action: resolve with /ijfw-execute resolve <id> <note> first

Missing file = zero issues (day-1 fresh-install protection). Do not crash.

Phase audit gates available:

• DISCOVER AUDIT -- scope boundaries, success criteria, no hidden assumptions
• RESEARCH AUDIT -- findings validated, red flags surfaced, brief updated if needed
• PLAN AUDIT -- every requirement has a task, no scope drops, dependencies ordered
• TASK MICRO-AUDIT -- per-task: success criteria met, nothing outside scope changed
• PHASE AUDIT -- all phase tasks complete, brief still accurate, memory updated
• SHIP GATE -- original brief re-read, what was built matches what was asked

Run the gate, fix any failures, then continue. IJFW tracks gate outcomes in audit-log.md for the active project.

Natural triggers: "audit this phase", "run the gate", "check before we move on", "audit checkpoint", "gate check."

If you name a phase explicitly (e.g. /ijfw-audit plan), that gate runs regardless of the current workflow position. Omit the argument and the current phase gate runs.

GATE: Each audit gate is a hard stop -- fix failures before the next phase begins. Gate outcomes are recorded in audit-log.md for the active project.

Confidence declaration (required per finding): Every audit finding is tagged VERIFIED / LIKELY / GUESSING / ISSUE:

• VERIFIED -- command run, raw output shown, reproducible.
• LIKELY -- code read, docs consulted, reasoning given, not externally verified.
• GUESSING -- insufficient information, best guess only.
• ISSUE -- blocker or bug; document and halt.

Gate outcomes with any GUESSING or ISSUE finding do not auto-advance. This is the scoped adoption of Damir Zorcic's "Declare Confidence" law at audit boundaries.