Skip to content

Documentation Debt Report

Jump to bottom
repo-wiki-bot edited this page Jul 4, 2026 · 280 revisions

Generated from: https://github.com/mfittko/dev-loops
Source commit: 227d64f
Compiled at: 2026-07-04T13:42:18.485Z
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: 65
  • Stale documents: 2
  • Commands found in docs: 34
  • Environment variable mentions: 33
  • File path references: 214

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 13 14 5
scripts/README.md stale secondary 0 15 0 4
skills/dev-loop/SKILL.md partially_validated secondary 0 5 0 1

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): 17
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
npx dev-loops@<version> --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@<version> 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: 132
  • Missing: 82
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
AGENTS.md:26 skills/docs/cross-harness-regression-contract.md ✅ valid skills/docs/cross-harness-regression-contract.md
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:65 .claude/ ✅ valid .claude
README.md:66 .claude/.claude-plugin/plugin.json ✅ valid .claude/.claude-plugin/plugin.json
README.md:68 .claude-plugin/marketplace.json ✅ valid .claude-plugin/marketplace.json
README.md:88 PLAN.md ✅ valid PLAN.md
README.md:89 AGENTS.md ✅ valid AGENTS.md
README.md:148 package-lock.json ✅ valid package-lock.json
README.md:161 ~/.pi ❌ missing not found
README.md:172 ~/.pi ❌ missing not found
README.md:198 ./docs/index.md ✅ valid docs/index.md
README.md:202 ./extension/README.md ✅ valid extension/README.md
README.md:202 .pi/dev-loop/defaults.yaml ❌ missing not found
README.md:202 .pi/dev-loop/settings.yaml ❌ missing not found
README.md:215 ./extension/README.md ✅ valid extension/README.md
README.md:215 .pi/dev-loop/defaults.yaml ❌ missing not found
README.md:221 ./docs/migrating-to-dev-loops.md ✅ valid docs/migrating-to-dev-loops.md
README.md:236 .pi/settings.json ❌ missing not found
README.md:269 package.json ✅ valid package.json
README.md:271 ./extension/README.md ✅ valid extension/README.md
README.md:278 @earendil-works/pi-coding-agent ❌ missing not found
README.md:278 @earendil-works/pi-tui ❌ missing not found
README.md:290 ./docs/index.md ✅ valid docs/index.md
README.md:291 ./extension/README.md ✅ valid extension/README.md
README.md:292 ./scripts/README.md ✅ valid scripts/README.md
README.md:293 ./docs/ui-smoke-harness.md ✅ valid docs/ui-smoke-harness.md
README.md:294 ./docs/ui-artifact-contract.md ✅ valid docs/ui-artifact-contract.md
README.md:295 ./docs/ui-designer-review-loop.md ✅ valid docs/ui-designer-review-loop.md
README.md:296 ./docs/slides-story-review-loop.md ✅ valid docs/slides-story-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-pr.mjs ✅ valid scripts/github/create-pr.mjs
scripts/README.md:85 scripts/github/reconcile-draft-gate.mjs ✅ valid scripts/github/reconcile-draft-gate.mjs
scripts/README.md:91 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:121 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:147 scripts/github/resolve-tracker-local-spec.mjs ✅ valid scripts/github/resolve-tracker-local-spec.mjs
scripts/README.md:151 docs/phases/phase-<n>.md ❌ missing not found
scripts/README.md:171 scripts/github/manage-sub-issues.mjs ✅ valid scripts/github/manage-sub-issues.mjs
scripts/README.md:174 ../docs/sub-issue-tree-contract.md ✅ valid docs/sub-issue-tree-contract.md
scripts/README.md:206 scripts/refine/verify.mjs ✅ valid scripts/refine/verify.mjs
scripts/README.md:228 scripts/github/stage-reviewer-draft.mjs ✅ valid scripts/github/stage-reviewer-draft.mjs
scripts/README.md:244 repos/<owner>/<name>/pulls/<pr>/reviews ❌ missing not found
scripts/README.md:254 scripts/github/reply-resolve-review-thread.mjs ✅ valid scripts/github/reply-resolve-review-thread.mjs
scripts/README.md:268 repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies ❌ missing not found
scripts/README.md:278 scripts/github/reply-resolve-review-threads.mjs ✅ valid scripts/github/reply-resolve-review-threads.mjs
scripts/README.md:292 capture-review-threads.mjs ❌ missing not found
scripts/README.md:309 scripts/github/probe-copilot-review.mjs ✅ valid scripts/github/probe-copilot-review.mjs
scripts/README.md:333 scripts/loop/detect-initial-copilot-pr-state.mjs ✅ valid scripts/loop/detect-initial-copilot-pr-state.mjs
scripts/README.md:342 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:349 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:358 app/copilot-swe-agent ❌ missing not found
scripts/README.md:367 scripts/loop/run-conductor-cycle.mjs ✅ valid scripts/loop/run-conductor-cycle.mjs
scripts/README.md:390 run-conductor-cycle.mjs ❌ missing not found
scripts/README.md:394 scripts/loop/conductor-monitor.mjs ✅ valid scripts/loop/conductor-monitor.mjs
scripts/README.md:406 detect-copilot-loop-state.mjs ❌ missing not found
scripts/README.md:412 status.json ❌ missing not found
scripts/README.md:418 run-<n>/session.jsonl ❌ missing not found
scripts/README.md:462 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:485 scripts/loop/copilot-pr-handoff.mjs ✅ valid scripts/loop/copilot-pr-handoff.mjs
scripts/README.md:510 scripts/loop/pr-runner-coordination.mjs ✅ valid scripts/loop/pr-runner-coordination.mjs
scripts/README.md:522 .pi/runner-coordination/<owner>/<repo>/pr-<number>.json ❌ missing not found
scripts/README.md:523 .pi/ ✅ valid .pi
scripts/README.md:526 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:527 detect-checkpoint-evidence.mjs ❌ missing not found
scripts/README.md:529 scripts/loop/run-watch-cycle.mjs ✅ valid scripts/loop/run-watch-cycle.mjs
scripts/README.md:541 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:542 detect-copilot-session-activity.mjs ❌ missing not found
scripts/README.md:544 probe-copilot-review.mjs ❌ missing not found
scripts/README.md:562 scripts/loop/detect-copilot-loop-state.mjs ✅ valid scripts/loop/detect-copilot-loop-state.mjs
scripts/README.md:567 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:574 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:579 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:586 --repo/--pr ❌ missing not found
scripts/README.md:592 request-copilot-review.mjs ❌ missing not found
scripts/README.md:608 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:613 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:633 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs
scripts/README.md:661 detect-pr-gate-coordination-state.mjs ❌ missing not found
scripts/README.md:667 scripts/loop/run-refinement-audit.mjs ✅ valid scripts/loop/run-refinement-audit.mjs
scripts/README.md:696 scripts/loop/detect-pr-gate-coordination-state.mjs ✅ valid scripts/loop/detect-pr-gate-coordination-state.mjs
scripts/README.md:719 scripts/github/detect-checkpoint-evidence.mjs ✅ valid scripts/github/detect-checkpoint-evidence.mjs
scripts/README.md:742 scripts/loop/detect-tracker-pr-state.mjs ✅ valid scripts/loop/detect-tracker-pr-state.mjs
scripts/README.md:775 scripts/loop/detect-reviewer-loop-state.mjs ✅ valid scripts/loop/detect-reviewer-loop-state.mjs
scripts/README.md:780 ../docs/reviewer-loop-state-graph.md ✅ valid docs/reviewer-loop-state-graph.md
scripts/README.md:813 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
scripts/README.md:850 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:863 scripts/loop/inspect-run.mjs ✅ valid scripts/loop/inspect-run.mjs
scripts/README.md:887 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:888 tmp/copilot-loop/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:906 scripts/loop/inspect-run-viewer.mjs ✅ valid scripts/loop/inspect-run-viewer.mjs
scripts/README.md:919 .pi/ui-servers/inspect-run-viewer.json ❌ missing not found
scripts/README.md:944 scripts/loop/_inspect-run-viewer-adapter.mjs ✅ valid scripts/loop/_inspect-run-viewer-adapter.mjs
scripts/README.md:975 test-results/ ❌ missing not found
scripts/README.md:975 playwright-report/ui-smoke/inspect-run-viewer/ ❌ missing not found
scripts/README.md:979 scripts/loop/steer-loop.mjs ✅ valid scripts/loop/steer-loop.mjs
scripts/README.md:989 .pi/steering/<owner>/<repo>/pr-<n>.json ❌ missing not found
scripts/README.md:989 --repo/--pr ❌ missing not found
scripts/README.md:989 .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 cli/index.mjs ✅ valid cli/index.mjs
skills/dev-loop/SKILL.md:38 ~/.pi/agent/npm/node_modules/dev-loops/ ❌ missing not found
skills/dev-loop/SKILL.md:38 ../../.. ❌ missing not found
skills/dev-loop/SKILL.md:38 skills/dev-loop/SKILL.md ✅ valid skills/dev-loop/SKILL.md
skills/dev-loop/SKILL.md:40 ~/.pi/agent/npm ❌ missing not found
skills/dev-loop/SKILL.md:41 ~/.pi/agent/npm/node_modules/dev-loops ❌ missing not found
skills/dev-loop/SKILL.md:42 ../../.. ❌ missing not found
skills/dev-loop/SKILL.md:48 ../docs/workflow-handoff-contract.md ✅ valid skills/docs/workflow-handoff-contract.md
skills/dev-loop/SKILL.md:50 .pi/dev-loop-retrospective-checkpoint.json ❌ missing not found
skills/dev-loop/SKILL.md:61 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
skills/dev-loop/SKILL.md:64 outer-loop.mjs ❌ missing not found
skills/dev-loop/SKILL.md:71 copilot-pr-handoff.mjs ❌ missing not found
skills/dev-loop/SKILL.md:72 detect-copilot-loop-state.mjs ❌ missing not found
skills/dev-loop/SKILL.md:92 ../local-implementation/SKILL.md ✅ valid skills/local-implementation/SKILL.md
skills/dev-loop/SKILL.md:93 ../copilot-pr-followup/SKILL.md ✅ valid skills/copilot-pr-followup/SKILL.md
skills/dev-loop/SKILL.md:93 ../docs/copilot-loop-operations.md ✅ valid skills/docs/copilot-loop-operations.md
skills/dev-loop/SKILL.md:93 ../docs/issue-intake-procedure.md ✅ valid skills/docs/issue-intake-procedure.md
skills/dev-loop/SKILL.md:94 ../copilot-pr-followup/SKILL.md ✅ valid skills/copilot-pr-followup/SKILL.md
skills/dev-loop/SKILL.md:94 ../docs/copilot-loop-operations.md ✅ valid skills/docs/copilot-loop-operations.md
skills/dev-loop/SKILL.md:98 ../final-approval/SKILL.md ✅ valid skills/final-approval/SKILL.md
skills/dev-loop/SKILL.md:109 @dev-loops/core ❌ missing not found
skills/dev-loop/SKILL.md:109 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs

