Audit docs and structure: drop unused patterns tree and stale docs#59
Merged
Conversation
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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
patterns/tree (256 files). Nothing in the codebase,Makefile, CI, or docs referenced it (grepforpatterns/across*.py= 0 matches); the app's prompts and knowledge base live underprompts/<user>/viawhisperforge_core/prompts.pyand are untouched.STATUS.md/ROADMAP.md/NEXT-ROUND-PLANset: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")ROADMAP.md,STATUS.md,docs/LINEAR-GITHUB-PIPELINE.md,.company-os/project.yaml, andops/roadmap/features.jsonto the living docs.changelog.md(new[Unreleased] - 2026-07-01) andSTATUS.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→ validpython3 -m compileall app.py whisperforge.py whisperforge_core ui services scripts tests→ cleanmake lint/make test/make smoke— not run here: they require the ignored localvenv/which does not exist in this fresh container (same known-weirdness noted inSTATUS.md). No Python was changed.Docs Impact
make docs-checkpasses when docs or command surfaces changedAgentic Delivery
Closes #...only when every acceptance criterion is met — no tracked issue for this cleanuppatterns/removal. The owner explicitly approved both thepatterns/deletion and trimming the superseded docs before any files were touched.🤖 Generated with Claude Code
Generated by Claude Code