What problem does it solve?
This Skill streamlines the administrative burden of project management by automating progress tracking, decision journaling, and lifecycle management for Spec-Driven Development (SDD) JSON files. It ensures your specifications are always up-to-date, reflecting the true state of development and fostering transparency.
Core Features & Use Cases
- Automated Status Updates: Mark tasks and phases as
pending, in_progress, completed, or blocked, with automatic progress recalculation.
- Comprehensive Journaling: Add timestamped entries for decisions, deviations, blockers, and notes directly into the JSON spec.
- Lifecycle Management: Move specs between
active, completed, and archived folders, and update spec-level metadata.
- Use Case: As you complete a task, use this skill to mark it
completed, add a journal entry documenting any deviations from the original plan, and then check the overall status-report to see how your progress impacts the entire project.
Quick Start
Mark a task as in progress
sdd update-status user-auth-001 task-1-2 in_progress --note "Starting User model implementation"
Mark a task as completed, automatically running associated verifications
sdd update-status user-auth-001 task-1-2 completed --note "User model finished and tested" --verify
Add a journal entry for a deviation from the plan
sdd add-journal user-auth-001 --title "Deviation: UUID Primary Keys" --content "Switched to UUIDs for primary keys for better distribution." --task-id task-1-2 --entry-type deviation
Get a summary of overall progress and status
sdd status-report user-auth-001