Task: Scaffold story: Implement the operations journeys in ores.web
Table of Contents
This page documents a task in the Implement the operations journeys in ores.web story. It captures the goal, current status, acceptance, and any notes or results.
1. Goal
Land the story that owns the Operations journey group: the story page, the six tasks, the sprint row and the programme's order table. The design is already accepted — the five journeys and the throwaway prototype carry it — and this task does not touch the journey documents.
2. Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Implement the operations journeys in ores.web |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-10-04 |
3. Acceptance
- The story exists in Sprint 26, and the sprint's
* Storiestable links it. - The programme story's order table names this story against the Operations group.
- The six tasks are wired into the story's
* Taskstable: the five data-model linkages are one task each, and the screens build is one task. - The story names the accepted prototype branch as its design record and states that the prototype is ported, not merged.
compass lintpasses and the pages publish.
4. Plan
- Scaffold the story with
compass story new. - Write the goal, the acceptance, the plan, the decisions, the out-of-scope list and the documents.
- Scaffold the six tasks with
compass task new, so each one is wired into the story's* Taskstable. - Wire the story into the sprint's
* Storiestable, and into the programme's order table. - Raise the scaffold PR. The six tasks stay BACKLOG until the PR merges.
5. Measurements
Every number this task claims about a tree, with the command that produced it
and the commit it was measured at. A number without both is not a measurement,
because a clean-up record describes a tree and trunk moves under a branch: a
consumer count, a gate's component count and a suite's size all change with no
code changing, and the reader of a bare number cannot tell which tree it came
from. Where the raw output matters, put it in an evidence/ file beside the
task and name that file in the Command column.
| What | Value | Command | Commit |
|---|---|---|---|
| Operations journeys in the catalogue | 5 | ls doc/knowledge/journeys/operations/journey_*.org |
00b369b9d7 |
| Groups in the journey catalogue | 9 | ls -d doc/knowledge/journeys/*/ |
00b369b9d7 |
| Data-model captures the record filed | 5 | git show --name-only --format 7d61b3ba7e – doc/agile/product_backlog/inbox/= |
00b369b9d7 |
6. Notes
- The group is the ninth in Implement the user journeys in ores.web, after Tenancy. It was the catalogue's last group written, and it is the only one whose design arrived settled: the five journeys were written and walked against a clickable prototype in sprint 26, and the user accepted the walk on 2026-10-04.
- The prototype branch
prototype/operations-journeysat285519db99is the design record and never merges. Each journey names the branch and its route under* Prototype. - The five captures the walk filed are the story's first tasks: the heartbeat host (A1D7FC12), the roster read (B7B53CD1), the login-answer database (B7AE6C4F), the grid read's scope (3621E2BC) and the node summary's failure fields (8C1D6E61).
- The journey documents are fresh — written on 2026-10-04 against this tree — so no survey task precedes the build: each task re-checks its own claims as it works.
- The tree at the branch point already carries the journey runtime from the
Setup group (
projects/ores.web/packages/web/src/journeys/runtime.ts). - The shell already carries one operations read:
compute grid-statsand its recipe atprojects/ores.shell/scripts/library/compute/, so the grid tasks verify the shell side as they change the read.
7. Test Scenarios
Manual QA scenarios (scaffolded via compass add test_scenario)
that verify this task. Link
new ones here as they're created; the scenario doc itself links back
via its "Verifies task" field.
| Scenario | State | Notes |
|---|---|---|
8. PRs
| PR | Title |
|---|---|
| 2622 | [agile] Scaffold the operations journeys story |
9. Review
| # | Comment summary | File | Decision | Notes |
|---|---|---|---|---|
| 1 | Next names one task although the five data-model linkages have no fixed order |
story.org | Fixed | Next now says the five run in any order, and the heartbeat task is one of them. |
| 2 | The sprint row and the story dates agree although both were written the same day | sprint.org | No change | The review found them consistent. |
| 3 | The task pages keep the empty template sections | the six task pages | No change | Normal for a scaffold; each Plan fills in when its task starts. |
| 4 | Row 9 could read as a dependency order | story.org | No change | The note paragraph under the order table explains the row placements. |
10. Result
Done 2026-10-04. PR #2622.
The Operations group has a story, six tasks, a row in sprint 26 and a row in the programme's order table:
| Artefact | Id |
|---|---|
| Story: Implement the operations journeys in ores.web | 435E6F02-C2AF-4C2B-BB56-654A86A424A7 |
| Task: Carry the host on the heartbeat | BAE5860D-49CF-4063-A63A-76DA8AFAB166 |
| Task: Serve the services roster | D495FB06-E711-4DCB-A4C6-2E4722FF973F |
| Task: Carry the database on the login answer | 9B13FEDD-E6E5-43F2-B7A9-DF5BEF9230A7 |
| Task: Read the whole grid | E3FF9B97-A7F5-494F-BECE-DBB8910244C6 |
| Task: Keep the failure fields on the node summary | 4DC1AFB6-F687-4314-A5B3-C7A786A93F57 |
| Task: Build the operations screens in ores.web | 5E83118A-1342-4088-B371-3367EF63FF17 |
Two facts were checked while scaffolding, and both are recorded on the story:
- The five journey documents are fresh. They were written and accepted against this tree on 2026-10-04, so no survey task precedes the build, and each task re-checks its own claims as it works.
- Both clients' starting points exist on the tree. The journey runtime is
already there (
projects/ores.web/packages/web/src/journeys/runtime.ts, landed by the Setup group), and the shell already carries one operations read:compute grid-statsand its recipe underprojects/ores.shell/scripts/library/compute/.
The sprint's * Stories row needed one hand-edit: compass story new left it
at BACKLOG while the story opened STARTED. The row states STARTED with
2026-10-04 as its start.
Verification: compass lint passes on this branch (filetags and generator
markers valid; the durable-document link advisory stands at 224 links across
105 files). compass site page rebuilt 19 page(s) with 0 failure(s). The
story row was read back from the sprint's * Stories table, and its six tasks
were wired into its * Tasks table by compass task new.