sdd-amend

Amends approved SDD pipeline artifacts in place and flags affected downstream stages for revalidation.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/asengardeon/btt-sdd-pipeline --skill sdd-amend-asengardeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-amend
Source: https://github.com/asengardeon/btt-sdd-pipeline/tree/main/.claude/skills/sdd-amend
Command: npx skills add https://github.com/asengardeon/btt-sdd-pipeline --skill sdd-amend-asengardeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Changing an already-approved artifact in a spec-driven development pipeline normally forces you to restart the entire workflow from scratch, wasting the effort of every downstream stage. This Skill edits the artifact in place, logs the change, and marks only the genuinely affected downstream stages as requiring revalidation. ## Core Features & Use Cases - In-place artifact editing: Modifies PRD, TRD, implementation code, code review, QA report, security review, or SRE review files without recreating them, and marks resolved "VALIDAR DEPOIS" items as validated instead of deleting them. - Impact propagation: Uses the fixed pipeline order (PRD → TRD → implementation → code review → QA → security → SRE) to determine which downstream stages need revalidation and which stay approved. - Revision logging: Records date, author, change, and reason in each artifact's revision log, with rules that prevent revalidation flags from being accidentally re-triggered by closing entries. - Use Case: A stakeholder changes an acceptance criterion in an approved PRD. The Skill edits the PRD, flags the TRD, implementation, and QA stages for revalidation, and tells you exactly which commands to rerun. ## Quick Start Ask the assistant to amend the approved TRD for a feature slug to change a design decision and propagate revalidation only to the affected downstream stages.

Frequently Asked Questions about sdd-amend

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

FAQPage Schema
How do I change an approved PRD without restarting the whole SDD pipeline?▼

Use the sdd-amend command to edit the PRD in place. It logs the change in the revision history and flags only the downstream stages actually affected, such as the TRD and implementation, for revalidation.

How do I resolve a VALIDAR DEPOIS item in a spec artifact?▼

Run sdd-amend targeting the artifact containing the pending item. The item is marked as validated rather than removed, preserving the history that the question existed and was resolved.

Which pipeline stages need revalidation after amending a TRD?▼

Amending a TRD can require revalidation of the implementation, code review, QA, and security stages. The SRE stage is only affected if the change involves infrastructure.

Why does a revalidation flag stay open after I closed it?▼

The closing log entry must not quote the phrase "requer revalidação", because status detection greps for that text and treats it as a new open flag. Describe the resolution in other words and add a formal reapproval line with a later date.

Does amending a QA or security report affect earlier pipeline stages?▼

No. Changes to QA, security, or SRE reports normally do not affect earlier approved stages and only require updating the report itself, since upstream artifacts were already approved.