Skip to content

Commit 0f40e13

Browse files
Keep implementation plans test-first
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent 4c84c55 commit 0f40e13

1 file changed

Lines changed: 13 additions & 12 deletions

File tree

src/docs/Ways-of-Working/Issue-Format.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -229,10 +229,11 @@ The task-level roadmap. Implementers track progress here; reviewers use it to un
229229
Structure:
230230

231231
- Every discrete piece of work is a checkbox: `- [ ]`.
232-
- Tasks are grouped under subheadings when work spans multiple areas (files, components, tests).
232+
- Tasks are grouped under subheadings when work spans multiple behaviors or dependencies. Keep each behavior's tests with its implementation tasks.
233233
- Each task is specific and actionable — file paths, function names, modules.
234234
- All tasks start unchecked. Checking happens during implementation.
235-
- Tasks are ordered logically — dependencies first, tests last.
235+
- Order groups and tasks so scope and dependencies are clear; the checklist layout is not a mandatory execution sequence.
236+
- Follow [test-first development](../Coding-Standards/Testing.md#test-first): define and run a behavior's test before implementing that behavior, regardless of how its checkboxes are organized.
236237

237238
For PBIs and Epics, Section 3 is **a list of links to child issues**, not inline tasks. See [Issue Hierarchy](Issue-Hierarchy.md).
238239

@@ -243,17 +244,17 @@ For PBIs and Epics, Section 3 is **a list of links to child issues**, not inline
243244

244245
## Implementation plan
245246

246-
### Core changes
247+
### Paged responses
247248

249+
- [ ] Add unit test for single-page response
250+
- [ ] Add unit test for multi-page response
248251
- [ ] Add a paged-request helper in `src/lib/`
249252
- [ ] Update the `repo list` command to call the paged variant in `src/commands/repository/`
250-
- [ ] Add a `--limit` option with integer type and validation
251253

252-
### Tests
254+
### Result limiting
253255

254-
- [ ] Add unit test for single-page response
255-
- [ ] Add unit test for multi-page response
256256
- [ ] Add unit test for `--limit` option limiting results
257+
- [ ] Add a `--limit` option with integer type and validation
257258

258259
### Documentation
259260

@@ -375,17 +376,17 @@ multi-page, and `--limit` limiting.
375376

376377
## Implementation plan
377378

378-
### Core changes
379+
### Paged responses
379380

381+
- [ ] Add unit test for single-page response
382+
- [ ] Add unit test for multi-page response
380383
- [ ] Add a paged-request helper in `src/lib/`
381384
- [ ] Update the `repo list` command to call the paged variant in `src/commands/repository/`
382-
- [ ] Add a `--limit` option with integer type and validation
383385

384-
### Tests
386+
### Result limiting
385387

386-
- [ ] Add unit test for single-page response
387-
- [ ] Add unit test for multi-page response
388388
- [ ] Add unit test for `--limit` option limiting results
389+
- [ ] Add a `--limit` option with integer type and validation
389390

390391
### Documentation
391392

0 commit comments

Comments
 (0)