Skip to content

Documentation Debt Report

Jump to bottom
repo-wiki-bot edited this page Jun 25, 2026 · 288 revisions

Generated from: https://github.com/mfittko/dev-loops
Source commit: b58a85e
Compiled at: 2026-06-25T10:30:56.134Z
Page kind: documentation_debt_report
Page state: generated
Confidence: low
Claim status: review-needed
Primary sources: AGENTS.md, docs/conductor-routing-contract.md, docs/IMPLEMENTATION_WORKFLOW.md, docs/repo-wiki-manual-first.md, README.md, scripts/README.md, skills/dev-loop/SKILL.md
Evidence note: This page is derived from markdown documentation, which is secondary evidence. Validate operational/current-behavior claims against source, tests, CI, config, or schemas.

Documentation Debt Report

Markdown documentation is ingested as secondary evidence. It is useful for intent, terminology, onboarding, and architectural rationale, but material claims should be validated against code, tests, configuration, generated schemas, or CI before the wiki presents them as current behavior.

Configuration

{
  "ingest": true,
  "authority": "secondary",
  "include": [
    "README.md",
    "AGENTS.md",
    "docs/IMPLEMENTATION_WORKFLOW.md",
    "docs/public-dev-loop-contract.md",
    "docs/conductor-routing-contract.md",
    "docs/repo-wiki-manual-first.md",
    "scripts/README.md",
    "skills/dev-loop/SKILL.md"
  ],
  "exclude": [
    "CHANGELOG.md",
    "docs/archive/**",
    "docs/old/**",
    "docs/phases/**"
  ],
  "stale_after_days": 180,
  "require_code_validation": true,
  "allow_unvalidated_context": true,
  "preserve_original_claims": false,
  "validation_strictness": "standard",
  "fail_on_stale_docs": false,
  "fail_on_conflicting_docs": false
}

Summary

  • Documentation ingestion enabled: true
  • Documentation files scanned: 7
  • Claims extracted: 63
  • Stale documents: 1
  • Commands found in docs: 35
  • Environment variable mentions: 33
  • File path references: 198

Documentation status table

File Status Authority Age days Claims Commands Env vars
AGENTS.md unvalidated secondary 0 0 0 1
docs/conductor-routing-contract.md stale secondary 0 11 0 2
docs/IMPLEMENTATION_WORKFLOW.md partially_validated secondary 0 11 0 2
docs/repo-wiki-manual-first.md partially_validated secondary 0 10 20 18
README.md partially_validated secondary 0 11 15 4
scripts/README.md partially_validated secondary 0 15 0 4
skills/dev-loop/SKILL.md partially_validated secondary 0 5 0 2

Command validation

Commands extracted from documentation code blocks, validated against package.json scripts and CI workflow commands captured in the scan manifest.

  • Validated: 11
  • Missing (package script / Makefile / task-runner target): 6
  • Unvalidated (source unknown): 18
Command Status Source
npm install @mfittko/repo-wiki ❓ unvalidated unknown
npx repo-wiki --help ❓ unvalidated unknown
npm run repo-wiki:prepare ✅ validated package.json
npm run repo-wiki:bootstrap ✅ validated CI workflow
npm run repo-wiki:scan ✅ validated package.json
npm run repo-wiki:plan ✅ validated package.json
npm run repo-wiki:lint-docs ✅ validated package.json
npm run repo-wiki:compile ✅ validated package.json
npm run repo-wiki:lint ✅ validated CI workflow
npm run repo-wiki:local-bootstrap ❌ missing package.json
npm run repo-wiki:local-scan ❌ missing package.json
npm run repo-wiki:local-plan ❌ missing package.json
npm run repo-wiki:local-lint-docs ❌ missing package.json
npm run repo-wiki:local-compile ❌ missing package.json
npm run repo-wiki:local-lint ❌ missing package.json
npm run repo-wiki:search -- "dev-loop" ✅ validated package.json
npm run repo-wiki:init ✅ validated package.json
git diff --check ❓ unvalidated unknown
node --test test/loop/repo-wiki.test.mjs test/loop/repo-wiki-local.test.mjs ❓ unvalidated unknown
npm run verify ✅ validated CI workflow
npm install -g dev-loops # global install ❓ unvalidated unknown
npx dev-loops --help ❓ unvalidated unknown
docker build -t dev-loops . ❓ unvalidated unknown
docker run --rm -e GH_TOKEN=[REDACTED] dev-loops dev-loops loop info --repo mfittko/dev-loops --issue 1 ❓ unvalidated unknown
docker run --rm dev-loops node --version ❓ unvalidated unknown
docker run --rm dev-loops pi --version ❓ unvalidated unknown
docker run --rm dev-loops dev-loops --version ❓ unvalidated unknown
docker run --rm dev-loops gh --version ❓ unvalidated unknown
docker run --rm dev-loops git --version ❓ unvalidated unknown
docker run -it --rm \ ❓ unvalidated unknown
git clone --mirror git@github.com:owner/repo.git /tmp/mirror ❓ unvalidated unknown
git --git-dir=/tmp/mirror worktree add /tmp/run /tmp/mirror/main ❓ unvalidated unknown
npx dev-loops gates # see what reviewers will check ❓ unvalidated unknown
npx dev-loops@<version> gates ❓ unvalidated unknown
npm run verify # canonical root verification (tests + dev-loop tests) ✅ validated package.json

