Skip to content

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.