sdd-update

The sdd-update skill is designed to streamline progress tracking and administrative management for spec-driven development workflows. It addresses the challenge of keeping specification documents accurate and up-to-date during implementation, ensuring that tasks, decisions, and verification steps are properly recorded. By centralizing these updates through the CLI, it prevents inconsistencies, redundant work, and errors that can occur when spec files are modified manually or read directly with generic tools. This skill is essential for teams who need a reliable method to reflect the current state of development within their specifications without altering the core structure of the specs themselves.

Key features of sdd-update include marking tasks as completed, in progress, or blocked; logging journal entries to document decisions and deviations; moving specifications between lifecycle folders such as pending, active, or completed; and updating metadata fields for progress tracking. All operations are performed through the sdd CLI, which ensures proper validation, automated backups, and efficient handling of large JSON spec files. The skill focuses on lightweight updates, leaving heavier structural modifications—such as task descriptions, verification steps, and bulk changes—to the complementary sdd-modify skill.

Typical use cases for sdd-update include developers starting work on a task, updating progress, or recording important implementation decisions. Project managers can also use it to maintain an accurate overview of project status, track blockers, and ensure that the specification documents remain a true reflection of reality. Target users are teams following spec-driven development methodologies, where maintaining the integrity and currency of specification files is critical for successful implementation and review processes.