Skip to content

Commit 7358e18

Browse files
docs: add scope change protocol and template (#372)
- Add Scope Change Comment Template to issue-driven-delivery skill - Enhance Scope Change Tracking section with detailed workflow - Add Scope Changes section to CONTRIBUTING.md - Reference Issue #167 as partial exemplar DangerJS file-matching check descoped as unreliable. Refs: #293 Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 8c4ca98 commit 7358e18

File tree

2 files changed

+72
-11
lines changed

2 files changed

+72
-11
lines changed

CONTRIBUTING.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,40 @@ the complete workflow with proper plan formatting and approval.
5151
**Awaiting approval to proceed.**
5252
```
5353

54+
## Scope Changes
55+
56+
When scope changes during implementation (adding, removing, or modifying requirements):
57+
58+
1. **Post scope change comment** on the issue using the template below
59+
2. **Wait for approval** before making the change
60+
3. **Update issue body** with the approved change
61+
62+
**Scope change comment format:**
63+
64+
```markdown
65+
## Scope Change
66+
67+
**Type:** Addition / Removal / Modification
68+
**Reason:** [Why the change is needed]
69+
**Impact:** [What this affects]
70+
71+
**Changes:**
72+
73+
- ~~Removed: [item]~~
74+
- Added: [item]
75+
76+
**Awaiting approval to proceed with scope change.**
77+
```
78+
79+
**After approval, update issue body:**
80+
81+
- Added items: `- [ ] New item (added: [approval](link))`
82+
- Removed items: `- [ ] ~~Removed item~~ (descoped: [approval](link))`
83+
84+
**Enforcement:** DangerJS Rule 3 fails PRs with descoped items missing approval links.
85+
86+
See `skills/issue-driven-delivery/SKILL.md` for complete scope change protocol.
87+
5488
## Creating Skills
5589

5690
### Process Overview

skills/issue-driven-delivery/SKILL.md

Lines changed: 38 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1742,9 +1742,42 @@ All scope changes during implementation MUST be tracked in acceptance criteria:
17421742
17431743
**Adding scope:**
17441744
1745-
1. Get approval in issue comment
1746-
2. Add new checkbox with approval link
1747-
3. Complete work and add evidence
1745+
1. Post scope change comment (use template below)
1746+
2. Get approval in issue comment thread
1747+
3. Add new checkbox with approval link
1748+
4. Complete work and add evidence
1749+
1750+
**Removing scope (descoping):**
1751+
1752+
1. Post scope change comment (use template below)
1753+
2. Get approval in issue comment thread
1754+
3. Strike through item and add approval link
1755+
4. Item remains unchecked but struck through
1756+
1757+
**Scope change without approval is a violation.** All added or removed work
1758+
requires explicit approval captured in issue comments.
1759+
1760+
#### Scope Change Comment Template
1761+
1762+
When scope changes, post a comment using this format:
1763+
1764+
```markdown
1765+
## Scope Change
1766+
1767+
**Type:** Addition / Removal / Modification
1768+
**Reason:** [Why the change is needed]
1769+
**Impact:** [What this affects - timeline, dependencies, etc.]
1770+
1771+
**Changes:**
1772+
1773+
- ~~Removed: [item being removed]~~
1774+
- Added: [new item being added]
1775+
- Modified: [item changed] → [new version]
1776+
1777+
**Awaiting approval to proceed with scope change.**
1778+
```
1779+
1780+
After approval, update the issue body:
17481781
17491782
Format for added scope:
17501783
@@ -1753,20 +1786,14 @@ Format for added scope:
17531786
- [x] New requirement (added: [approval](#issuecomment-123), [evidence](commit-link))
17541787
```
17551788
1756-
**Removing scope (descoping):**
1757-
1758-
1. Get approval in issue comment
1759-
2. Strike through item and add approval link
1760-
3. Item remains unchecked but struck through
1761-
17621789
Format for descoped items:
17631790
17641791
```markdown
17651792
- [ ] ~~Original requirement~~ (descoped: [approval](#issuecomment-123))
17661793
```
17671794
1768-
**Scope change without approval is a violation.** All added or removed work
1769-
requires explicit approval captured in issue comments.
1795+
**Exemplar:** [Issue #167](https://github.com/mcj-coder/development-skills/issues/167) demonstrates
1796+
partial scope change compliance with documented scope reduction.
17701797
17711798
### Plan Lifecycle Evidence
17721799

0 commit comments

Comments
 (0)