Skip to content

Audit docs and structure: drop unused patterns tree and stale docs#59

Merged
WalksWithASwagger merged 2 commits into
mainfrom
claude/docs-project-audit-tn76u2
Jul 1, 2026
Merged

Audit docs and structure: drop unused patterns tree and stale docs#59
WalksWithASwagger merged 2 commits into
mainfrom
claude/docs-project-audit-tn76u2

Conversation

@WalksWithASwagger

Copy link
Copy Markdown
Owner

Summary

  • Documentation and directory-structure cleanup. No product code, API, schema, runtime default, or user-facing behavior changed.
  • Removed the vendored Fabric patterns/ tree (256 files). Nothing in the codebase, Makefile, CI, or docs referenced it (grep for patterns/ across *.py = 0 matches); the app's prompts and knowledge base live under prompts/<user>/ via whisperforge_core/prompts.py and are untouched.
  • Retired four superseded historical docs that already redirected readers to the living STATUS.md / ROADMAP.md / NEXT-ROUND-PLAN set:
    • docs/DOCUMENTATION-AUDIT-2026-05-17.md ("kept as evidence... not the current handoff")
    • docs/AUDIO-REPO-CONSOLIDATION-AUDIT-2026-05-18.md (decision already executed)
    • docs/WHISPERFORGE-AUDIT-AND-ROADMAP-2026-05-18.md (self-labeled historical snapshot)
    • docs/WHISPERFORGE-MASTER-PLAN-2026-05-18.md ("the implementation wave... has shipped")
  • Rewired every inbound link to the retired docs in ROADMAP.md, STATUS.md, docs/LINEAR-GITHUB-PIPELINE.md, .company-os/project.yaml, and ops/roadmap/features.json to the living docs.
  • Logged the cleanup in changelog.md (new [Unreleased] - 2026-07-01) and STATUS.md (new dated audit section). Bumped freshness dates on the docs I touched.

The rest of the repo audited clean: no stray files, no __pycache__, no empty dirs, well-separated code layout. prompts/ profiles, changelog.md, WHISPERFORGE.md, services, and scripts are all in use and were left intact.

Verification

  • python3 scripts/docs_truth_check.py --root .OK (14 docs, 15 make targets)
  • python3 -m json.tool ops/roadmap/features.json → valid
  • python3 -m compileall app.py whisperforge.py whisperforge_core ui services scripts tests → clean
  • make lint / make test / make smoke — not run here: they require the ignored local venv/ which does not exist in this fresh container (same known-weirdness noted in STATUS.md). No Python was changed.

Docs Impact

  • Commands, paths, and env vars in docs still match the code
  • Status, roadmap, and tracker claims were refreshed or left untouched
  • make docs-check passes when docs or command surfaces changed

Agentic Delivery

  • Linked with Closes #... only when every acceptance criterion is met — no tracked issue for this cleanup
  • Acceptance self-check included when opened by an agent — see Verification
  • Diff is within 20 files / 500 changed lines, or human approval is documented — diff is 260 files / ~15.3k deletions, dominated by the 256-file patterns/ removal. The owner explicitly approved both the patterns/ deletion and trimming the superseded docs before any files were touched.

🤖 Generated with Claude Code


Generated by Claude Code

claude added 2 commits July 1, 2026 01:56
Documentation and directory-structure cleanup only. No product code, API,
schema, runtime default, or user-facing behavior changed.

- Remove the vendored Fabric `patterns/` tree (256 files). No code, Makefile,
  CI job, or doc referenced it; app prompts live under `prompts/<user>/` via
  `whisperforge_core/prompts.py`.
- Retire four superseded historical docs that already redirected readers to the
  living STATUS/ROADMAP/NEXT-ROUND set: the 2026-05-17 documentation audit, the
  audio-repo consolidation audit, the audit-and-roadmap snapshot, and the
  2026-05-18 master plan. git history and changelog.md preserve the record.
- Rewire inbound links in ROADMAP.md, STATUS.md, docs/LINEAR-GITHUB-PIPELINE.md,
  .company-os/project.yaml, and ops/roadmap/features.json to the living docs.
- Log the cleanup in changelog.md and STATUS.md.

Gates: docs-truth check passes (14 docs), features.json valid, compileall clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Xr9K4AYuucvrYrjRHWgka7
- Add docs/WEEK-PLAN-2026-07-01.md: short-horizon sequencing for the rest of the
  week (land PR #59, run fresh dogfood evidence, scope one next lane) with the
  standing dry-run/approval guardrails.
- STATUS.md: record that the docs/structure audit shipped as PR #59 with all
  checks green and awaiting merge; link the week plan from Active Handles.
- changelog.md: log the week plan under Unreleased.

Docs-only. make docs-check passes (15 docs).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Xr9K4AYuucvrYrjRHWgka7
@WalksWithASwagger WalksWithASwagger marked this pull request as ready for review July 1, 2026 04:15
@WalksWithASwagger WalksWithASwagger merged commit 8dfca3e into main Jul 1, 2026
3 checks passed
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