What problem does it solve? Recurring repository upkeep—dependency updates, failing CI, small ready issues, and engineering health checks—often goes undone because no one schedules it. This Skill runs a governed, policy-driven gardening pass that senses repository health, selects small safe units of work, and ships each as its own reviewable pull request with a morning report. ## Core Features & Use Cases - Policy-governed runs: Reads .agents/repo-gardener.yaml for protected paths, scan commands, verification commands, and a PR cap; a missing or invalid policy degrades the run to sense-and-report only. - Coordinator plus Executor model: The Coordinator senses five areas (dependencies, engineering health, documentation, runtime reliability, issues), then dispatches isolated-worktree Executors that each produce at most one unmerged PR verified against the policy's verify commands. - Independent merge-readiness review: A fresh read-only Reviewer judges each PR's merge readiness, and all results are posted as one plain-Markdown report comment on a configured GitHub issue. - Use Case: Point it at a repository overnight; by morning you have a report listing opened PRs with CI state and merge verdicts, scan summaries, and recommendations for items it deliberately did not touch, such as protected paths or bot dependency PRs. ## Quick Start Ask the agent to run repo-gardener on this repository and confirm that .agents/repo-gardener.yaml exists on the default branch with scans and verify commands configured.
