l3io-util-cleanup

Reorganize BMad artifacts into epic/sprint folders and migrate sprint-status.yaml files.

Updated May 1, 2026
One-click install
npx skills add https://github.com/ravensorb/bmad-extensions --skill l3io-util-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: l3io-util-cleanup
Source: https://github.com/ravensorb/bmad-extensions/tree/main/src/l3io-util/l3io-util-cleanup
Command: npx skills add https://github.com/ravensorb/bmad-extensions --skill l3io-util-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill assists in organizing and maintaining BMad artifacts, ensuring efficient project management and artifact organization.

Core Features & Use Cases

  • Artifact Reorganization: Reorganizes flat BMad artifact outputs into structured epic/sprint folders.
  • Status File Management: Handles sprint-status.yaml file migrations, splits, and schema updates.
  • Debt Harvesting: Identifies and harvests deferred-shortcut code markers into the consolidated backlog: list.
  • AI System Instructions Update: Updates AI system instruction files to reflect the current status file layout.
  • Legacy Cleanup: Removes migration backup files and renames legacy status files.
  • Use Case: For a project with outdated BMad artifacts and a need for a comprehensive artifact cleanup, use this Skill to reorganize files, update status files, and ensure a consistent artifact structure.

Quick Start

To run the project health check and propose actions, execute the command /l3io-util-cleanup in the project directory.

Frequently Asked Questions about l3io-util-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reorganize flat BMad artifacts into structured folders?

You can reorganize flat BMad artifacts into structured epic and sprint folders by running a project health check command that proposes reorganization actions for your artifact directory.

What is the best way to migrate sprint-status.yaml files and update schemas?

The best way to manage sprint-status.yaml files is using a Python-based utility to handle schema updates, file splits, and migrations while ensuring AI system instructions reflect the layout.

How do I harvest deferred-shortcut code markers into a backlog?

You can harvest deferred-shortcut code markers by running an artifact cleanup script that identifies them and consolidates the entries into a unified backlog list for tracking.

Do I need Python to manage and clean up BMad status files?

Yes, Python is required to execute the artifact management scripts, and you must configure BMad to define the correct artifact paths for successful status file maintenance.

How does legacy BMad artifact cleanup work for outdated projects?

Legacy cleanup works by removing migration backup files and renaming old status files, bringing outdated project structures into alignment with current BMad artifact standards.