docs: prioritize context-hygiene issues #286-#297 in issue-priority-plan

[markcallen]

Summary

• Updates plans/issue-priority-plan.md after the 2026-08-26 context-hygiene review of the generated agent rules.
• Records that ballast install from new nested project writes managed files to ancestor root #278 (safe root selection) is closed and removes it from the active slot.
• Makes the context-hygiene workstream (Emit Repository Tool Policy once in the target manifest instead of injecting it into every rule #286–Investigate path/glob-scoped rule loading per target #297) the new top priority, organized into four phases: build-pipeline quick wins (Emit Repository Tool Policy once in the target manifest instead of injecting it into every rule #286, Skip emission of inactive/reference-only rules instead of shipping them with a disclaimer #287, Populate the CLAUDE.md/AGENTS.md Repository Facts section from .rulesrc.json at install time #288), shared-content dedupe (Add a shared-fragment include mechanism for agent rule sources #291, Deduplicate testing rules: extract shared TDD, smoke/E2E, and framework-detection guidance #290, Render tasks-task-system rule only for the configured task system and target platform #293, Trim reference bloat from license, badges, cicd, and plan-lifecycle rules #292, Remove persona preambles and duplicated headings from generated rules #294), restructure/profiles (Consolidate the publishing rule family into a shared release-pattern rule plus thin per-artifact deltas #289, Add ruleProfile setting (full/standard/minimal) for small-context AI agents #295), and guardrails/research (Enforce ballast-audit size thresholds as a CI gate on generated rules #296, Investigate path/glob-scoped rule loading per target #297).
• Keeps the setup/toolchain workstream (Detect project package manager during setup and align Node/package-manager defaults to LTS #128, Check required local tools for Ballast rules using PATH detection plus Homebrew install guidance #94) next in line and notes that Populate the CLAUDE.md/AGENTS.md Repository Facts section from .rulesrc.json at install time #288 creates the landing spot for its detected facts.
• Records the measured baseline (.claude/rules/ = 133,310 bytes / 32 files; Repository Tool Policy duplicated 31×) as the before-number for validating the reductions.

Validation

• Tests or checks run: node scripts/check-whitespace.mjs trailing-whitespace plans/issue-priority-plan.md and end-of-file-newline — both pass. Docs-only change; no code paths affected.
• Docs updated or not needed: this PR is the docs update.
• Generated files updated or not needed: not needed — no agents/, skills/, build scripts, or target config touched.

Agent Notes

• Related issue/PRD: Emit Repository Tool Policy once in the target manifest instead of injecting it into every rule #286 Skip emission of inactive/reference-only rules instead of shipping them with a disclaimer #287 Populate the CLAUDE.md/AGENTS.md Repository Facts section from .rulesrc.json at install time #288 Consolidate the publishing rule family into a shared release-pattern rule plus thin per-artifact deltas #289 Deduplicate testing rules: extract shared TDD, smoke/E2E, and framework-detection guidance #290 Add a shared-fragment include mechanism for agent rule sources #291 Trim reference bloat from license, badges, cicd, and plan-lifecycle rules #292 Render tasks-task-system rule only for the configured task system and target platform #293 Remove persona preambles and duplicated headings from generated rules #294 Add ruleProfile setting (full/standard/minimal) for small-context AI agents #295 Enforce ballast-audit size thresholds as a CI gate on generated rules #296 Investigate path/glob-scoped rule loading per target #297
• Risk level: low (planning document only)
• Follow-up needed: implement Phase 1 (Emit Repository Tool Policy once in the target manifest instead of injecting it into every rule #286, Skip emission of inactive/reference-only rules instead of shipping them with a disclaimer #287, Populate the CLAUDE.md/AGENTS.md Repository Facts section from .rulesrc.json at install time #288) next.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Updates the open-issue priority plan to reflect the 2026-08-26 context-hygiene rules review, marking #278 as completed and promoting the #286–#297 reduction workstream to the top priority with a phased execution plan.

Changes:

• Refreshes plan status/source and updates the summary to capture the measured baseline and the new top priority workstream (#286–#297).
• Replaces the prior “implement #278 next” recommendation with a four-phase context-hygiene roadmap, followed by the setup/toolchain workstream (#128, #94).
• Adds explicit baseline metrics and recent-completed-work entries to support tracking and validation of the upcoming reduction work.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!