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

•

Productivity & Workflow

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

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.

Key Features

01Automated governance metrics and roadmap status updates

02Safe cleanup of dangling git worktrees associated with merged PRs

03Intelligent archival of completed issues and root directory organization

04Proactive detection of documentation drift and constitutional compliance gaps

053 GitHub stars

06Parallel reconciliation of open issues with actual implementation reality

Use Cases

01Synchronizing issue trackers and roadmaps after a major sprint or feature merge

02Cleaning up workspace clutter and organizing project memos and analysis files

03Performing a weekly audit of project documentation to ensure it matches the current codebase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bacchus-labs/wrangler housekeeping

For use in Claude.ai and ChatGPT

Download Skill