docs: doc-claim drift detected on 2026-08-24

[NickCrew]

Summary

Automated doc-drift audit across 12 doc files found 13 confirmed drift findings in 8 files.

• 9 P1 (dev-doc errors — wrong commands, wrong defaults, missing files)
• 4 P2 (minor staleness — undocumented module, internal count inconsistencies)

Backlog task created: backlog/tasks/task-18 - Doc-drift-detected-2026-08-24.md

Findings at a glance

Severity	File	Claim	Issue
P1	docs/architecture.md:165	DEMO_MODE | true	Default is 'full' per app/config.py:31, not true
P1	docs/developer-guide.md:47	DEMO_MODE | strict	Default is 'full', not strict
P1	docs/developer-guide.md:243-246	make -C apps/vuln-api test-*	No Makefile; recipes are just -f apps/vuln-api/justfile <recipe>
P1	README.md:48	DEMO_MODE | strict	Default is 'full', not strict
P1	docs/endpoints-catalog.md:15	just docs-drift	Recipe does not exist; nearest is docs-check
P1	apps/vuln-api/AGENTS.md:116	nginx handles production proxy	No nginx in any Dockerfile; uvicorn serves directly
P1	apps/vuln-api/tests/README.md:66-76	tests/vulnerability/, pytest.ini, run_tests.sh, justfile	None of these paths exist
P1	apps/vuln-api/tests/README.md:234-235	auth_headers, sample_data, mock_services fixtures	Not defined in tests/conftest.py
P1	apps/vuln-api/tests/README.md:211-213	Coverage minimum 90%/95%/100%	Actual gate is --cov-fail-under=80
P1	docs/vulnerability-inventory.md:46	"reconciled under TASK-17"	TASK-17 does not exist in backlog
P2	apps/vuln-api/AGENTS.md:127	make test-coverage	Should be just test-coverage
P2	apps/vuln-api/API-DOCUMENTATION.md:17 vs :1015	"469" vs "450+" endpoints	Internally inconsistent within same file
P2	docs/architecture.md blueprint table	Missing education domain	app/blueprints/education/ exists but is not listed
P2	Cross-file	Endpoint count "456+" vs "469"	Inconsistent across 8 doc files

---

Generated by Claude Code