audit

Audit Documentation Package: $ARGUMENTS

Three independent passes, three isolated contexts, three findings tables collected verbatim.

Required Skills

• engagement-scoping — resolve the package root and the scope each pass receives
• doc-package-contract — structural precheck before spending any pass budget

Non-goals

This command must not merge findings, adjudicate disagreements, judge severity, repair anything, or compute a gate verdict. Those belong to /dossier:reconcile and /dossier:gate.

The separation is structural, not stylistic. An orchestrator that merged findings would need the reconciliation logic in its context, and anything in this context is one dispatch away from a verifier's.

References

• independent-audit-protocol.md
• finding-schema.md
• scorecard-rubric.md

Phase 0 — Precheck

_RAW="$ARGUMENTS"
echo "### Audit Arguments"
echo "ARGS=$_RAW"

__dr="${CLAUDE_PLUGIN_ROOT:-}"
[ -x "$__dr/bin/dossier-package-check.sh" ] || __dr=$({ echo plugins/dossier; ls -d "$HOME"/.claude/plugins/cache/synapti-marketplace/dossier/*/ 2>/dev/null | sort -Vr; echo "$HOME/.claude/plugins/marketplaces/synapti-marketplace/plugins/dossier"; } | while read -r __p; do [ -x "${__p%/}/bin/dossier-package-check.sh" ] && { echo "${__p%/}"; break; }; done)

echo "### Preflight"
if [ ! -x "$__dr/bin/dossier-package-check.sh" ]; then
  echo "AUDIT_STATE=blocked"
  echo "AUDIT_ERROR=dossier plugin scripts not found — reinstall or upgrade the plugin"
  true; exit 0
fi

OUTPUT_ROOT=$("$__dr/bin/dossier-resolve-config.sh" --default "docs/dossier" dossier.project.outputRoot 2>/dev/null)
echo "OUTPUT_ROOT=$OUTPUT_ROOT"
echo "PACKAGE_EXISTS=$([ -d "$OUTPUT_ROOT/00-control" ] && echo true || echo false)"
echo "PINNED_VERSION=$("$__dr/bin/dossier-resolve-config.sh" --default auto dossier.project.versionOrCommit 2>/dev/null)"
echo "PASS_MODELS=$("$__dr/bin/dossier-resolve-config.sh" --compact --default '{}' dossier.verification.passModels 2>/dev/null)"
echo "TRACE_COUNT=$("$__dr/bin/dossier-resolve-config.sh" --default 10 dossier.verification.traceCount 2>/dev/null)"

echo "### Structural precheck"
"$__dr/bin/dossier-package-check.sh" --output-root "$OUTPUT_ROOT" 2>&1 | head -20 || true

echo "### Prior rounds"
if [ -d .dossier/runs ]; then
  echo "PRIOR_ROUNDS=$(ls -1d .dossier/runs/*/ 2>/dev/null | wc -l | tr -d ' ')"
else
  echo "PRIOR_ROUNDS=0"
fi
true