docs: refactoring-backlog workspace — baseline + 3 Phase 1 agents

Runs the multi-agent refactoring-backlog pipeline in docs/project/
refactor-backlog-setup/ up to and including three of the seven Phase 1
agents.

00-baseline.md establishes the metrics every later agent must cite, using
only tooling already in the repo (vitest lcov, coverlet cobertura, ESLint's
core `complexity` rule at threshold 0 for a full distribution, depcruise
--metrics). Duplication and C# complexity had no tooling, so
tools/baseline-scan.mjs adds a deterministic ~200-line text scan rather
than a new dependency; the approximations are labelled as such.

Headline: FE 75.1% line coverage but only over the 98 of 220 source files a
spec loads; BE 97.6% line / 79.6% branch; 0 layering violations; 7.1%
duplication; 25 of 2085 TS functions over CC 10.

Then 02-testability, 04-cqrs-light and 06-adr-conformance (27 findings).
01/03/05 were skipped deliberately — the baseline shows little for them to
find; 07 (BIO2) and 08 (consolidation) are still open.

Each agent corrected a baseline observation of mine, and in every case the
error was in something derived rather than measured:

- BL-007 counted ~13 adapter "mutations" from the `runSubmit` helper name;
  5 of those call sites are reads. It also missed 3 real mutations that
  reach the raw ApiClient and never return a Result.
- BL-002 diagnosed the 100%-duplicated auth folders as ADR-0002's
  divergence prediction failing. It never had a chance to fail: §3's
  `Principal` union was never built.
- BL-004 named libs/shared/domain and libs/beheer/contracts as coverage
  gaps; both are pure type declarations where 0% is unimprovable.

All three corrections are recorded inline in 00-baseline.md §10, so agent
08 does not inherit the bad numbers.

.prettierignore excludes the agent prompt directories — reflowing their
markdown would edit the prompt text itself.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/project/refactor-backlog-setup/setup.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# Sets up the multi-agent refactoring backlog workspace.
+# Run from the root of the target repo: bash setup.sh
+set -euo pipefail
+
+WORK_DIR="./refactor-backlog"
+AGENTS_SRC="$(dirname "$0")/agents"
+PROTOCOL="$AGENTS_SRC/_persistence-protocol.md"
+
+echo "Setting up $WORK_DIR ..."
+mkdir -p "$WORK_DIR/implementation"
+mkdir -p "$WORK_DIR/final-prompts"
+
+# 1. Initialize _status.md
+cat > "$WORK_DIR/_status.md" << 'EOF'
+# Agent run status
+
+| Agent | Status | Last module processed | Last updated | Notes |
+|---|---|---|---|---|
+| baseline | not_started | - | - | |
+| readability | not_started | - | - | |
+| testability | not_started | - | - | |
+| ddd-hexagonal | not_started | - | - | |
+| cqrs-light | not_started | - | - | |
+| bdd | not_started | - | - | |
+| adr-conformance | not_started | - | - | |
+| bio2-compliance | not_started | - | - | |
+| consolidation | not_started | - | - | |
+EOF
+echo "  created _status.md"
+
+# 2. Initialize empty output files with headers
+for f in 00-baseline 01-readability 02-testability 03-ddd-hexagonal \
+         04-cqrs-light 05-bdd 06-adr-conformance 07-bio2-compliance; do
+  cat > "$WORK_DIR/${f}.md" << EOF
+## Scope: [to be filled by agent]
+## Status: not_started
+## Last updated: -
+## Depends on: [see agent prompt]
+## ---
+EOF
+done
+touch "$WORK_DIR/99-backlog.md"
+echo "  initialized 8 phase-1 output files + 99-backlog.md"
+
+# 3. Assemble final prompts: inject persistence protocol into each agent prompt
+#    at the "[Insert contents of _persistence-protocol.md here...]" marker.
+for src in "$AGENTS_SRC"/*.prompt.md; do
+  name="$(basename "$src")"
+  out="$WORK_DIR/final-prompts/$name"
+  awk -v protofile="$PROTOCOL" '
+    /\[Insert contents of _persistence-protocol\.md here/ {
+      while ((getline line < protofile) > 0) print line
+      close(protofile)
+      next
+    }
+    { print }
+  ' "$src" > "$out"
+  echo "  assembled final-prompts/$name"
+done
+
+echo ""
+echo "Done. Structure:"
+echo "  $WORK_DIR/_status.md              (run tracker — all agents not_started)"
+echo "  $WORK_DIR/00-baseline.md ... 07-bio2-compliance.md   (empty, agent-writable)"
+echo "  $WORK_DIR/99-backlog.md           (empty, Consolidation writes here)"
+echo "  $WORK_DIR/implementation/         (Phase 3 notes land here)"
+echo "  $WORK_DIR/final-prompts/          (ready-to-dispatch prompts, protocol"
+echo "                                     already merged in — no manual copy-paste)"
+echo ""
+echo "Next: dispatch final-prompts/00-baseline.prompt.md first (blocks everything),"
+echo "then the 7 Phase 1 prompts in parallel, then 08-consolidation.prompt.md,"
+echo "then per-ticket 09-implementation.prompt.md (fill in TICKET-ID each time)."