Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,40 @@ the complete workflow with proper plan formatting and approval.
**Awaiting approval to proceed.**
```

## Scope Changes

When scope changes during implementation (adding, removing, or modifying requirements):

1. **Post scope change comment** on the issue using the template below
2. **Wait for approval** before making the change
3. **Update issue body** with the approved change

**Scope change comment format:**

```markdown
## Scope Change

**Type:** Addition / Removal / Modification
**Reason:** [Why the change is needed]
**Impact:** [What this affects]

**Changes:**

- ~~Removed: [item]~~
- Added: [item]

**Awaiting approval to proceed with scope change.**
```

**After approval, update issue body:**

- Added items: `- [ ] New item (added: [approval](link))`
- Removed items: `- [ ] ~~Removed item~~ (descoped: [approval](link))`

**Enforcement:** DangerJS Rule 3 fails PRs with descoped items missing approval links.

See `skills/issue-driven-delivery/SKILL.md` for complete scope change protocol.

## Creating Skills

### Process Overview
Expand Down
49 changes: 38 additions & 11 deletions skills/issue-driven-delivery/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -1742,9 +1742,42 @@ All scope changes during implementation MUST be tracked in acceptance criteria:

**Adding scope:**

1. Get approval in issue comment
2. Add new checkbox with approval link
3. Complete work and add evidence
1. Post scope change comment (use template below)
2. Get approval in issue comment thread
3. Add new checkbox with approval link
4. Complete work and add evidence

**Removing scope (descoping):**

1. Post scope change comment (use template below)
2. Get approval in issue comment thread
3. Strike through item and add approval link
4. Item remains unchecked but struck through

**Scope change without approval is a violation.** All added or removed work
requires explicit approval captured in issue comments.

#### Scope Change Comment Template

When scope changes, post a comment using this format:

```markdown
## Scope Change

**Type:** Addition / Removal / Modification
**Reason:** [Why the change is needed]
**Impact:** [What this affects - timeline, dependencies, etc.]

**Changes:**

- ~~Removed: [item being removed]~~
- Added: [new item being added]
- Modified: [item changed] → [new version]

**Awaiting approval to proceed with scope change.**
```

After approval, update the issue body:

Format for added scope:

Expand All @@ -1753,20 +1786,14 @@ Format for added scope:
- [x] New requirement (added: [approval](#issuecomment-123), [evidence](commit-link))
```

**Removing scope (descoping):**

1. Get approval in issue comment
2. Strike through item and add approval link
3. Item remains unchecked but struck through

Format for descoped items:

```markdown
- [ ] ~~Original requirement~~ (descoped: [approval](#issuecomment-123))
```

**Scope change without approval is a violation.** All added or removed work
requires explicit approval captured in issue comments.
**Exemplar:** [Issue #167](https://github.com/mcj-coder/development-skills/issues/167) demonstrates
partial scope change compliance with documented scope reduction.

### Plan Lifecycle Evidence

Expand Down
Loading