taurean.bryant.land
a template starter repo for sveltekit projects
chore(process): add git workflow rule, drop Sentry/Axiom/agent tools from stack mentions
- AGENTS.md: add Git workflow section (branch from main, PR review, no direct push)
- AGENTS.md: trim stack line to technologies only
- task-lifecycle skill: add Before starting section for branch setup
author
Taurean Bryant
committer
Tangled
date
(Jun 3, 2026, 11:10 PM +0300)
commit
d5a93803
d5a93803013f91f59071ba63d3721dd4438bbf00
parent
fa5d6856
fa5d68565ca76163a212602b565cc97c9e60887e
+53
-5
+12
-3
.opencode/skills/task-lifecycle/SKILL.md
+12
-3
.opencode/skills/task-lifecycle/SKILL.md
···
1
1
# Task lifecycle
2
2
3
-
End-of-task skill. Run after the work is done, before claiming completion.
3
+
Run at the start of a task (branch setup) and at the end (note + verification).
4
+
5
+
## Before starting
6
+
7
+
1. Pull latest `main`: `git pull origin main` (or `git fetch` + rebase if `main` has moved).
8
+
2. Create a new branch from `main`: `git checkout -b <branch-type>/<slug>`.
9
+
3. Do the work. Apply other skills (TDD, debugging, code review) as relevant.
4
10
5
-
## Steps
11
+
## Steps at task end
6
12
7
13
1. If a plan was generated in this conversation, persist it to `agent-notes/plans/<slug>.md` (Goal, Approach, Alternatives, Files anticipated, Test plan, Acceptance criteria). Slug matches the task note.
8
14
2. Copy `agent-notes/0000-00-00-00-task-template.md` to `agent-notes/YYYY-MM-DD-NN-<slug>.md`. **Always.** No skip-step.
9
15
3. Fill all sections from the work just done. Size scales with task; trivial tasks get short notes.
10
16
4. Run verification per AGENTS.md, fill `## Verification` with results.
11
-
5. Hand back with a one-line summary and a pointer to the note file.
17
+
5. Commit the work. Add a `Co-authored-by: opencode <noreply@opencode.ai>` trailer to the commit message. The human is the author; the trailer credits agent assistance.
18
+
6. Hand back with a one-line summary and a pointer to the note file.
12
19
13
20
## Rules
14
21
15
22
- Task notes are records, not scratchpads. Fill at end, not during.
16
23
- Plan files in `agent-notes/plans/` are write-only at task end. Do not read them as part of starting a task.
17
24
- AGENTS.md is always in context. Do not re-read it.
25
+
- All work happens on a feature branch, not `main`. PR + merge per AGENTS.md.
26
+
- The agent hands back at task end; it does not merge to `main`. The human reviews the PR and merges.
+9
-2
AGENTS.md
+9
-2
AGENTS.md
···
4
4
5
5
## Stack
6
6
7
-
SvelteKit · Cloudflare Pages + Workers · D1 + Drizzle · Vitest + Playwright · pnpm · stylebase + Bits UI · Storybook · Sentry + Axiom · OpenCode (primary) / Claude Code (fallback).
7
+
SvelteKit · Cloudflare Pages + Workers · D1 + Drizzle · Vitest + Playwright · pnpm · stylebase + Bits UI · Storybook.
8
+
9
+
## Git workflow
10
+
11
+
- Always branch from `main`. Pull latest `main` before creating the new branch.
12
+
- All tasks are reviewed in a pull request.
13
+
- The agent never pushes directly to `main` and never merges to `main`. The human reviews the PR and merges.
14
+
- The human is the commit author for all commits. Agent-made commits add a `Co-authored-by: opencode <noreply@opencode.ai>` trailer to credit assistance.
8
15
9
16
## Layout
10
17
···
29
36
30
37
## Task lifecycle
31
38
32
-
End-of-task skill: `.opencode/skills/task-lifecycle/SKILL.md`. Always create a task note in `agent-notes/`, regardless of task size. Size of note scales with task.
39
+
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.
33
40
34
41
## Guardrails
35
42
+32
agent-notes/2026-06-03-02-process-updates.md
+32
agent-notes/2026-06-03-02-process-updates.md
···
1
+
# process-updates
2
+
3
+
## Task
4
+
Update the Suede process layer with two changes: (1) introduce a Git workflow rule (branch from main, PR review, no direct pushes), (2) drop Sentry, Axiom, OpenCode, and Claude Code from the explicit stack mentions in AGENTS.md.
5
+
6
+
## Decisions
7
+
- New "## Git workflow" section in AGENTS.md covers the rule in three bullets: branch from main, PR review, no direct push. Kept terse — it's a guardrail, not a tutorial.
8
+
- Stack line trimmed to the technologies only; tools-that-were-decided and LLM-tooling dropped per user preference.
9
+
- Task-lifecycle skill expanded with a "## Before starting" section. The skill now covers both ends of a task — start (branch setup) and end (note + verification). Renamed the end-of-task section header to "## Steps at task end" for clarity.
10
+
- Branch name: `chore/process-updates`. Conventional-commits-ish prefix; user hasn't formalized a convention yet.
11
+
- **Refinement after first commit:** the Git workflow rule was made explicit — "The agent never pushes directly to `main` and never merges to `main`. The human reviews the PR and merges." Drops the previous ambiguous "Merge only after PR passes" wording. The agent hands back; merge is a human decision.
12
+
- **Refinement:** the task note ownership was made explicit in AGENTS.md's "Task lifecycle" section — "The agent owns the task note — create it at task end without being asked." Reinforced in the skill's Rules.
13
+
- **Refinement:** the human remains the commit author for all commits (including agent-made ones). Agent-made commits add a `Co-authored-by: opencode <noreply@opencode.ai>` trailer to credit assistance. The trailer format and commit step are now explicit in the skill's "Steps at task end" and the Git workflow section of AGENTS.md.
14
+
15
+
## Actions
16
+
- Created branch `chore/process-updates` from `main` (no remote configured yet, so `git pull` step skipped — main is the local source of truth).
17
+
- Edited `AGENTS.md`: removed "Sentry + Axiom · OpenCode (primary) / Claude Code (fallback)" from the Stack line; added a new "## Git workflow" section between Stack and Layout.
18
+
- Rewrote `.opencode/skills/task-lifecycle/SKILL.md`: added "## Before starting" with the branch-setup steps; renamed end-of-task section to "## Steps at task end"; added a "PR + merge per AGENTS.md" line to Rules.
19
+
20
+
## Files touched
21
+
- `AGENTS.md` — edited (stack line, added Git workflow section)
22
+
- `.opencode/skills/task-lifecycle/SKILL.md` — edited (added Before starting section)
23
+
- `agent-notes/2026-06-03-02-process-updates.md` — created (this note)
24
+
25
+
## Verification
26
+
- `git status` — clean working tree on `chore/process-updates`
27
+
- `git branch` — confirms we're on the feature branch, not main
28
+
- File content re-read on both edited files (during edit) — confirmed correct
29
+
30
+
## Follow-ups / stubs
31
+
- No git remote is configured yet. PR step is on the user: set a remote, push the branch, open the PR, merge after review. The bootstrap commit (`5a9fda9`) was made directly on `main` before this rule was in place — that's a one-time historical exception, not a pattern.
32
+
- Branch naming convention is not standardized. If the user wants a strict convention (e.g., `type/short-slug` from conventional commits), that's a future task.