File path validation

Repository file and directory references extracted from markdown links and inline code spans. Generated-output roots such as dist/, coverage/, and .llmwiki/ are excluded from extraction.

  • Valid: 121
  • Missing: 77
Documentation location Reference Status Resolved path
AGENTS.md:6 skills/docs/ ✅ valid skills/docs
AGENTS.md:9 skills/docs/main-agent-contract.md ✅ valid skills/docs/main-agent-contract.md
AGENTS.md:11 tmp/worktrees/<issue-or-branch-slug>/ ❌ missing not found
AGENTS.md:12 origin/main ❌ missing not found
AGENTS.md:13 docs/worktree-guidance.md ✅ valid docs/worktree-guidance.md
AGENTS.md:19 skills/docs/artifact-authority-contract.md ✅ valid skills/docs/artifact-authority-contract.md
AGENTS.md:20 docs/IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
AGENTS.md:23 skills/docs/ ✅ valid skills/docs
docs/conductor-routing-contract.md:16 conductor-ownership.mjs ❌ missing not found
docs/conductor-routing-contract.md:17 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/conductor-routing-contract.md:17 copilot-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:17 reviewer-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:27 conductor-ownership.mjs ❌ missing not found
docs/conductor-routing-contract.md:28 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/conductor-routing-contract.md:39 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/conductor-routing-contract.md:50 packages/core/src/loop/conductor-routing.mjs ✅ valid packages/core/src/loop/conductor-routing.mjs
docs/conductor-routing-contract.md:51 packages/core/test/conductor-routing.test.mjs ✅ valid packages/core/test/conductor-routing.test.mjs
docs/conductor-routing-contract.md:52 test/loop/conductor-routing.test.mjs ✅ valid test/loop/conductor-routing.test.mjs
docs/conductor-routing-contract.md:53 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
docs/conductor-routing-contract.md:66 copilot-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:67 reviewer-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:92 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:125 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:163 scripts/loop/copilot-pr-handoff.mjs ✅ valid scripts/loop/copilot-pr-handoff.mjs
docs/conductor-routing-contract.md:165 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
docs/conductor-routing-contract.md:286 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:315 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:316 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/IMPLEMENTATION_WORKFLOW.md:13 ../skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
docs/IMPLEMENTATION_WORKFLOW.md:28 ../PLAN.md ✅ valid PLAN.md
docs/IMPLEMENTATION_WORKFLOW.md:32 ../PLAN.md ✅ valid PLAN.md
docs/IMPLEMENTATION_WORKFLOW.md:34 ./IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
docs/IMPLEMENTATION_WORKFLOW.md:41 docs/phases/phase-<n>.md ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:52 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:58 owner/name ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:59 scripts/github/resolve-tracker-local-spec.mjs ✅ valid scripts/github/resolve-tracker-local-spec.mjs
docs/IMPLEMENTATION_WORKFLOW.md:62 docs/phases/phase-<n>.md ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:64 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:81 ../scripts/README.md ✅ valid scripts/README.md
docs/IMPLEMENTATION_WORKFLOW.md:82 docs/ ✅ valid docs
docs/IMPLEMENTATION_WORKFLOW.md:92 ../README.md ✅ valid README.md
docs/IMPLEMENTATION_WORKFLOW.md:93 ../PLAN.md ✅ valid PLAN.md
docs/IMPLEMENTATION_WORKFLOW.md:94 IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
docs/IMPLEMENTATION_WORKFLOW.md:95 ./IMPLEMENTATION_WORKFLOW.md ✅ valid docs/IMPLEMENTATION_WORKFLOW.md
docs/IMPLEMENTATION_WORKFLOW.md:96 docs/ ✅ valid docs
docs/IMPLEMENTATION_WORKFLOW.md:97 ../scripts/README.md ✅ valid scripts/README.md
docs/IMPLEMENTATION_WORKFLOW.md:99 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:108 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:127 ../AGENTS.md ✅ valid AGENTS.md
docs/IMPLEMENTATION_WORKFLOW.md:128 IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
docs/IMPLEMENTATION_WORKFLOW.md:129 IMPLEMENTATION_WORKFLOW.md ✅ valid docs/IMPLEMENTATION_WORKFLOW.md
docs/IMPLEMENTATION_WORKFLOW.md:130 docs/phases/phase-<n>.md ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:131 tmp/phases/index.json ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:132 tmp/phases/phase-<n>/... ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:139 tmp/ ❌ missing not found
docs/repo-wiki-manual-first.md:22 scripts/repo-wiki.mjs ✅ valid scripts/repo-wiki.mjs
docs/repo-wiki-manual-first.md:26 @mfittko/repo-wiki@0.2.6 ❌ missing not found
docs/repo-wiki-manual-first.md:34 mfittko/repo-wiki ❌ missing not found
docs/repo-wiki-manual-first.md:44 scripts/repo-wiki-local.mjs ❌ missing not found
docs/repo-wiki-manual-first.md:80 README.md ✅ valid README.md
docs/repo-wiki-manual-first.md:132 scripts/repo-wiki.mjs ✅ valid scripts/repo-wiki.mjs
docs/repo-wiki-manual-first.md:141 scripts/repo-wiki-local.mjs ❌ missing not found
docs/repo-wiki-manual-first.md:143 mfittko/repo-wiki ❌ missing not found
docs/repo-wiki-manual-first.md:143 .tmp/repo-wiki/<ref>/source/ ❌ missing not found
docs/repo-wiki-manual-first.md:170 .github/workflows/wiki.yml ✅ valid .github/workflows/wiki.yml
docs/repo-wiki-manual-first.md:222 .github/workflows/wiki.yml ✅ valid .github/workflows/wiki.yml
README.md:21 ./skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
README.md:21 packages/core/src/loop/lifecycle-state.mjs ✅ valid packages/core/src/loop/lifecycle-state.mjs
README.md:31 ./skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
README.md:50 .claude/ ✅ valid .claude
README.md:51 .claude/.claude-plugin/plugin.json ✅ valid .claude/.claude-plugin/plugin.json
README.md:53 .claude-plugin/marketplace.json ✅ valid .claude-plugin/marketplace.json
README.md:73 PLAN.md ✅ valid PLAN.md
README.md:74 AGENTS.md ✅ valid AGENTS.md
README.md:133 package-lock.json ✅ valid package-lock.json
README.md:146 ~/.pi ❌ missing not found
README.md:157 ~/.pi ❌ missing not found
README.md:183 ./docs/index.md ✅ valid docs/index.md
README.md:187 ./extension/README.md ✅ valid extension/README.md
README.md:187 .pi/dev-loop/defaults.yaml ❌ missing not found
README.md:187 .pi/dev-loop/settings.yaml ❌ missing not found
README.md:200 ./extension/README.md ✅ valid extension/README.md
README.md:200 .pi/dev-loop/defaults.yaml ❌ missing not found
README.md:215 .pi/settings.json ❌ missing not found
README.md:244 package.json ✅ valid package.json
README.md:246 ./extension/README.md ✅ valid extension/README.md
README.md:253 @earendil-works/pi-coding-agent ❌ missing not found
README.md:253 @earendil-works/pi-tui ❌ missing not found
README.md:265 ./docs/index.md ✅ valid docs/index.md
README.md:266 ./extension/README.md ✅ valid extension/README.md
README.md:267 ./scripts/README.md ✅ valid scripts/README.md
README.md:268 ./docs/ui-smoke-harness.md ✅ valid docs/ui-smoke-harness.md
README.md:269 ./docs/ui-artifact-contract.md ✅ valid docs/ui-artifact-contract.md
README.md:270 ./docs/ui-designer-review-loop.md ✅ valid docs/ui-designer-review-loop.md
scripts/README.md:18 docs/ ✅ valid docs
scripts/README.md:22 scripts/docs/validate-links.mjs ✅ valid scripts/docs/validate-links.mjs
scripts/README.md:33 README.md ✅ valid README.md
scripts/README.md:33 PLAN.md ✅ valid PLAN.md
scripts/README.md:33 AGENTS.md ✅ valid AGENTS.md
scripts/README.md:33 scripts/README.md ✅ valid scripts/README.md
scripts/README.md:33 extension/README.md ✅ valid extension/README.md
scripts/README.md:38 docs/phases/phase-x.md ❌ missing not found
scripts/README.md:46 scripts/github/capture-review-threads.mjs ✅ valid scripts/github/capture-review-threads.mjs
scripts/README.md:71 scripts/github/create-draft-pr.mjs ✅ valid scripts/github/create-draft-pr.mjs
scripts/README.md:84 scripts/github/reconcile-draft-gate.mjs ✅ valid scripts/github/reconcile-draft-gate.mjs
scripts/README.md:90 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:120 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:146 scripts/github/resolve-tracker-local-spec.mjs ✅ valid scripts/github/resolve-tracker-local-spec.mjs
scripts/README.md:150 docs/phases/phase-<n>.md ❌ missing not found
scripts/README.md:170 scripts/github/manage-sub-issues.mjs ✅ valid scripts/github/manage-sub-issues.mjs
scripts/README.md:173 ../docs/sub-issue-tree-contract.md ✅ valid docs/sub-issue-tree-contract.md
scripts/README.md:205 scripts/refine/verify.mjs ✅ valid scripts/refine/verify.mjs
scripts/README.md:227 scripts/github/stage-reviewer-draft.mjs ✅ valid scripts/github/stage-reviewer-draft.mjs
scripts/README.md:243 repos/<owner>/<name>/pulls/<pr>/reviews ❌ missing not found
scripts/README.md:253 scripts/github/reply-resolve-review-thread.mjs ✅ valid scripts/github/reply-resolve-review-thread.mjs
scripts/README.md:267 repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies ❌ missing not found
scripts/README.md:277 scripts/github/reply-resolve-review-threads.mjs ✅ valid scripts/github/reply-resolve-review-threads.mjs
scripts/README.md:291 capture-review-threads.mjs ❌ missing not found
scripts/README.md:308 scripts/github/probe-copilot-review.mjs ✅ valid scripts/github/probe-copilot-review.mjs
scripts/README.md:332 scripts/loop/detect-initial-copilot-pr-state.mjs ✅ valid scripts/loop/detect-initial-copilot-pr-state.mjs
scripts/README.md:341 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:348 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:357 app/copilot-swe-agent ❌ missing not found
scripts/README.md:366 scripts/loop/run-conductor-cycle.mjs ✅ valid scripts/loop/run-conductor-cycle.mjs
scripts/README.md:389 run-conductor-cycle.mjs ❌ missing not found
scripts/README.md:393 scripts/loop/conductor-monitor.mjs ✅ valid scripts/loop/conductor-monitor.mjs
scripts/README.md:405 detect-copilot-loop-state.mjs ❌ missing not found
scripts/README.md:411 status.json ❌ missing not found
scripts/README.md:417 run-<n>/session.jsonl ❌ missing not found
scripts/README.md:461 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:484 scripts/loop/copilot-pr-handoff.mjs ✅ valid scripts/loop/copilot-pr-handoff.mjs
scripts/README.md:509 scripts/loop/pr-runner-coordination.mjs ✅ valid scripts/loop/pr-runner-coordination.mjs
scripts/README.md:521 .pi/runner-coordination/<owner>/<repo>/pr-<number>.json ❌ missing not found
scripts/README.md:522 .pi/ ✅ valid .pi
scripts/README.md:525 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:526 detect-checkpoint-evidence.mjs ❌ missing not found
scripts/README.md:528 scripts/loop/run-watch-cycle.mjs ✅ valid scripts/loop/run-watch-cycle.mjs
scripts/README.md:540 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:541 detect-copilot-session-activity.mjs ❌ missing not found
scripts/README.md:543 probe-copilot-review.mjs ❌ missing not found
scripts/README.md:561 scripts/loop/detect-copilot-loop-state.mjs ✅ valid scripts/loop/detect-copilot-loop-state.mjs
scripts/README.md:566 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:573 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:578 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:585 --repo/--pr ❌ missing not found
scripts/README.md:591 request-copilot-review.mjs ❌ missing not found
scripts/README.md:607 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:612 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:632 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs
scripts/README.md:660 detect-pr-gate-coordination-state.mjs ❌ missing not found
scripts/README.md:666 scripts/loop/run-refinement-audit.mjs ✅ valid scripts/loop/run-refinement-audit.mjs
scripts/README.md:695 scripts/loop/detect-pr-gate-coordination-state.mjs ✅ valid scripts/loop/detect-pr-gate-coordination-state.mjs
scripts/README.md:718 scripts/github/detect-checkpoint-evidence.mjs ✅ valid scripts/github/detect-checkpoint-evidence.mjs
scripts/README.md:741 scripts/loop/detect-tracker-pr-state.mjs ✅ valid scripts/loop/detect-tracker-pr-state.mjs
scripts/README.md:774 scripts/loop/detect-reviewer-loop-state.mjs ✅ valid scripts/loop/detect-reviewer-loop-state.mjs
scripts/README.md:779 ../docs/reviewer-loop-state-graph.md ✅ valid docs/reviewer-loop-state-graph.md
scripts/README.md:812 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
scripts/README.md:849 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:862 scripts/loop/inspect-run.mjs ✅ valid scripts/loop/inspect-run.mjs
scripts/README.md:886 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:887 tmp/copilot-loop/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:905 scripts/loop/inspect-run-viewer.mjs ✅ valid scripts/loop/inspect-run-viewer.mjs
scripts/README.md:918 .pi/ui-servers/inspect-run-viewer.json ❌ missing not found
scripts/README.md:943 scripts/loop/_inspect-run-viewer-adapter.mjs ✅ valid scripts/loop/_inspect-run-viewer-adapter.mjs
scripts/README.md:974 test-results/ ❌ missing not found
scripts/README.md:974 playwright-report/ui-smoke/inspect-run-viewer/ ❌ missing not found
scripts/README.md:978 scripts/loop/steer-loop.mjs ✅ valid scripts/loop/steer-loop.mjs
scripts/README.md:988 .pi/steering/<owner>/<repo>/pr-<n>.json ❌ missing not found
scripts/README.md:988 --repo/--pr ❌ missing not found
scripts/README.md:988 .pi/steering/<run-id>.json ❌ missing not found
skills/dev-loop/SKILL.md:13 ../docs/artifact-authority-contract.md ✅ valid skills/docs/artifact-authority-contract.md
skills/dev-loop/SKILL.md:17 ../docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
skills/dev-loop/SKILL.md:17 @dev-loops/core/loop/public-dev-loop-routing ❌ missing not found
skills/dev-loop/SKILL.md:21 ../docs/ ✅ valid skills/docs
skills/dev-loop/SKILL.md:35 ../docs/main-agent-contract.md ✅ valid skills/docs/main-agent-contract.md
skills/dev-loop/SKILL.md:38 package-root>/.pi/skills/dev-loop/SKILL.md ❌ missing not found
skills/dev-loop/SKILL.md:38 ../../.. ❌ missing not found
skills/dev-loop/SKILL.md:41 ../docs/workflow-handoff-contract.md ✅ valid skills/docs/workflow-handoff-contract.md
skills/dev-loop/SKILL.md:43 .pi/dev-loop-retrospective-checkpoint.json ❌ missing not found
skills/dev-loop/SKILL.md:54 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
skills/dev-loop/SKILL.md:57 outer-loop.mjs ❌ missing not found
skills/dev-loop/SKILL.md:64 copilot-pr-handoff.mjs ❌ missing not found
skills/dev-loop/SKILL.md:65 detect-copilot-loop-state.mjs ❌ missing not found
skills/dev-loop/SKILL.md:85 ../local-implementation/SKILL.md ✅ valid skills/local-implementation/SKILL.md
skills/dev-loop/SKILL.md:86 ../copilot-pr-followup/SKILL.md ✅ valid skills/copilot-pr-followup/SKILL.md
skills/dev-loop/SKILL.md:86 ../docs/copilot-loop-operations.md ✅ valid skills/docs/copilot-loop-operations.md
skills/dev-loop/SKILL.md:86 ../docs/issue-intake-procedure.md ✅ valid skills/docs/issue-intake-procedure.md
skills/dev-loop/SKILL.md:87 ../copilot-pr-followup/SKILL.md ✅ valid skills/copilot-pr-followup/SKILL.md
skills/dev-loop/SKILL.md:87 ../docs/copilot-loop-operations.md ✅ valid skills/docs/copilot-loop-operations.md
skills/dev-loop/SKILL.md:91 ../final-approval/SKILL.md ✅ valid skills/final-approval/SKILL.md
skills/dev-loop/SKILL.md:102 @dev-loops/core ❌ missing not found
skills/dev-loop/SKILL.md:102 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs
skills/dev-loop/SKILL.md:102 scripts/post-gate-verdict-fallback.mjs ✅ valid skills/dev-loop/scripts/post-gate-verdict-fallback.mjs
skills/dev-loop/SKILL.md:112 @dev-loops/core ❌ missing not found
skills/dev-loop/SKILL.md:123 ../docs/workflow-handoff-contract.md ✅ valid skills/docs/workflow-handoff-contract.md
skills/dev-loop/SKILL.md:125 workflow-handoff-contract.md ❌ missing not found
skills/dev-loop/SKILL.md:129 run-watch-cycle.mjs ❌ missing not found
skills/dev-loop/SKILL.md:146 ../docs/main-agent-contract.md ✅ valid skills/docs/main-agent-contract.md

