Gap backlog work item template¶
Use this shape for every Feature / User Story / Task in master epic files and per-repo mirrors. Items must be fully self-contained — no "see master file" hand-offs for descriptions or acceptance criteria.
Template (copy for each item)¶
### [NNN] saas-<AREA>-F## — <Descriptive Title>
**Type:** Feature | User Story | Task
**Parent:** <ParentId>
**Implementation order:** NNN
**Status:** Not Started | In Progress | Blocked | Completed | Deferred | Cancelled
**Master:** <relative link — mirrors only>
**Area path:** ConnectSoft\SaaS\<Context>
**Iteration:** TBD
**Tags:** saas-platform, gap, <context>, <priority>
**Priority:** P0 | P1 | P2
**Effort:** S | M | L | XL
**Dependencies:** <comma-separated saas-* IDs>
**Blocks:** <reverse dependencies>
**Source gap analysis:** [anchor in saas-gap-deep-analysis.md](../saas-gap-deep-analysis.md#<anchor>)
**Description (full):**
<Multi-paragraph narrative: current state with file paths, target state, why it matters, cross-service contracts.>
**Acceptance criteria (testable):**
- AC-1: ...
- AC-2: ...
**Implementation notes (full):**
- Files to touch: ...
- Code symbols: ...
- ADRs: ...
- Tests: ...
**Out of scope:**
- ...
**Definition of done:**
- [ ] All AC pass
- [ ] Tests added/updated and green
- [ ] Docs updated
- [ ] Status updated in master + mirrors
ID conventions¶
| Level | Format | Example |
|---|---|---|
| Epic | saas-EPIC-<AREA> |
saas-EPIC-INTEG |
| Feature | saas-<AREA>-F## |
saas-INTEG-F01 |
| User Story | saas-<AREA>-S##.# |
saas-INTEG-S01.1 |
| Task | saas-<AREA>-T##.#.# |
saas-INTEG-T01.1.1 |
Areas: INTEG, TEN, CAT, ENT, BIL, MET, DOCS.
Status taxonomy¶
| Status | Use when |
|---|---|
| Not Started | New gap item |
| In Progress | Active development |
| Blocked | Waiting on dependency |
| Completed | Done |
| Implemented | Existing program item verified in code |
| Partial | Some AC met |
| Missing | Never implemented |
| Deferred | Out of scope this wave |
| Cancelled | No longer planned |
Each status includes Evidence: <path> and Last verified: YYYY-MM-DD.