| 1 | # Cleanup Candidates (Archived 2026-06-13) |
| 2 | |
| 3 | > **Status:** All actionable items resolved. Archived to `docs/processed/`. |
| 4 | > Scripts archived via PR #461; legacy data files removed; branding updated via PR #450/#374; `budget_alerts.py` wired into CI via PR #455; rollout-checklist corrected. |
| 5 | |
| 6 | This was a conservative cleanup pass focused on `scripts/`, `docs/`, `data/`, and tracked root-level files. |
| 7 | |
| 8 | ## Findings |
| 9 | |
| 10 | | Path | Reason | Recommendation | |
| 11 | | --- | --- | --- | |
| 12 | | `scripts/calibrate_hype_risk.py` | No workflow, doc, test, or script references were found. It appears to be an unwired experiment rather than an active pipeline component. | **Archive or delete** unless there is a near-term plan to wire it into the learning loop. | |
| 13 | | `scripts/momentum_tracker.py` | No workflow or docs references were found, and it does not appear to be called by the weekly pipeline. It looks like a standalone learning-loop utility that never got integrated. | **Archive or document/wire up**; if the momentum loop is deferred, move it out of the active script surface. | |
| 14 | | `scripts/budget_alerts.py` | Only test coverage references were found; no workflow or operator documentation calls it. Current cost tracking appears to stop at ledger generation. | **Wire into CI or archive** to reduce dormant maintenance surface. | |
| 15 | | `scripts/hindsight_validation.py` | Only test references were found; no workflow or docs integration was found for scheduled hindsight validation. | **Archive or add an owning workflow/doc** if hindsight validation is still part of the roadmap. | |
| 16 | | `scripts/init_topic_learning.py` | Only test references were found, with no workflow or operator-guide usage. Topic learning state currently looks pre-seeded in-repo rather than initialized through this command. | **Archive or document** as a manual bootstrap tool. | |
| 17 | | `data/raw/2026-W21-techcrunch.json` | Legacy raw artifact format. The current pipeline writes `YYYY-WNN-external-news.json` and only keeps `*-techcrunch.json` as a compatibility fallback. | **Archive or delete** once the legacy fallback is removed. | |
| 18 | | `data/raw/2026-W22-techcrunch.json` | Same issue as above: legacy TechCrunch-only artifact retained after the canonical external-news merge format was introduced. | **Archive or delete** once fallback support is no longer needed. | |
| 19 | | `docs/rollout-checklist.md` | The optional verification section still says a Copilot outage should fall back to GitHub Models, but the current repo explicitly documents that there is **no** GitHub Models/OpenAI fallback for weekly analysis. | **Update** to match the current fail-closed Copilot-only pipeline. | |
| 20 | | `docs/processed/qa-report.md` | This report says the deploy workflow does not build Pagefind and that reskill is still a placeholder. Both statements are stale relative to the current workflow. | **Archive or mark obsolete** so readers do not treat it as current operational truth. | |
| 21 | | `docs/processed/learning-audit.md` | The audit says there is no reskill job, no `.squad/skills/` directory, and no run-counter support. Those claims no longer match the repository shape or workflow wiring. | **Archive or add a superseded banner**. | |
| 22 | | `docs/processed/PRD-techcrunch-integration-2026-05-cross-source-correlation.md` | This PRD still describes `data/raw/YYYY-WNN-techcrunch.json` as the new primary artifact, but the implemented pipeline now uses `YYYY-WNN-external-news.json`. | **Archive or annotate as superseded** by the merged external-news design. | |
| 23 | | `docs/growth/distribution-strategy.md` | The document still points to `https://jmservera.github.io/SquadScope/` and related RSS URLs instead of the current Claracle domain. | **Update** branding and canonical URLs to `https://www.claracle.com/`. | |
| 24 | | `README.md` | The root README still advertises the old GitHub Pages URLs rather than the public Claracle domain. | **Update** to align external-facing docs with the live brand/domain. | |
| 25 | |
| 26 | ## Notes |
| 27 | |
| 28 | - **Unused config files:** none clearly identified. `config/podcast.json` and `config/external_news_sources.json` are both referenced by workflows/scripts. |
| 29 | - **Empty or stub files:** no actionable tracked candidates found in the requested areas. `.gitkeep` placeholders and `scripts/__init__.py` appear intentional. |