Skip to content

Documentation Debt Report

Jump to bottom
repo-wiki-bot edited this page Jul 10, 2026 · 285 revisions

Generated from: https://github.com/mfittko/dev-loops
Source commit: 85c0eec
Compiled at: 2026-07-10T22:49:20.031Z
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: 58
  • Stale documents: 2
  • Commands found in docs: 34
  • Environment variable mentions: 35
  • 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 4
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 5 14 5
scripts/README.md stale secondary 0 15 0 4
skills/dev-loop/SKILL.md partially_validated secondary 0 6 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
npx dev-loops@<version> gates # print what reviewers will check ❓ 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 -it --rm -e GH_TOKEN=[REDACTED] -v "$HOME/.pi:/home/node/.pi" dev-loops pi ❓ unvalidated unknown
docker run -it --rm -e GH_TOKEN=[REDACTED] -e OPENAI_API_KEY=[REDACTED] dev-loops pi ❓ 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
docker run -it --rm -e GH_TOKEN=[REDACTED] -v "$HOME/.pi:/home/node/.pi" -v /tmp/run:/workspace dev-loops pi ❓ 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: 134
  • Missing: 80
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:18 conductor-ownership.mjs ❌ missing not found
docs/conductor-routing-contract.md:19 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/conductor-routing-contract.md:19 copilot-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:19 reviewer-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:31 conductor-ownership.mjs ❌ missing not found
docs/conductor-routing-contract.md:32 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/conductor-routing-contract.md:43 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/conductor-routing-contract.md:49 projects-queue-contract.md ✅ valid docs/projects-queue-contract.md
docs/conductor-routing-contract.md:55 packages/core/src/loop/conductor-routing.mjs ✅ valid packages/core/src/loop/conductor-routing.mjs
docs/conductor-routing-contract.md:56 packages/core/test/conductor-routing.test.mjs ✅ valid packages/core/test/conductor-routing.test.mjs
docs/conductor-routing-contract.md:57 test/loop/conductor-routing.test.mjs ✅ valid test/loop/conductor-routing.test.mjs
docs/conductor-routing-contract.md:58 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
docs/conductor-routing-contract.md:71 copilot-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:72 reviewer-loop-state.mjs ❌ missing not found
docs/conductor-routing-contract.md:97 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:118 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:140 conductor-routing.mjs ❌ missing not found
docs/conductor-routing-contract.md:172 scripts/loop/copilot-pr-handoff.mjs ✅ valid scripts/loop/copilot-pr-handoff.mjs
docs/conductor-routing-contract.md:174 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
docs/conductor-routing-contract.md:302 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:331 outer-loop.mjs ❌ missing not found
docs/conductor-routing-contract.md:332 ../skills/docs/pr-lifecycle-contract.md ✅ valid skills/docs/pr-lifecycle-contract.md
docs/IMPLEMENTATION_WORKFLOW.md:15 ../skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
docs/IMPLEMENTATION_WORKFLOW.md:30 ../PLAN.md ✅ valid PLAN.md
docs/IMPLEMENTATION_WORKFLOW.md:34 ../PLAN.md ✅ valid PLAN.md
docs/IMPLEMENTATION_WORKFLOW.md:36 ./IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
docs/IMPLEMENTATION_WORKFLOW.md:43 docs/phases/phase-<n>.md ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:54 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:60 owner/name ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:61 scripts/github/resolve-tracker-local-spec.mjs ✅ valid scripts/github/resolve-tracker-local-spec.mjs
docs/IMPLEMENTATION_WORKFLOW.md:64 docs/phases/phase-<n>.md ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:66 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:83 ../scripts/README.md ✅ valid scripts/README.md
docs/IMPLEMENTATION_WORKFLOW.md:84 docs/ ✅ valid docs
docs/IMPLEMENTATION_WORKFLOW.md:94 ../README.md ✅ valid README.md
docs/IMPLEMENTATION_WORKFLOW.md:95 ../PLAN.md ✅ valid PLAN.md
docs/IMPLEMENTATION_WORKFLOW.md:96 IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
docs/IMPLEMENTATION_WORKFLOW.md:97 ./IMPLEMENTATION_WORKFLOW.md ✅ valid docs/IMPLEMENTATION_WORKFLOW.md
docs/IMPLEMENTATION_WORKFLOW.md:98 docs/ ✅ valid docs
docs/IMPLEMENTATION_WORKFLOW.md:99 ../scripts/README.md ✅ valid scripts/README.md
docs/IMPLEMENTATION_WORKFLOW.md:101 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:110 tmp/ ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:129 ../AGENTS.md ✅ valid AGENTS.md
docs/IMPLEMENTATION_WORKFLOW.md:130 IMPLEMENTATION_STATE.md ✅ valid docs/IMPLEMENTATION_STATE.md
docs/IMPLEMENTATION_WORKFLOW.md:131 IMPLEMENTATION_WORKFLOW.md ✅ valid docs/IMPLEMENTATION_WORKFLOW.md
docs/IMPLEMENTATION_WORKFLOW.md:132 docs/phases/phase-<n>.md ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:133 tmp/phases/index.json ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:134 tmp/phases/phase-<n>/... ❌ missing not found
docs/IMPLEMENTATION_WORKFLOW.md:141 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:5 packages/core ✅ valid packages/core
README.md:9 packages/core/src/loop/lifecycle-state.mjs ✅ valid packages/core/src/loop/lifecycle-state.mjs
README.md:21 ./skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
README.md:33 ./skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
README.md:61 ./docs/ui-review-recipe-contract.md ✅ valid docs/ui-review-recipe-contract.md
README.md:69 .claude/ ✅ valid .claude
README.md:69 .claude/.claude-plugin/plugin.json ✅ valid .claude/.claude-plugin/plugin.json
README.md:84 PLAN.md ✅ valid PLAN.md
README.md:84 AGENTS.md ✅ valid AGENTS.md
README.md:122 @earendil-works/pi-coding-agent ❌ missing not found
README.md:122 @earendil-works/pi-tui ❌ missing not found
README.md:126 packages/core/src/config/extension-defaults.yaml ✅ valid packages/core/src/config/extension-defaults.yaml
README.md:126 .devloops.yaml ❌ missing not found
README.md:140 packages/core/src/config/extension-defaults.yaml ✅ valid packages/core/src/config/extension-defaults.yaml
README.md:140 packages/core/src/config/config.mjs ✅ valid packages/core/src/config/config.mjs
README.md:170 package-lock.json ✅ valid package-lock.json
README.md:197 ./docs/migrating-to-dev-loops.md ✅ valid docs/migrating-to-dev-loops.md
README.md:201 ./docs/index.md ✅ valid docs/index.md
README.md:202 ./docs/readme-audit-rubric.md ✅ valid docs/readme-audit-rubric.md
README.md:203 ./skills/docs/public-dev-loop-contract.md ✅ valid skills/docs/public-dev-loop-contract.md
README.md:204 ./extension/README.md ✅ valid extension/README.md
README.md:205 ./scripts/README.md ✅ valid scripts/README.md
README.md:206 ./docs/ui-smoke-harness.md ✅ valid docs/ui-smoke-harness.md
README.md:207 ./docs/ui-artifact-contract.md ✅ valid docs/ui-artifact-contract.md
README.md:208 ./docs/ui-designer-review-loop.md ✅ valid docs/ui-designer-review-loop.md
README.md:209 ./docs/ui-review-recipe-contract.md ✅ valid docs/ui-review-recipe-contract.md
README.md:210 ./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:122 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:148 scripts/github/resolve-tracker-local-spec.mjs ✅ valid scripts/github/resolve-tracker-local-spec.mjs
scripts/README.md:152 docs/phases/phase-<n>.md ❌ missing not found
scripts/README.md:172 scripts/github/manage-sub-issues.mjs ✅ valid scripts/github/manage-sub-issues.mjs
scripts/README.md:175 ../docs/sub-issue-tree-contract.md ✅ valid docs/sub-issue-tree-contract.md
scripts/README.md:207 scripts/refine/verify.mjs ✅ valid scripts/refine/verify.mjs
scripts/README.md:229 scripts/github/stage-reviewer-draft.mjs ✅ valid scripts/github/stage-reviewer-draft.mjs
scripts/README.md:245 repos/<owner>/<name>/pulls/<pr>/reviews ❌ missing not found
scripts/README.md:255 scripts/github/reply-resolve-review-thread.mjs ✅ valid scripts/github/reply-resolve-review-thread.mjs
scripts/README.md:269 repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies ❌ missing not found
scripts/README.md:279 scripts/github/reply-resolve-review-threads.mjs ✅ valid scripts/github/reply-resolve-review-threads.mjs
scripts/README.md:293 capture-review-threads.mjs ❌ missing not found
scripts/README.md:310 scripts/github/probe-copilot-review.mjs ✅ valid scripts/github/probe-copilot-review.mjs
scripts/README.md:334 scripts/loop/detect-initial-copilot-pr-state.mjs ✅ valid scripts/loop/detect-initial-copilot-pr-state.mjs
scripts/README.md:343 scripts/github/detect-linked-issue-pr.mjs ✅ valid scripts/github/detect-linked-issue-pr.mjs
scripts/README.md:350 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:359 app/copilot-swe-agent ❌ missing not found
scripts/README.md:368 scripts/loop/run-conductor-cycle.mjs ✅ valid scripts/loop/run-conductor-cycle.mjs
scripts/README.md:391 run-conductor-cycle.mjs ❌ missing not found
scripts/README.md:395 scripts/loop/conductor-monitor.mjs ✅ valid scripts/loop/conductor-monitor.mjs
scripts/README.md:407 detect-copilot-loop-state.mjs ❌ missing not found
scripts/README.md:413 status.json ❌ missing not found
scripts/README.md:419 run-<n>/session.jsonl ❌ missing not found
scripts/README.md:463 scripts/loop/detect-copilot-session-activity.mjs ✅ valid scripts/loop/detect-copilot-session-activity.mjs
scripts/README.md:486 scripts/loop/copilot-pr-handoff.mjs ✅ valid scripts/loop/copilot-pr-handoff.mjs
scripts/README.md:511 scripts/loop/pr-runner-coordination.mjs ✅ valid scripts/loop/pr-runner-coordination.mjs
scripts/README.md:523 .pi/runner-coordination/<owner>/<repo>/pr-<number>.json ❌ missing not found
scripts/README.md:524 .pi/ ✅ valid .pi
scripts/README.md:527 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:528 detect-checkpoint-evidence.mjs ❌ missing not found
scripts/README.md:530 scripts/loop/run-watch-cycle.mjs ✅ valid scripts/loop/run-watch-cycle.mjs
scripts/README.md:542 copilot-pr-handoff.mjs ❌ missing not found
scripts/README.md:543 detect-copilot-session-activity.mjs ❌ missing not found
scripts/README.md:545 probe-copilot-review.mjs ❌ missing not found
scripts/README.md:563 scripts/loop/detect-copilot-loop-state.mjs ✅ valid scripts/loop/detect-copilot-loop-state.mjs
scripts/README.md:568 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:575 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:580 scripts/github/request-copilot-review.mjs ✅ valid scripts/github/request-copilot-review.mjs
scripts/README.md:587 --repo/--pr ❌ missing not found
scripts/README.md:593 request-copilot-review.mjs ❌ missing not found
scripts/README.md:609 ../skills/docs/copilot-ci-status-contract.md ✅ valid skills/docs/copilot-ci-status-contract.md
scripts/README.md:614 ../docs/copilot-loop-state-graph.md ✅ valid docs/copilot-loop-state-graph.md
scripts/README.md:634 scripts/github/upsert-checkpoint-verdict.mjs ✅ valid scripts/github/upsert-checkpoint-verdict.mjs
scripts/README.md:662 detect-pr-gate-coordination-state.mjs ❌ missing not found
scripts/README.md:668 scripts/loop/run-refinement-audit.mjs ✅ valid scripts/loop/run-refinement-audit.mjs
scripts/README.md:697 scripts/loop/detect-pr-gate-coordination-state.mjs ✅ valid scripts/loop/detect-pr-gate-coordination-state.mjs
scripts/README.md:720 scripts/github/detect-checkpoint-evidence.mjs ✅ valid scripts/github/detect-checkpoint-evidence.mjs
scripts/README.md:743 scripts/loop/detect-tracker-pr-state.mjs ✅ valid scripts/loop/detect-tracker-pr-state.mjs
scripts/README.md:776 scripts/loop/detect-reviewer-loop-state.mjs ✅ valid scripts/loop/detect-reviewer-loop-state.mjs
scripts/README.md:781 ../docs/reviewer-loop-state-graph.md ✅ valid docs/reviewer-loop-state-graph.md
scripts/README.md:814 scripts/loop/outer-loop.mjs ✅ valid scripts/loop/outer-loop.mjs
scripts/README.md:851 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:864 scripts/loop/inspect-run.mjs ✅ valid scripts/loop/inspect-run.mjs
scripts/README.md:888 tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:889 tmp/copilot-loop/pr-<n>/outer-loop-state.json ❌ missing not found
scripts/README.md:907 scripts/loop/inspect-run-viewer.mjs ✅ valid scripts/loop/inspect-run-viewer.mjs
scripts/README.md:920 .pi/ui-servers/inspect-run-viewer.json ❌ missing not found
scripts/README.md:945 scripts/loop/_inspect-run-viewer-adapter.mjs ✅ valid scripts/loop/_inspect-run-viewer-adapter.mjs
scripts/README.md:976 test-results/ ❌ missing not found
scripts/README.md:976 playwright-report/ui-smoke/inspect-run-viewer/ ❌ missing not found
scripts/README.md:980 scripts/loop/steer-loop.mjs ✅ valid scripts/loop/steer-loop.mjs
scripts/README.md:990 .pi/steering/<owner>/<repo>/pr-<n>.json ❌ missing not found
scripts/README.md:990 --repo/--pr ❌ missing not found
scripts/README.md:990 .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
skills/dev-loop/SKILL.md:109 scripts/post-gate-verdict-fallback.mjs ✅ valid skills/dev-loop/scripts/post-gate-verdict-fallback.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: 30
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/conductor-routing-contract.md OUTER_STATE ❓ unvalidated
docs/conductor-routing-contract.md OUTER_TRANSITIONS ❓ 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: 1
Claim location Route claim Status Evidence / reason
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.
  • npx dev-loops@<version> gates # print what reviewers will check - 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 -it --rm -e GH_TOKEN=[REDACTED] -v "$HOME/.pi:/home/node/.pi" dev-loops pi - command source unknown.
  • docker run -it --rm -e GH_TOKEN=[REDACTED] -e OPENAI_API_KEY=[REDACTED] dev-loops pi - 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.
  • docker run -it --rm -e GH_TOKEN=[REDACTED] -v "$HOME/.pi:/home/node/.pi" -v /tmp/run:/workspace dev-loops pi - 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/conductor-routing-contract.md mentions OUTER_STATE without scanner/config validation.
  • docs/conductor-routing-contract.md mentions OUTER_TRANSITIONS 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.
  • 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:18 references conductor-ownership.mjs (missing).
  • docs/conductor-routing-contract.md:19 references copilot-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:19 references reviewer-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:31 references conductor-ownership.mjs (missing).
  • docs/conductor-routing-contract.md:71 references copilot-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:72 references reviewer-loop-state.mjs (missing).
  • docs/conductor-routing-contract.md:97 references outer-loop.mjs (missing).
  • docs/conductor-routing-contract.md:118 references outer-loop.mjs (missing).
  • docs/conductor-routing-contract.md:140 references conductor-routing.mjs (missing).
  • docs/conductor-routing-contract.md:302 references outer-loop.mjs (missing).
  • docs/conductor-routing-contract.md:331 references outer-loop.mjs (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:43 references docs/phases/phase-<n>.md (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:54 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:60 references owner/name (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:64 references docs/phases/phase-<n>.md (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:66 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:101 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:110 references tmp/ (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:132 references docs/phases/phase-<n>.md (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:133 references tmp/phases/index.json (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:134 references tmp/phases/phase-<n>/... (missing).
  • docs/IMPLEMENTATION_WORKFLOW.md:141 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:122 references @earendil-works/pi-coding-agent (missing).
  • README.md:122 references @earendil-works/pi-tui (missing).
  • README.md:126 references .devloops.yaml (missing).
  • scripts/README.md:38 references docs/phases/phase-x.md (missing).
  • scripts/README.md:152 references docs/phases/phase-<n>.md (missing).
  • scripts/README.md:245 references repos/<owner>/<name>/pulls/<pr>/reviews (missing).
  • scripts/README.md:269 references repos/<owner>/<name>/pulls/<pr>/comments/<comment-id>/replies (missing).
  • scripts/README.md:293 references capture-review-threads.mjs (missing).
  • scripts/README.md:359 references app/copilot-swe-agent (missing).
  • scripts/README.md:391 references run-conductor-cycle.mjs (missing).
  • scripts/README.md:407 references detect-copilot-loop-state.mjs (missing).
  • scripts/README.md:413 references status.json (missing).
  • scripts/README.md:419 references run-<n>/session.jsonl (missing).
  • scripts/README.md:523 references .pi/runner-coordination/<owner>/<repo>/pr-<number>.json (missing).
  • scripts/README.md:527 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:528 references detect-checkpoint-evidence.mjs (missing).
  • scripts/README.md:542 references copilot-pr-handoff.mjs (missing).
  • scripts/README.md:543 references detect-copilot-session-activity.mjs (missing).
  • scripts/README.md:545 references probe-copilot-review.mjs (missing).
  • scripts/README.md:587 references --repo/--pr (missing).
  • scripts/README.md:593 references request-copilot-review.mjs (missing).
  • scripts/README.md:662 references detect-pr-gate-coordination-state.mjs (missing).
  • scripts/README.md:851 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:888 references tmp/copilot-loop/<owner>/<repo>/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:889 references tmp/copilot-loop/pr-<n>/outer-loop-state.json (missing).
  • scripts/README.md:920 references .pi/ui-servers/inspect-run-viewer.json (missing).
  • scripts/README.md:976 references test-results/ (missing).
  • scripts/README.md:976 references playwright-report/ui-smoke/inspect-run-viewer/ (missing).
  • scripts/README.md:990 references .pi/steering/<owner>/<repo>/pr-<n>.json (missing).
  • scripts/README.md:990 references --repo/--pr (missing).
  • scripts/README.md:990 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:133 references request-copilot-review.mjs (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).
  • skills/dev-loop/SKILL.md:166 references add-queue-item.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: 85c0eec
Compiled at: 2026-07-10T22:49:20.010Z
Page kind: sidebar
Page state: generated
Confidence: medium

Navigation

Modules

Cross-cutting

Clone this wiki locally