taurean.bryant.land
a template starter repo for sveltekit projects
docs(agents): add Task flow section
Replaces the one-line 'Task lifecycle' pointer with a full Start / During /
End flow that consolidates the rules scattered across the rest of AGENTS.md
(Authoring boundaries, Working style, Releases, Decision Graph) into one
sequence the agent can follow turn-by-turn. The procedural detail still
lives at .opencode/skills/task-lifecycle/SKILL.md; this section is the
in-context summary.
Start: pull main, branch, log goal, design in plan mode.
During: action nodes, process skills, authoring boundaries, commits,
deciduous linking.
End: verify, task note, version bump, hand back.
Co-authored-by: opencode <noreply@opencode.ai>
author
Taurean Bryant
co-author
opencode
committer
Tangled
date
(Jun 6, 2026, 8:54 AM +0300)
commit
bc21cdfc
bc21cdfc82411887a3b0ccc170773f42a6e32161
parent
4ee7ec3f
4ee7ec3f0a1fd28b5740239b01b61a333aeaf670
+36
-2
+36
-2
AGENTS.md
+36
-2
AGENTS.md
···
51
51
Zed's plan/build mode toggle is the human's lever — follow the active mode
52
52
without prompting. See **Verification before completion** for done criteria.
53
53
54
-
## Task lifecycle
54
+
## Task flow
55
+
56
+
Every release branch follows this flow from task start to task done. The
57
+
procedural reference lives at `.opencode/skills/task-lifecycle/SKILL.md`;
58
+
this section is the in-context summary that consolidates the rules
59
+
scattered above (Authoring boundaries, Working style, Releases, Decision
60
+
Graph) into one sequence.
61
+
62
+
### Start
63
+
64
+
1. `git pull origin main` — sync with `main`.
65
+
2. `git checkout -b <type>/<slug>` — branch from `main`.
66
+
3. For non-trivial work, log a goal node with the verbatim user prompt.
67
+
4. For design or unclear requirements, use Zed plan mode until the human
68
+
approves a direction. No code edits in plan mode.
55
69
56
-
End-of-task skill: `.opencode/skills/task-lifecycle/SKILL.md`. The agent owns the task note — create it at task end without being asked, regardless of task size. Size of note scales with task.
70
+
### During
71
+
72
+
1. Before each major edit, log an action node and link it to the goal.
73
+
2. Apply `~/.agents/skills/` process skills when they clearly apply
74
+
(`tdd`, `diagnose`, `prototype`, `review`, `qa`, `handoff`, `caveman`,
75
+
`write-a-skill`).
76
+
3. Honour Authoring boundaries — humans own presentation, agents own TS.
77
+
4. Commit on the branch with the `Co-authored-by: opencode` trailer.
78
+
5. Link each commit: `deciduous add action|outcome "..." --commit HEAD`.
79
+
80
+
### End
81
+
82
+
1. Verify: `pnpm check`, `pnpm test`, and `pnpm lint` if lintable files
83
+
changed. Capture command + result in the task note.
84
+
2. Write the task note at `agent-notes/YYYY-MM-DD-NN-<slug>.md` from the
85
+
template. Append to the chronological record — never delete.
86
+
3. Bump the version: `pnpm version <YYYY.M.D> --no-git-tag-version`.
87
+
4. Commit the version bump: `chore(release): cut <version>`.
88
+
5. Hand back. The human reviews the PR, merges to `main`, and tags the
89
+
merge commit on `main` with the bare version string. The agent does
90
+
not push, merge, or tag.
57
91
58
92
## Releases
59
93