Skip to content

docs: clean up stale project-scaffolding refs in .agent/rules#132

Merged
manager-identity[bot] merged 1 commit into
mainfrom
chore/clean-stale-scaffolding-refs
May 13, 2026
Merged

docs: clean up stale project-scaffolding refs in .agent/rules#132
manager-identity[bot] merged 1 commit into
mainfrom
chore/clean-stale-scaffolding-refs

Conversation

@manager-identity
Copy link
Copy Markdown
Contributor

Summary

  • 8 files in .agent/rules/ were pointing at scaffolding paths that no longer exist after #6060 made project-tracker self-contained for graph scanning. Fixed in place:
    • Broken project-scaffolding/Documents/*.md links: removed (no local replacement) OR repointed to local successor where one exists (CODE_QUALITY_STANDARDS.md).
    • EXTERNAL_RESOURCES.md.yaml (9 occurrences, file was renamed upstream).
    • REVIEWS_AND_GOVERNANCE_PROTOCOL.md "DO NOT EDIT — synced from agentsync/sync_governance.py" header replaced with a "manually owned in project-tracker" note (the sync script was removed in #6060).
  • The 2026-01-29 graph-garbage-nodes incident report is intentionally left as-is — its scaffolding paths are a snapshot of the time of writing.

Test plan

  • grep -rn "project-scaffolding/Documents\|project-scaffolding/agentsync" .agent/rules/ returns only the historical incident report and one intentional "this file replaced the old version at X" pointer.
  • grep -rn "EXTERNAL_RESOURCES\.md\b" .agent/rules/ returns 0 hits.
  • No code changes, no behavioral changes.

Related

  • Closes #6188
  • Follow-up to #6060

Project-tracker became self-contained for graph scanning (#6060,
2026-04-25 + 2026-05-11 follow-up). Many .agent/rules/*.md files
still pointed at scaffolding paths that no longer exist:

- `project-scaffolding/Documents/PROJECT_STRUCTURE_STANDARDS.md` —
  removed when scaffolding restructured. Links removed; no local
  replacement.
- `project-scaffolding/Documents/CODE_QUALITY_STANDARDS.md` — local
  copy at `.agent/rules/CODE_QUALITY_STANDARDS.md` is the live one.
  Links repointed.
- `project-scaffolding/Documents/PROJECT_KICKOFF_GUIDE.md` — removed.
  Links removed.
- `project-scaffolding/Documents/reference/LOCAL_MODEL_LEARNINGS.md` —
  removed. MODEL_LEARNINGS.md is the local successor.
- `project-scaffolding/Documents/reports/trustworthy_ai_report.md` —
  removed. Inline reference left as historical pointer.
- `project-scaffolding/EXTERNAL_RESOURCES.md` → `.yaml`. Renamed
  upstream; all 9 occurrences corrected.
- `project-scaffolding/agentsync/sync_governance.py` — removed when
  project-tracker became self-contained. REVIEWS_AND_GOVERNANCE_
  PROTOCOL.md header rewritten to drop the "DO NOT EDIT" banner; the
  file is now manually owned in project-tracker.

The 2026-01-29 graph-garbage-nodes incident report is left as-is —
its scaffolding paths describe state at the time of writing.

Follow-up to #6060.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@manager-identity manager-identity Bot merged commit 55245f8 into main May 13, 2026
2 checks passed
@manager-identity manager-identity Bot deleted the chore/clean-stale-scaffolding-refs branch May 13, 2026 02:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants