What files does this skill typically update?

It primarily updates governance documents like ROADMAP_NEXT_STEPS.md, issue READMEs, and moves completed issue files to an archived directory.

What is the primary purpose of the Housekeeping skill?

It serves as a workflow coordinator that ensures a project's documentation, roadmap, and issue tracking accurately reflect the current state of the codebase by automating maintenance tasks.

How does it handle multiple tasks efficiently?

The skill uses a multi-phase workflow that launches five parallel subagents to handle issue reconciliation, file organization, drift detection, and git cleanup simultaneously.

Is it safe to let the skill delete files or worktrees?

Yes, it follows strict safety rules. For example, it only removes git worktrees if the associated PR is confirmed as merged and there are no uncommitted changes or unpushed commits.

When should I trigger a housekeeping run?

You should run it whenever you feel the project state is messy, after merging significant features, or by using commands like 'run housekeeping' or 'clean up project state'.

Project Housekeeping & Governance

Name: Project Housekeeping & Governance
Author: bacchus-labs

bybacchus-labs

•

Productividad y Flujo de Trabajo

Orchestrates a comprehensive project maintenance workflow to reconcile implementation reality with documentation, issues, and roadmaps.

Acerca de

The Housekeeping skill is a powerful workflow coordinator designed to keep complex development projects organized and up-to-date. By launching multiple parallel subagents, it simultaneously refreshes governance metrics, updates implementation roadmaps, reconciles issue statuses against actual code, archives completed work, and identifies documentation drift. This skill ensures that your project's state is always accurately reflected in your tracking files, providing developers with a clear snapshot of current progress and necessary next steps without the manual overhead of project management.

Características Principales

Automated governance metrics and roadmap status updates
Safe cleanup of dangling git worktrees associated with merged PRs
Intelligent archival of completed issues and root directory organization
Proactive detection of documentation drift and constitutional compliance gaps
3 GitHub stars
Parallel reconciliation of open issues with actual implementation reality

Casos de Uso

Synchronizing issue trackers and roadmaps after a major sprint or feature merge
Cleaning up workspace clutter and organizing project memos and analysis files
Performing a weekly audit of project documentation to ensure it matches the current codebase

Acerca de

Características Principales

Automated governance metrics and roadmap status updates
Safe cleanup of dangling git worktrees associated with merged PRs
Intelligent archival of completed issues and root directory organization
Proactive detection of documentation drift and constitutional compliance gaps
3 GitHub stars
Parallel reconciliation of open issues with actual implementation reality

Casos de Uso

Synchronizing issue trackers and roadmaps after a major sprint or feature merge
Cleaning up workspace clutter and organizing project memos and analysis files
Performing a weekly audit of project documentation to ensure it matches the current codebase