Environment variable validation

Environment variable names extracted from documentation are validated against scanner-detected source usage and configured environment-variable names. Values are never copied into generated markdown.

  • Validated: 4
  • Unvalidated: 29
Documentation file Variable Status
AGENTS.md IMPLEMENTATION_STATE ❓ unvalidated
docs/conductor-routing-contract.md REVIEWER_STATE ❓ unvalidated
docs/conductor-routing-contract.md STOP_REASON ❓ unvalidated
docs/IMPLEMENTATION_WORKFLOW.md IMPLEMENTATION_STATE ❓ unvalidated
docs/IMPLEMENTATION_WORKFLOW.md IMPLEMENTATION_WORKFLOW ❓ unvalidated
docs/repo-wiki-manual-first.md OPENAI_API_KEY ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_API_KEY ✅ validated
docs/repo-wiki-manual-first.md LLMWIKI_COMPILER_MODE ✅ validated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_PROVIDER ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_BASE_URL ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_MODEL ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_ARCHITECTURE_MODEL ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_TEMPERATURE ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_REASONING_EFFORT ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_MAX_OUTPUT_TOKENS ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_ARCHITECTURE_MAX_OUTPUT_TOKENS ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_TIMEOUT_MS ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_ARCHITECTURE_TIMEOUT_MS ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_ARCHITECTURE_REASONING_EFFORT ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_RETRIES ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_SYSTEM_PROMPT ❓ unvalidated
docs/repo-wiki-manual-first.md LLMWIKI_LLM_SYSTEM_PROMPT_FILE ❓ unvalidated
docs/repo-wiki-manual-first.md GITHUB_TOKEN ❓ unvalidated
README.md DEVLOOPS_MAIN_AGENT_READONLY ✅ validated
README.md GH_TOKEN ❓ unvalidated
README.md OPENAI_API_KEY ❓ unvalidated
README.md HOME ✅ validated
scripts/README.md CONNECTED_EVENT ❓ unvalidated
scripts/README.md CROSS_REFERENCED_EVENT ❓ unvalidated
scripts/README.md PR_CHECKPOINT ❓ unvalidated
scripts/README.md PI_SUBAGENT_RUN_ID ❓ unvalidated
skills/dev-loop/SKILL.md DEVLOOPS_RUN_ID ❓ unvalidated
skills/dev-loop/SKILL.md PI_SUBAGENT_RUN_ID ❓ unvalidated

