Skip to content

docs: routine doc-drift sweep — src/ paths, layout, CHANGELOG, DFIR_MEMORY index#74

Draft
TimothyVang wants to merge 10 commits into
mainfrom
chore/auto-doc-sync-fresh
Draft

docs: routine doc-drift sweep — src/ paths, layout, CHANGELOG, DFIR_MEMORY index#74
TimothyVang wants to merge 10 commits into
mainfrom
chore/auto-doc-sync-fresh

Conversation

@TimothyVang

Copy link
Copy Markdown
Owner

Routine verdict-doc-drift sweep

Sweep timestamp: 2026-05-10T00:00:00Z

Drift items fixed

# File Category Fix
1 CLAUDE.md §3.1 Stale file path verdict/runtime/evidence_recheck.pysrc/verdict/runtime/evidence_recheck.py
2 CLAUDE.md §3.3 Stale file path verdict/schemas/caveat_id.py and verdict/prompts/examiner_caveats.mdsrc/verdict/ prefix
3 CLAUDE.md §3.4 Stale file path verdict/ledger/redaction.pysrc/verdict/ledger/redaction.py
4 CLAUDE.md §6 Stale archive count spec archive label 01..0501..04 (only four files exist)
5 CLAUDE.md §6 Stale layout description Remove "today the workspace holds docs only"; replace placeholder target tree with current src/verdict/ layout
6 CLAUDE.md §7 Stale file paths verdict/playbooks/, verdict/knowledge/, verdict/prompts/src/verdict/ prefix
7 CLAUDE.md §8 Stale file path verdict/verification/strategy.pysrc/verdict/verification/strategy.py
8 CLAUDE.md §9 Stale file path + non-existent file verdict/ledger/writer.py + chain.pysrc/verdict/ledger/writer.py (chain.py does not exist)
9 CLAUDE.md §10.1 Stale command docker-compose up -ddocker-compose -f infra/langfuse/docker-compose.yml up -d
10 CLAUDE.md §10.3 Non-existent path in command uv run --directory services/agent pytestuv run pytest (services/agent/ does not exist)
11 CONTRIBUTING.md Stale file paths verdict/sandboxes/, verdict/tools/vol3/, services/mcp/src/tools/, services/agent_mcp/src/verdict/ equivalents
12 CONTRIBUTING.md Stale docs-sweep reminder verdict/src/verdict/ in docs-follow-research reminder box
13 CONTRIBUTING.md Stale file path verdict/prompts/examiner_caveats.mdsrc/verdict/planning/prompts/examiner_caveats.md in docs table
14 docs/ARCHITECTURE.md Stale file paths verdict/planning/prompts/examiner_caveats.md, verdict/playbooks/, verdict/knowledge/hunt_evil.yml, verdict/tools/sanitization.pysrc/verdict/ prefix; remove stale "planned" qualifier
15 docs/BUILD_PLAN.md Stale authority table Remove non-existent services/mcp/src/tools/ and services/agent_mcp/ rows; replace with src/verdict/tools/
16 docs/BUILD_PLAN.md Stale acceptance-gate commands grep ... verdict/planning/prompts/examiner_caveats.md and open('verdict/knowledge/hunt_evil.yml')src/verdict/ prefix
17 docs/README.md Missing index entry Add DFIR_MEMORY.md to wiki index (file exists in docs/ but had no row in the index table)

Items skipped (capped at 20)

No items were skipped; all 17 confirmed drift items were addressed. Forward-looking statements (BUILD_PLAN.md task specs, target layouts, scripts/inference-smoke.py, tests/chaos/), code comments, and the frozen docs/spec/ archive were not modified.


Generated by routine verdict-doc-drift. Manage at https://claude.ai/code/routines


Generated by Claude Code

claude added 10 commits May 10, 2026 06:22
Replace bare `verdict/` path prefixes with `src/verdict/` to match the
actual package layout under src/. Drop the non-existent `chain.py`
reference from §9. Correct spec archive label from 01..05 to 01..04
(only four numbered audit files exist). Fix §10.3 to drop the
`--directory services/agent` flag (services/ directory does not exist).
…[W1.A.0]

Update all bare `verdict/sandboxes/`, `verdict/tools/vol3/`,
`services/mcp/src/tools/`, and `services/agent_mcp/` references to the
actual source tree paths under `src/verdict/`. Also fix the
examiner_caveats.md path in the docs-follow-research table.
Update path references in ARCHITECTURE.md from bare `verdict/` to
`src/verdict/` to match the actual package layout. Also remove the
stale "planned" qualifier from the examiner_caveats.md cross-reference
(file now exists).
… commands [W1.A.0]

Remove non-existent `services/mcp/src/tools/` and `services/agent_mcp/`
rows from the authority table; replace with `src/verdict/tools/`. Update
the two acceptance-gate shell commands to use the actual `src/verdict/`
prefix so they resolve correctly. Drop stale "planned" qualifiers from
the examiner_caveats.md and playbooks/*.yml references.
… structure [W1.A.0]

Remove the stale "docs only" claim and the placeholder target tree that
used a bare `verdict/` prefix. Replace with the current directory
structure that reflects W1+ code now living under `src/verdict/`,
`tests/`, `inspect_ai/`, `infra/`, and `swarm/`.
DFIR_MEMORY.md exists in docs/ but was missing from the index table in
docs/README.md. Add it to the "Current authority" section so it is
reachable from the front door.
The docker-compose.yml lives at infra/langfuse/docker-compose.yml,
not at the repo root. Update the §10.1 install command accordingly.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants