using-minerva

What problem does it solve?

It prevents misusing the minerva workflow by explaining when to start, continue, and finalize durable software work using the right minerva: skill.

Core Features & Use Cases

• Detects whether a project uses minerva by checking for a .minerva/ directory, prior minerva: usage in the session, or routing to .minerva/ in agent files.
• Provides a lifecycle decision matrix mapping common situations (start, resume, drift, review, promote, ship, debug, and cleanup) to the correct minerva: skills.
• Supports targeted work units by allowing an optional slug/path argument for skills like minerva:work, minerva:replan, minerva:promote, minerva:review, minerva:ship, and minerva:cleanup.

Quick Start

Invoke using-minerva when you are beginning meaningful feature/refactor/investigation work or when you need to continue an existing unit instead of doing routine bugfixes, trivial edits, or one-shot Q&A.