Route/API claim validation

Route and API claims from documentation prose are validated against scanner-extracted route surfaces when available.

  • Validated: 0

  • Unvalidated: 0

  • No route/API claims extracted from documentation.

ADR validation

Conservative ADR detection uses deterministic path hints (ADR/**, docs/adr/**, docs/adrs/**) and explicit markers (e.g. Status:, Superseded by:, Replaces:, or ADR heading/title markers).

  • ADR files detected: 0

  • Superseded ADRs: 0

  • Old ADRs missing status metadata: 0

  • No ADR-like documentation files detected.

Findings by category

Stale

  • docs/conductor-routing-contract.md - age 0 days, status stale

Contradicted

  • None detected.

Unvalidated

  • npm run repo-wiki:local-bootstrap - package script not found.
  • npm run repo-wiki:local-scan - package script not found.
  • npm run repo-wiki:local-plan - package script not found.
  • npm run repo-wiki:local-lint-docs - package script not found.
  • npm run repo-wiki:local-compile - package script not found.
  • npm run repo-wiki:local-lint - package script not found.
  • npm install @mfittko/repo-wiki - command source unknown.
  • npx repo-wiki --help - command source unknown.
  • git diff --check - command source unknown.
  • node --test test/loop/repo-wiki.test.mjs test/loop/repo-wiki-local.test.mjs - command source unknown.
  • npm install -g dev-loops # global install - command source unknown.
  • npx dev-loops --help - command source unknown.
  • docker build -t dev-loops . - command source unknown.
  • docker run --rm -e GH_TOKEN=[REDACTED] dev-loops dev-loops loop info --repo mfittko/dev-loops --issue 1 - command source unknown.
  • docker run --rm dev-loops node --version - command source unknown.
  • docker run --rm dev-loops pi --version - command source unknown.
  • docker run --rm dev-loops dev-loops --version - command source unknown.
  • docker run --rm dev-loops gh --version - command source unknown.
  • docker run --rm dev-loops git --version - command source unknown.
  • docker run -it --rm \ - command source unknown.
  • git clone --mirror git@github.com:owner/repo.git /tmp/mirror - command source unknown.
  • git --git-dir=/tmp/mirror worktree add /tmp/run /tmp/mirror/main - command source unknown.
  • npx dev-loops gates # see what reviewers will check - command source unknown.
  • npx dev-loops@<version> gates - command source unknown.
  • AGENTS.md mentions IMPLEMENTATION_STATE without scanner/config validation.
  • docs/conductor-routing-contract.md mentions REVIEWER_STATE without scanner/config validation.
  • docs/conductor-routing-contract.md mentions STOP_REASON without scanner/config validation.
  • docs/IMPLEMENTATION_WORKFLOW.md mentions IMPLEMENTATION_STATE without scanner/config validation.
  • docs/IMPLEMENTATION_WORKFLOW.md mentions IMPLEMENTATION_WORKFLOW without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions OPENAI_API_KEY without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_PROVIDER without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_BASE_URL without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_MODEL without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_ARCHITECTURE_MODEL without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_TEMPERATURE without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_REASONING_EFFORT without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_MAX_OUTPUT_TOKENS without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_ARCHITECTURE_MAX_OUTPUT_TOKENS without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_TIMEOUT_MS without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_ARCHITECTURE_TIMEOUT_MS without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_ARCHITECTURE_REASONING_EFFORT without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_RETRIES without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_SYSTEM_PROMPT without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions LLMWIKI_LLM_SYSTEM_PROMPT_FILE without scanner/config validation.
  • docs/repo-wiki-manual-first.md mentions GITHUB_TOKEN without scanner/config validation.
  • README.md mentions GH_TOKEN without scanner/config validation.
  • README.md mentions OPENAI_API_KEY without scanner/config validation.
  • scripts/README.md mentions CONNECTED_EVENT without scanner/config validation.
  • scripts/README.md mentions CROSS_REFERENCED_EVENT without scanner/config validation.
  • scripts/README.md mentions PR_CHECKPOINT without scanner/config validation.
  • scripts/README.md mentions PI_SUBAGENT_RUN_ID without scanner/config validation.
  • skills/dev-loop/SKILL.md mentions DEVLOOPS_RUN_ID without scanner/config validation.
  • skills/dev-loop/SKILL.md mentions PI_SUBAGENT_RUN_ID without scanner/config validation.

Broken-reference

  • AGENTS.md:11 references tmp/worktrees/<issue-or-branch-slug>/ (missing).
  • AGENTS.md:12 references origin/main (missing).
  • docs/conductor-routing-contract.md:16 references conductor-ownership.mjs (missing).
  • docs/conductor-routing-contract.md:17 references copilot-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:17 references reviewer-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:27 references conductor-ownership.mjs (missing).
  • docs/conductor-routing-contract.md:66 references copilot-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:67 references reviewer-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:92 references outer-loop.mjs (missing).
  • docs/conductor-routing-contract.md:125 references outer-loop.mjs (missing).
  • docs/conductor-routing-contract.md:286 references outer-loop.mjs (missing).
  • docs/conductor-routing-contract.md:315 references outer-loop.mjs (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:41 references docs/phases/phase-<n>.md (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:52 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:58 references owner/name (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:62 references docs/phases/phase-<n>.md (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:64 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:99 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:108 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:130 references docs/phases/phase-<n>.md (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:131 references tmp/phases/index.json (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:132 references tmp/phases/phase-<n>/... (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:139 references tmp/ (missing).
  • docs/repo-wiki-manual-first.md:26 references @mfittko/repo-wiki@0.2.6 (missing).
  • docs/repo-wiki-manual-first.md:34 references mfittko/repo-wiki (missing).
  • docs/repo-wiki-manual-first.md:44 references scripts/repo-wiki-local.mjs (missing).
  • docs/repo-wiki-manual-first.md:141 references scripts/repo-wiki-local.mjs (missing).
  • docs/repo-wiki-manual-first.md:143 references mfittko/repo-wiki (missing).
  • docs/repo-wiki-manual-first.md:143 references .tmp/repo-wiki/<ref>/source/ (missing).
  • README.md:146 references ~/.pi (missing).
  • README.md:157 references ~/.pi (missing).
  • README.md:187 references .pi/dev-loop/defaults.yaml (missing).
  • README.md:187 references .pi/dev-loop/settings.yaml (missing).
  • README.md:200 references .pi/dev-loop/defaults.yaml (missing).
  • README.md:215 references .pi/settings.json (missing).
  • README.md:253 references @earendil-works/pi-coding-agent (missing).
  • README.md:253 references @earendil-works/pi-tui (missing).
  • scripts/README.md:38 references docs/phases/phase-x.md (missing).
  • scripts/README.md:150 references docs/phases/phase-<n>.md (missing).
  • scripts/README.md:243 references repos/<owner>/<name>/pulls/<pr>/reviews (missing).
  • scripts/README.md:267 references repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies (missing).
  • scripts/README.md:291 references capture-review-threads.mjs (missing).
  • scripts/README.md:357 references app/copilot-swe-agent (missing).
  • scripts/README.md:389 references run-conductor-cycle.mjs (missing).
  • scripts/README.md:405 references detect-copilot-loop-state.mjs (missing).
  • scripts/README.md:411 references status.json (missing).
  • scripts/README.md:417 references run-<n>/session.jsonl (missing).
  • scripts/README.md:521 references .pi/runner-coordination/<owner>/<repo>/pr-<number>.json (missing).
  • scripts/README.md:525 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:526 references detect-checkpoint-evidence.mjs (missing).
  • scripts/README.md:540 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:541 references detect-copilot-session-activity.mjs (missing).
  • scripts/README.md:543 references probe-copilot-review.mjs (missing).
  • scripts/README.md:585 references --repo/--pr (missing).
  • scripts/README.md:591 references request-copilot-review.mjs (missing).
  • scripts/README.md:660 references detect-pr-gate-coordination-state.mjs (missing).
  • scripts/README.md:849 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:886 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:887 references tmp/copilot-loop/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:918 references .pi/ui-servers/inspect-run-viewer.json (missing).
  • scripts/README.md:974 references test-results/ (missing).
  • scripts/README.md:974 references playwright-report/ui-smoke/inspect-run-viewer/ (missing).
  • scripts/README.md:988 references .pi/steering/<owner>/<repo>/pr-<n>.json (missing).
  • scripts/README.md:988 references --repo/--pr (missing).
  • scripts/README.md:988 references .pi/steering/<run-id>.json (missing).
  • skills/dev-loop/SKILL.md:17 references @dev-loops/core/loop/public-dev-loop-routing (missing).
  • skills/dev-loop/SKILL.md:38 references package-root>/.pi/skills/dev-loop/SKILL.md (missing).
  • skills/dev-loop/SKILL.md:38 references ../../.. (missing).
  • skills/dev-loop/SKILL.md:43 references .pi/dev-loop-retrospective-checkpoint.json (missing).
  • skills/dev-loop/SKILL.md:54 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • skills/dev-loop/SKILL.md:57 references outer-loop.mjs (missing).
  • skills/dev-loop/SKILL.md:64 references copilot-pr-handoff.mjs (missing).
  • skills/dev-loop/SKILL.md:65 references detect-copilot-loop-state.mjs (missing).
  • skills/dev-loop/SKILL.md:102 references @dev-loops/core (missing).
  • skills/dev-loop/SKILL.md:112 references @dev-loops/core (missing).
  • skills/dev-loop/SKILL.md:125 references workflow-handoff-contract.md (missing).
  • skills/dev-loop/SKILL.md:129 references run-watch-cycle.mjs (missing).

ADR-specific

  • None detected.

Compiler policy

  • Do not suppress documentation by default.
  • Never treat docs as more authoritative than code at the pinned commit.
  • Promote documentation-derived claims only when validated or clearly labeled.
  • Include unvalidated operational claims in this report and in Open Questions.
  • Fail publishing when project policy marks stale or contradicted docs as error-level.

Generated from: https://github.com/mfittko/dev-loops
Source commit: 3a57ddf
Compiled at: 2026-07-11T01:39:45.675Z
Page kind: sidebar
Page state: generated
Confidence: medium

Navigation

Modules

Cross-cutting

Clone this wiki locally