Skip to content

Documentation Debt Report

Jump to bottom
repo-wiki-bot edited this page Jun 15, 2026 · 289 revisions

Generated from: https://github.com/mfittko/dev-loops
Source commit: b77d27d
Compiled at: 2026-06-15T23:37:42.793Z
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: 61
  • Stale documents: 1
  • Commands found in docs: 32
  • Environment variable mentions: 31
  • File path references: 189

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 6 12 3
scripts/README.md partially_validated secondary 0 15 0 4
skills/dev-loop/SKILL.md partially_validated secondary 0 8 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: 17
  • Missing (package script / Makefile / task-runner target): 0
  • Unvalidated (source unknown): 15
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 ✅ validated package.json
npm run repo-wiki:local-scan ✅ validated package.json
npm run repo-wiki:local-plan ✅ validated package.json
npm run repo-wiki:local-lint-docs ✅ validated package.json
npm run repo-wiki:local-compile ✅ validated package.json
npm run repo-wiki:local-lint ✅ validated 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
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
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: 119
  • Missing: 70
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 ✅ valid scripts/repo-wiki-local.mjs
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 ✅ valid scripts/repo-wiki-local.mjs
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:72 package-lock.json ✅ valid package-lock.json
README.md:85 ~/.pi ❌ missing not found
README.md:96 ~/.pi ❌ missing not found
README.md:122 ./docs/index.md ✅ valid docs/index.md
README.md:126 ./extension/README.md ✅ valid extension/README.md
README.md:126 .pi/dev-loop/defaults.yaml ✅ valid .pi/dev-loop/defaults.yaml
README.md:126 .pi/dev-loop/settings.yaml ❌ missing not found
README.md:139 ./extension/README.md ✅ valid extension/README.md
README.md:139 .pi/dev-loop/defaults.yaml ✅ valid .pi/dev-loop/defaults.yaml
README.md:152 package.json ✅ valid package.json
README.md:154 ./extension/README.md ✅ valid extension/README.md
README.md:161 @earendil-works/pi-coding-agent ❌ missing not found
README.md:161 @earendil-works/pi-tui ❌ missing not found
README.md:173 ./docs/index.md ✅ valid docs/index.md
README.md:174 ./extension/README.md ✅ valid extension/README.md
README.md:175 ./scripts/README.md ✅ valid scripts/README.md
README.md:176 ./docs/ui-smoke-harness.md ✅ valid docs/ui-smoke-harness.md
README.md:177 ./docs/ui-artifact-contract.md ✅ valid docs/ui-artifact-contract.md
README.md:178 ./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:68 scripts/github/create-draft-pr.mjs ✅ valid scripts/github/create-draft-pr.mjs
scripts/README.md:81 scripts/github/reconcile-draft-gate.mjs ✅ valid scripts/github/reconcile-draft-gate.mjs
scripts/README.md:87 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:117 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:143 scripts/github/resolve-tracker-local-spec.mjs ✅ valid scripts/github/resolve-tracker-local-spec.mjs
scripts/README.md:147 docs/phases/phase-<n>.md ❌ missing not found
scripts/README.md:167 scripts/github/manage-sub-issues.mjs ✅ valid scripts/github/manage-sub-issues.mjs
scripts/README.md:170 ../docs/sub-issue-tree-contract.md ✅ valid docs/sub-issue-tree-contract.md
scripts/README.md:202 scripts/refine/verify.mjs ✅ valid scripts/refine/verify.mjs
scripts/README.md:224 scripts/github/stage-reviewer-draft.mjs ✅ valid scripts/github/stage-reviewer-draft.mjs
scripts/README.md:240 repos/<owner>/<name>/pulls/<pr>/reviews ❌ missing not found
scripts/README.md:250 scripts/github/reply-resolve-review-thread.mjs ✅ valid scripts/github/reply-resolve-review-thread.mjs
scripts/README.md:264 repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies ❌ missing not found
scripts/README.md:274 scripts/github/reply-resolve-review-threads.mjs ✅ valid scripts/github/reply-resolve-review-threads.mjs
scripts/README.md:288 capture-review-threads.mjs ❌ missing not found
scripts/README.md:305 scripts/github/probe-copilot-review.mjs ✅ valid scripts/github/probe-copilot-review.mjs
scripts/README.md:329 scripts/loop/detect-initial-copilot-pr-state.mjs ✅ valid scripts/loop/detect-initial-copilot-pr-state.mjs
scripts/README.md:338 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:345 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:354 app/copilot-swe-agent ❌ missing not found
scripts/README.md:363 scripts/loop/run-conductor-cycle.mjs ✅ valid scripts/loop/run-conductor-cycle.mjs
scripts/README.md:386 run-conductor-cycle.mjs ❌ missing not found
scripts/README.md:390 scripts/loop/conductor-monitor.mjs ✅ valid scripts/loop/conductor-monitor.mjs
scripts/README.md:402 detect-copilot-loop-state.mjs ❌ missing not found
scripts/README.md:408 status.json ❌ missing not found
scripts/README.md:414 run-<n>/session.jsonl ❌ missing not found
scripts/README.md:458 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:481 scripts/loop/copilot-pr-handoff.mjs ✅ valid scripts/loop/copilot-pr-handoff.mjs
scripts/README.md:506 scripts/loop/pr-runner-coordination.mjs ✅ valid scripts/loop/pr-runner-coordination.mjs
scripts/README.md:518 .pi/runner-coordination/<owner>/<repo>/pr-<number>.json ❌ missing not found
scripts/README.md:519 .pi/ ✅ valid .pi
scripts/README.md:522 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:523 detect-checkpoint-evidence.mjs ❌ missing not found
scripts/README.md:525 scripts/loop/run-watch-cycle.mjs ✅ valid scripts/loop/run-watch-cycle.mjs
scripts/README.md:537 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:538 detect-copilot-session-activity.mjs ❌ missing not found
scripts/README.md:540 probe-copilot-review.mjs ❌ missing not found
scripts/README.md:558 scripts/loop/detect-copilot-loop-state.mjs ✅ valid scripts/loop/detect-copilot-loop-state.mjs
scripts/README.md:563 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:570 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:575 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:582 --repo/--pr ❌ missing not found
scripts/README.md:588 request-copilot-review.mjs ❌ missing not found
scripts/README.md:604 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:609 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:629 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs
scripts/README.md:657 detect-pr-gate-coordination-state.mjs ❌ missing not found
scripts/README.md:663 scripts/loop/run-refinement-audit.mjs ✅ valid scripts/loop/run-refinement-audit.mjs
scripts/README.md:692 scripts/loop/detect-pr-gate-coordination-state.mjs ✅ valid scripts/loop/detect-pr-gate-coordination-state.mjs
scripts/README.md:715 scripts/github/detect-checkpoint-evidence.mjs ✅ valid scripts/github/detect-checkpoint-evidence.mjs
scripts/README.md:738 scripts/loop/detect-tracker-pr-state.mjs ✅ valid scripts/loop/detect-tracker-pr-state.mjs
scripts/README.md:771 scripts/loop/detect-reviewer-loop-state.mjs ✅ valid scripts/loop/detect-reviewer-loop-state.mjs
scripts/README.md:776 ../docs/reviewer-loop-state-graph.md ✅ valid docs/reviewer-loop-state-graph.md
scripts/README.md:809 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
scripts/README.md:846 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:859 scripts/loop/inspect-run.mjs ✅ valid scripts/loop/inspect-run.mjs
scripts/README.md:883 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:884 tmp/copilot-loop/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:902 scripts/loop/inspect-run-viewer.mjs ✅ valid scripts/loop/inspect-run-viewer.mjs
scripts/README.md:915 .pi/ui-servers/inspect-run-viewer.json ❌ missing not found
scripts/README.md:940 scripts/loop/_inspect-run-viewer-adapter.mjs ✅ valid scripts/loop/_inspect-run-viewer-adapter.mjs
scripts/README.md:971 test-results/ ❌ missing not found
scripts/README.md:971 playwright-report/ui-smoke/inspect-run-viewer/ ❌ missing not found
scripts/README.md:975 scripts/loop/steer-loop.mjs ✅ valid scripts/loop/steer-loop.mjs
scripts/README.md:985 .pi/steering/<owner>/<repo>/pr-<n>.json ❌ missing not found
scripts/README.md:985 --repo/--pr ❌ missing not found
scripts/README.md:985 .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:33 ../docs/workflow-handoff-contract.md ✅ valid skills/docs/workflow-handoff-contract.md
skills/dev-loop/SKILL.md:35 .pi/dev-loop-retrospective-checkpoint.json ❌ missing not found
skills/dev-loop/SKILL.md:46 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
skills/dev-loop/SKILL.md:49 outer-loop.mjs ❌ missing not found
skills/dev-loop/SKILL.md:56 copilot-pr-handoff.mjs ❌ missing not found
skills/dev-loop/SKILL.md:57 detect-copilot-loop-state.mjs ❌ missing not found
skills/dev-loop/SKILL.md:77 ../local-implementation/SKILL.md ✅ valid skills/local-implementation/SKILL.md
skills/dev-loop/SKILL.md:78 ../copilot-pr-followup/SKILL.md ✅ valid skills/copilot-pr-followup/SKILL.md
skills/dev-loop/SKILL.md:78 ../docs/copilot-loop-operations.md ✅ valid skills/docs/copilot-loop-operations.md
skills/dev-loop/SKILL.md:78 ../docs/issue-intake-procedure.md ✅ valid skills/docs/issue-intake-procedure.md
skills/dev-loop/SKILL.md:79 ../copilot-pr-followup/SKILL.md ✅ valid skills/copilot-pr-followup/SKILL.md
skills/dev-loop/SKILL.md:79 ../docs/copilot-loop-operations.md ✅ valid skills/docs/copilot-loop-operations.md
skills/dev-loop/SKILL.md:83 ../final-approval/SKILL.md ✅ valid skills/final-approval/SKILL.md
skills/dev-loop/SKILL.md:94 @dev-loops/core ❌ missing not found
skills/dev-loop/SKILL.md:94 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs
skills/dev-loop/SKILL.md:94 scripts/post-gate-verdict-fallback.mjs ✅ valid skills/dev-loop/scripts/post-gate-verdict-fallback.mjs
skills/dev-loop/SKILL.md:104 @dev-loops/core ❌ missing not found
skills/dev-loop/SKILL.md:115 ../docs/workflow-handoff-contract.md ✅ valid skills/docs/workflow-handoff-contract.md
skills/dev-loop/SKILL.md:117 workflow-handoff-contract.md ❌ missing not found
skills/dev-loop/SKILL.md:121 run-watch-cycle.mjs ❌ missing not found
skills/dev-loop/SKILL.md:138 ../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: 3
  • 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 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 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 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.
  • 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.
  • 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 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:143 references mfittko/repo-wiki (missing).
  • docs/repo-wiki-manual-first.md:143 references .tmp/repo-wiki/<ref>/source/ (missing).
  • README.md:85 references ~/.pi (missing).
  • README.md:96 references ~/.pi (missing).
  • README.md:126 references .pi/dev-loop/settings.yaml (missing).
  • README.md:161 references @earendil-works/pi-coding-agent (missing).
  • README.md:161 references @earendil-works/pi-tui (missing).
  • scripts/README.md:38 references docs/phases/phase-x.md (missing).
  • scripts/README.md:147 references docs/phases/phase-<n>.md (missing).
  • scripts/README.md:240 references repos/<owner>/<name>/pulls/<pr>/reviews (missing).
  • scripts/README.md:264 references repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies (missing).
  • scripts/README.md:288 references capture-review-threads.mjs (missing).
  • scripts/README.md:354 references app/copilot-swe-agent (missing).
  • scripts/README.md:386 references run-conductor-cycle.mjs (missing).
  • scripts/README.md:402 references detect-copilot-loop-state.mjs (missing).
  • scripts/README.md:408 references status.json (missing).
  • scripts/README.md:414 references run-<n>/session.jsonl (missing).
  • scripts/README.md:518 references .pi/runner-coordination/<owner>/<repo>/pr-<number>.json (missing).
  • scripts/README.md:522 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:523 references detect-checkpoint-evidence.mjs (missing).
  • scripts/README.md:537 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:538 references detect-copilot-session-activity.mjs (missing).
  • scripts/README.md:540 references probe-copilot-review.mjs (missing).
  • scripts/README.md:582 references --repo/--pr (missing).
  • scripts/README.md:588 references request-copilot-review.mjs (missing).
  • scripts/README.md:657 references detect-pr-gate-coordination-state.mjs (missing).
  • scripts/README.md:846 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:883 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:884 references tmp/copilot-loop/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:915 references .pi/ui-servers/inspect-run-viewer.json (missing).
  • scripts/README.md:971 references test-results/ (missing).
  • scripts/README.md:971 references playwright-report/ui-smoke/inspect-run-viewer/ (missing).
  • scripts/README.md:985 references .pi/steering/<owner>/<repo>/pr-<n>.json (missing).
  • scripts/README.md:985 references --repo/--pr (missing).
  • scripts/README.md:985 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:35 references .pi/dev-loop-retrospective-checkpoint.json (missing).
  • skills/dev-loop/SKILL.md:46 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • skills/dev-loop/SKILL.md:49 references outer-loop.mjs (missing).
  • skills/dev-loop/SKILL.md:56 references copilot-pr-handoff.mjs (missing).
  • skills/dev-loop/SKILL.md:57 references detect-copilot-loop-state.mjs (missing).
  • skills/dev-loop/SKILL.md:94 references @dev-loops/core (missing).
  • skills/dev-loop/SKILL.md:104 references @dev-loops/core (missing).
  • skills/dev-loop/SKILL.md:117 references workflow-handoff-contract.md (missing).
  • skills/dev-loop/SKILL.md:121 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: f556ac7
Compiled at: 2026-07-11T13:07:24.115Z
Page kind: sidebar
Page state: generated
Confidence: medium

Navigation

Modules

Cross-cutting

Clone this wiki locally