Skip to content

Commit d7f6f36

Browse files
committed
chore(specs): add deferred items section to maintenance spec
Document that maintenance passes should create GitHub issues for large-scope items rather than silently skipping them. Record deferred items from the 2026-03-27 run (#880, #881).
1 parent b1d9327 commit d7f6f36

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

specs/012-maintenance.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,24 @@ Failures persisting **>2 consecutive days** are blocking:
119119
3. Assign to most recent contributor in failing area
120120
4. If upstream dep change: pin to known-good rev, open follow-up issue
121121

122+
## Deferred Items
123+
124+
When a maintenance pass identifies issues too large to fix inline (e.g.
125+
multi-file refactors, cross-cutting changes), the pass must:
126+
127+
1. Create a GitHub issue for each deferred item with clear scope and reproduction steps
128+
2. Record the issue numbers in the summary below so they are tracked
129+
130+
Deferred items are **not** failures — they are expected for large-scope
131+
improvements. The requirement is that they are **tracked**, not silently skipped.
132+
133+
### Deferred from 2026-03-27 run
134+
135+
| Issue | Section | Description |
136+
|-------|---------|-------------|
137+
| #880 | Simplification | Migrate 27 builtins from manual arg parsing to ArgParser |
138+
| #881 | Simplification | Extract errexit suppression propagation helper |
139+
122140
## Automation
123141

124142
Sections dependencies, tests, examples, code quality, and nightly CI are fully

0 commit comments

Comments
 (0)