Docs Health Check — stale files detected 2026-09-13 #1803
Description
Executive Summary
Status: STALE_DOCS_FOUND
Stale files: 14
Key findings:
- Most stale:
petry-projects/TalkTerm/docs/ecc-for-bmad.md(171 days, last updated 2026-03-26) - Cluster:
petry-projects/google-app-scripts/docs/contains 8 stale files all last updated 2026-03-28 (169 days), suggesting a bulk-generated doc set that has never been refreshed - Secondary cluster:
petry-projects/broodly/docs/(architecture, api, adr directories — 168 days)
Action required: Review and either refresh or archive all 14 stale files, prioritizing the google-app-scripts and broodly clusters as they represent the largest surface area.
Stale Files by Repo
petry-projects/TalkTerm (1 file)
| File | Last Updated | Days Stale |
|---|---|---|
docs/ecc-for-bmad.md |
2026-03-26 | 171 |
petry-projects/google-app-scripts (8 files)
| File | Last Updated | Days Stale |
|---|---|---|
docs/source-tree-analysis.md |
2026-03-28 | 169 |
docs/project-scan-report.json |
2026-03-28 | 169 |
docs/project-overview.md |
2026-03-28 | 169 |
docs/index.md |
2026-03-28 | 169 |
docs/development-guide.md |
2026-03-28 | 169 |
docs/deployment-guide.md |
2026-03-28 | 169 |
docs/component-inventory.md |
2026-03-28 | 169 |
docs/architecture.md |
2026-03-28 | 169 |
petry-projects/broodly (3 directories)
| Path | Last Updated | Days Stale |
|---|---|---|
docs/architecture |
2026-03-29 | 168 |
docs/api |
2026-03-29 | 168 |
docs/adr |
2026-03-29 | 168 |
petry-projects/.github-private (2 files)
| File | Last Updated | Days Stale |
|---|---|---|
docs/token-report.md |
2026-06-07 | 98 |
docs/actions-fleet-monitor.md |
2026-06-07 | 98 |
Recommendations
-
google-app-scripts docs cluster — Owner unknown (8 files, 169 days stale). The uniform timestamp and file names (
source-tree-analysis.md,project-scan-report.json,component-inventory.md) indicate these were machine-generated during a one-time scan and never maintained. Suggested action: Archive or remove — redirect users to live source or regenerate on demand via CI. Urgency: MEDIUM -
broodly docs cluster — Owner unknown (3 doc directories — architecture, api, adr — 168 days stale). Core design documentation (ADRs in particular) should reflect current system state. Suggested action: Refresh — assign to the broodly team for a documentation sprint; prioritize the adr directory to validate decisions are still current. Urgency: MEDIUM
-
TalkTerm/docs/ecc-for-bmad.md — Owner unknown (171 days stale). Single file; likely a design or integration note. Suggested action: Refresh or archive depending on whether the ecc/bmad integration is still active. Urgency: MEDIUM
-
.github-private ops docs — Owned by org platform/infra team (2 files, 98 days stale:
token-report.md,actions-fleet-monitor.md). These are operational reports that should be regenerated on a regular schedule. Suggested action: Automate refresh — wire the health-check and token-audit workflows to overwrite these files on each scheduled run. Urgency: LOW
Activity