increment · diff
git:20260727.8eadc99 to git:20260817.3d2939d
10 added, 3 removed. Audit A to A.
---
name: increment
description: >
Start the Act phase of the SPARK loop: build the increment strictly
following the approved plan, task by task, with progress tracked in the
plan. Use after the plan is approved, or to fix findings that came back
from /peer-review or /demo-day.
---
# /increment — Act (Developer)
You are running the **Act** ceremony — and this time *you* are the team
member: the developer. No delegation; you build the increment yourself, in
this conversation, so the user can watch and steer.
## Input
Optional argument: the feature name. Resolve as usual.
## Steps
1. **Check the gate.** `.spark/<feature-name>/plan.md` must exist with
status `approved`. If not, STOP and point to `/sprint-plan`.
2. **Load the working set — not the whole files.** From `plan.md`: §1
Architecture Decision, §2 Affected Components, §3 Task Breakdown, §4 Test
Strategy. From `spec.md`: §4 User Stories with their ACs, §5
Non-Functional Requirements, §6 Out of Scope. That is your backlog, your
definition of correct, and your scope fence. The rest — personas,
assumptions, the clarification log, the design review, the risk table —
is material the Plan phase already consumed and turned into tasks;
re-reading it here buys nothing and costs the context that the tasks
themselves need. Pull a further section only when a task actually calls
for it. The plan is your backlog — the task table top to bottom,
dependencies respected.
3. **Work task by task.** For each task:
- set its Status to `doing` in the plan's task table;
- implement it following the architecture decision and the codebase's
existing conventions;
- verify its **definition of done** — actually verify it (run the test,
hit the endpoint, render the page), don't assert it;
- write the tests the test strategy assigns to this task;
- set Status to `done` and give the user a one-line progress note.
4. **Stay inside the plan.** If a task turns out wrong, impossible or
missing:
- small, obvious correction → do it and record the deviation in a
*Deviations* note appended to the plan;
- anything that changes architecture, scope or stories → STOP and offer
`/sprint-plan` (revision) or `/story-time`. You do not improvise
architecture — that's the whole point of aSPARK.
5. **Fix-mode.** When invoked to fix findings from `/peer-review` or
- `/demo-day`: those findings are your task list. Fix each, note the fix
- next to the finding in the respective report, and re-run the affected
- tests.
+ `/demo-day`: read the report's **Handoff** block first — it names the
+ open Blocker/Major IDs, which is your task list; read the Findings /
+ Exploratory Findings table by exception, for the rows the block points
+ at, not the whole report. Fix each, note the fix next to the finding in
+ the respective report, and re-run the affected tests. You are not that
+ report's owner, but the same edit that notes a fix, closes a finding or
+ changes its status also **overwrites the Handoff block in place** with
+ the new state — never append a round, the block holds one current state.
+ A stale block left behind after your edit is a defect, not a cosmetic
+ issue.
6. **Close the phase.** All tasks `done`, full test suite green, project
builds. Report to the user: tasks completed, deviations recorded, test
results.
## Rules
- No scope creep: features not in the plan don't get built, "while I'm here"
improvements don't happen. Park ideas for the next `/story-time`.
- Never mark a task `done` with a failing or unwritten DoD check.
- Match the codebase's existing style, structure and idioms.
## Handoff
- Increment complete → **`/peer-review`**
- Came from fix-mode → back to the phase that sent you
(**`/peer-review`** re-review or **`/demo-day`** re-test)