shortcut-hygiene

What problem does it solve?

Audit and fix a Shortcut project against Fraction best practices. Checks for missing Priority custom field, stories without estimates/owners/types, missing epics, vague titles, empty descriptions, workflow state coverage, and stale Inbox stories (>30 days). Field-strict checks (estimate / story_type / Priority / epic / Iteration) skip Inbox stories — those are deferred until Inbox → Unscheduled promotion. The owner check skips Inbox AND Unscheduled — both are intentionally unassigned per the three-tier rule (ownership lands at sprint planning when a story moves to Started+). Reports gaps with story name + permalink under each non-zero category and offers fixes. Can also enrich the backlog from meeting transcripts, emails, and chat. Always enforces all best practices by default — only skip checks if the user explicitly opts out. Triggers on "clean up shortcut", "audit shortcut project", "fix shortcut board", "standardize shortcut", "shortcut hygiene", "enrich shortcut backlog".

Core Features & Use Cases

• Audit and fix Shortcut projects to enforce best practices (Priority field presence, estimates/owners/types, epic coverage, and clear titles/descriptions).
• Produce category-based gap reports with actionable fixes and preserve source attribution for enrichment scenarios.
• Optional backlog enrichment from transcripts, emails, and chat, while preserving default strict adherence to best practices.

Quick Start

Run the Shortcut Hygiene skill against a project to generate a hygiene report and apply recommended fixes.