chore(agents): add "Git workflow (every task)" rule to all agents + skills

Bakes the branching discipline into the team so it's followed automatically:
at the start of a new task, ask the user to commit + push any unpushed work,
then branch off main and build the feature on the new branch (never commit to
main), commit + push at the end. Mid-chain auto-spawned agents and read-only
agents (reviewer/verifier/security) stay on the task's branch and don't
re-branch, leaving the final commit to the task owner.

Appended one identical "## Git workflow (every task)" section to all 11
.claude/agents/*.md and all 11 .claude/skills/*/SKILL.md (22 files). Docs/
tooling only (.claude/ is not in the built app) — no version bump / CHANGELOG.

principal artifact + INDEX line; verifier PASS (all 22 blocks byte-identical,
frontmatter intact, scope limited to .claude + audit files, mid-chain clause
behaviorally sound).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VEsaHQx8cXr1hFrKU42UK6

.claude/agents/architect.md

@@ -26,3 +26,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/dba.md

@@ -29,3 +29,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/designer.md

@@ -28,3 +28,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/devops.md

@@ -31,3 +31,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/docwriter.md

@@ -23,3 +23,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/engineer.md

@@ -32,3 +32,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/principal.md

@@ -29,3 +29,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/reviewer.md

@@ -27,3 +27,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/security.md

@@ -31,3 +31,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/tester.md

@@ -26,3 +26,12 @@ task, what you changed, and your evidence (the commands you ran + their output).
 `VERDICT: REDO`, fix every listed gap and resubmit; only return once it returns `VERDICT: PASS`.
 There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `principal` to change approach, then keep going until PASS. Never skip this (`verifier`
 itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/agents/verifier.md

@@ -78,3 +78,12 @@ There is **no round cap** — hold the bar at *perfect for the task* and keep re
 progress**, add an `## Escalate: principal` note so principal can bring a different approach or
 specialist — that is to get the work unstuck and keep it moving toward PASS, **never** to give up
 or accept less than perfect.
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/architect/SKILL.md

@@ -29,3 +29,12 @@ before finalizing. Keep recommendations concrete — name the option you'd pick
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/dba/SKILL.md

@@ -30,3 +30,12 @@ server. Present schema diffs before applying. End with `## Next`.
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/designer/SKILL.md

@@ -29,3 +29,12 @@ visual direction, show the option and check in once. End with `## Next`.
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/devops/SKILL.md

@@ -31,3 +31,12 @@ user sign-off (deploy to the NAS is not a drive-by). End with `## Next`.
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/docwriter/SKILL.md

@@ -28,3 +28,12 @@ Keep **Time Machine**'s docs true (see `CLAUDE.md`).
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/engineer/SKILL.md

@@ -36,3 +36,12 @@ Trivial one-liner → just do it. Non-trivial → short plan, one check-in, exec
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/principal/SKILL.md

@@ -38,3 +38,12 @@ secrets, or deploy to the NAS without explicit sign-off. End with a summary + `#
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/reviewer/SKILL.md

@@ -28,3 +28,12 @@ secrets, or deploy — route those to `/dba`, `/security`, `/devops`. End with `
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/security/SKILL.md

@@ -30,3 +30,12 @@ Ranked findings (critical → minor), each with file:line, impact, and a fix own
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/tester/SKILL.md

@@ -30,3 +30,12 @@ End with `## Next`.
 Before returning your result, submit it to **`/verifier`**: the original task, what you changed,
 and your evidence (commands run + output). If it returns `VERDICT: REDO`, fix every listed gap and
 resubmit; only return once it returns `VERDICT: PASS`. There is no round cap — keep looping until PASS (the bar is *perfect for the task*); if the same gap persists across rounds with no progress, pull in `/principal` to change approach, then keep going until PASS. Never skip this (`/verifier` itself is exempt, to avoid recursion).
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.

.claude/skills/verifier/SKILL.md

@@ -68,3 +68,12 @@ full rubric. Read-only: return the job, never fix it. There is **no round cap**
 progress**, add `## Escalate: principal` so principal can change the approach — to get unstuck and
 continue toward PASS, never to give up. Hold the bar at *perfect for the task* — approve because
 it's right, not because it's close.
+
+## Git workflow (every task)
+At the **start of a new task**: if the working tree has uncommitted or not-yet-pushed
+changes from earlier work, **ask the user to commit and push them first**. Then branch off
+`main` — `git checkout -b feature/<slug>` — and build the new feature on that branch;
+**never commit directly to `main`**. Commit at the end and `git push -u origin <branch>`.
+If you were auto-spawned mid-chain, or are a read-only agent (e.g. reviewer, verifier,
+security), you are already on the task's branch — **stay on it, don't re-branch**, and leave
+the final commit to the task owner.