design-modify

Modify SDD design documents with status transitions and marker resolutions.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/oogDZ/2 --skill design-modify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-modify
Source: https://github.com/oogDZ/2/tree/main/.claude/skills/design-modify
Command: npx skills add https://github.com/oogDZ/2 --skill design-modify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Modify design documents (SDD) to reflect latest decisions.

Core Features & Use Cases

  • Update design content to align with current decisions.
  • Resolve markers and ensure consistency across SSOT.
  • Transition design artifacts through statuses (e.g., DRAFT -> WAITING) and roll back changes when needed.

Quick Start

Run the design-modify command with a target path, e.g. /design-modify specs/analysis/0001-design/design.md --status WAITING.

Frequently Asked Questions about design-modify

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

FAQPage Schema
How do I update a design document to reflect new decisions in an SSOT workflow?

To update a design document in an SSOT workflow, you modify the SDD file to align with current decisions by resolving markers and validating references. This ensures the single source of truth remains consistent across versions.

How do I transition a design document status from DRAFT to WAITING?

You transition a design document status from DRAFT to WAITING by running the modify command with a target path and the --status flag. This enforces strict workflow transitions and validates the update per SSOT guidelines.

Can I roll back design artifacts after modifying an SDD file?

Yes, you can roll back design artifacts after modifying an SDD file. The modification process handles artifact rollbacks across the SSOT workflow, allowing you to revert changes when needed to maintain document integrity.

What is marker resolution in design documentation?

Marker resolution in design documentation is the process of clearing flagged inconsistencies within the SDD. It ensures content aligns with current decisions and guarantees consistency across the entire SSOT workflow.

Does design-modify validate references when updating existing designs?

Yes, design-modify validates references when updating existing designs. It enforces a strict workflow that checks all reference links within the SDD to ensure they comply with SSOT guidelines during content updates.

When should I not use a strict workflow for updating design docs?

You should not use a strict workflow for updating design docs when making informal edits outside the SSOT workflow. This approach enforces status transitions and reference validation, which requires structured decision tracking to function correctly.