Showing first 200 of 214 file path findings.

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: 5
  • Unvalidated: 28
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 ✅ validated
README.md OPENAI_API_KEY ❓ unvalidated
README.md HOME ✅ validated
README.md PI_ ❓ unvalidated
scripts/README.md CONNECTED_EVENT ❓ unvalidated
scripts/README.md CROSS_REFERENCED_EVENT ❓ unvalidated
scripts/README.md PR_CHECKPOINT ❓ unvalidated
scripts/README.md DEVLOOPS_RUN_ID ❓ unvalidated
skills/dev-loop/SKILL.md DEVLOOPS_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: 2
Claim location Route claim Status Evidence / reason
README.md:46 ALL /dev-loops:dev-loop ❓ unvalidated route claim did not match scanner route surfaces for path /dev-loops:dev-loop.
skills/dev-loop/SKILL.md:156 POST / ❓ unvalidated route claim did not match scanner route surfaces for path /.

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
  • scripts/README.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.
  • npx dev-loops@<version> --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@<version> 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 OPENAI_API_KEY without scanner/config validation.
  • README.md mentions PI_ 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 DEVLOOPS_RUN_ID without scanner/config validation.
  • skills/dev-loop/SKILL.md mentions DEVLOOPS_RUN_ID without scanner/config validation.
  • README.md:46 - route claim did not match scanner route surfaces for path /dev-loops:dev-loop.
  • skills/dev-loop/SKILL.md:156 - route claim did not match scanner route surfaces for path /.

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:161 references ~/.pi (missing).
  • README.md:172 references ~/.pi (missing).
  • README.md:202 references .pi/dev-loop/defaults.yaml (missing).
  • README.md:202 references .pi/dev-loop/settings.yaml (missing).
  • README.md:215 references .pi/dev-loop/defaults.yaml (missing).
  • README.md:236 references .pi/settings.json (missing).
  • README.md:278 references @earendil-works/pi-coding-agent (missing).
  • README.md:278 references @earendil-works/pi-tui (missing).
  • scripts/README.md:38 references docs/phases/phase-x.md (missing).
  • scripts/README.md:151 references docs/phases/phase-<n>.md (missing).
  • scripts/README.md:244 references repos/<owner>/<name>/pulls/<pr>/reviews (missing).
  • scripts/README.md:268 references repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies (missing).
  • scripts/README.md:292 references capture-review-threads.mjs (missing).
  • scripts/README.md:358 references app/copilot-swe-agent (missing).
  • scripts/README.md:390 references run-conductor-cycle.mjs (missing).
  • scripts/README.md:406 references detect-copilot-loop-state.mjs (missing).
  • scripts/README.md:412 references status.json (missing).
  • scripts/README.md:418 references run-<n>/session.jsonl (missing).
  • scripts/README.md:522 references .pi/runner-coordination/<owner>/<repo>/pr-<number>.json (missing).
  • scripts/README.md:526 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:527 references detect-checkpoint-evidence.mjs (missing).
  • scripts/README.md:541 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:542 references detect-copilot-session-activity.mjs (missing).
  • scripts/README.md:544 references probe-copilot-review.mjs (missing).
  • scripts/README.md:586 references --repo/--pr (missing).
  • scripts/README.md:592 references request-copilot-review.mjs (missing).
  • scripts/README.md:661 references detect-pr-gate-coordination-state.mjs (missing).
  • scripts/README.md:850 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:887 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:888 references tmp/copilot-loop/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:919 references .pi/ui-servers/inspect-run-viewer.json (missing).
  • scripts/README.md:975 references test-results/ (missing).
  • scripts/README.md:975 references playwright-report/ui-smoke/inspect-run-viewer/ (missing).
  • scripts/README.md:989 references .pi/steering/<owner>/<repo>/pr-<n>.json (missing).
  • scripts/README.md:989 references --repo/--pr (missing).
  • scripts/README.md:989 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 ~/.pi/agent/npm/node_modules/dev-loops/ (missing).
  • skills/dev-loop/SKILL.md:38 references ../../.. (missing).
  • skills/dev-loop/SKILL.md:40 references ~/.pi/agent/npm (missing).
  • skills/dev-loop/SKILL.md:41 references ~/.pi/agent/npm/node_modules/dev-loops (missing).
  • skills/dev-loop/SKILL.md:42 references ../../.. (missing).
  • skills/dev-loop/SKILL.md:50 references .pi/dev-loop-retrospective-checkpoint.json (missing).
  • skills/dev-loop/SKILL.md:61 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • skills/dev-loop/SKILL.md:64 references outer-loop.mjs (missing).
  • skills/dev-loop/SKILL.md:71 references copilot-pr-handoff.mjs (missing).
  • skills/dev-loop/SKILL.md:72 references detect-copilot-loop-state.mjs (missing).
  • skills/dev-loop/SKILL.md:109 references @dev-loops/core (missing).
  • skills/dev-loop/SKILL.md:119 references @dev-loops/core (missing).
  • skills/dev-loop/SKILL.md:136 references probe-ci-status.mjs (missing).
  • skills/dev-loop/SKILL.md:143 references probe-ci-status.mjs (missing).
  • skills/dev-loop/SKILL.md:150 references workflow-handoff-contract.md (missing).
  • skills/dev-loop/SKILL.md:154 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: 4c24555
Compiled at: 2026-07-10T15:37:39.464Z
Page kind: sidebar
Page state: generated
Confidence: medium

Navigation

Modules

Cross-cutting

Clone this wiki locally