sdd-update

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