geneseed 3.12.0 → 3.13.0

package/src/loops/spec-first-feature.json

@@ -0,0 +1,29 @@
+{
+  "name": "spec-first-feature",
+  "description": "Write the feature's spec first — specs/<slug>/spec.md with EARS acceptance criteria and an ordered task list — for the user to review, commit it, then build it task by task: apply, test, review. An independent done-check maps every criterion to a passing test before the loop closes.",
+  "category": "development",
+  "rules": [
+    "One spec task per iteration, in the spec's order.",
+    "Open questions in the spec wait for the user's answers; never answer them yourself."
+  ],
+  "nodes": ["spec", "identify", "apply", "test", "review", "done-check"],
+  "start": "spec",
+  "edges": [
+    { "from": "spec", "on": "pass", "to": "identify" },
+    { "from": "spec", "on": "fail", "to": "$stop" },
+    { "from": "identify", "on": "more", "to": "apply" },
+    { "from": "identify", "on": "done", "to": "done-check" },
+    { "from": "apply", "on": "pass", "to": "test" },
+    { "from": "test", "on": "pass", "to": "review" },
+    { "from": "test", "on": "fail", "to": "apply" },
+    { "from": "review", "on": "pass", "to": "identify" },
+    { "from": "review", "on": "fail", "to": "apply" },
+    { "from": "done-check", "on": "pass", "to": "$close" },
+    { "from": "done-check", "on": "fail", "to": "identify" }
+  ],
+  "loops": [
+    { "name": "iterations", "nodes": ["identify", "apply", "test", "review", "done-check"], "max": 20, "iteration": true },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 5 },
+    { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
+  ]
+}

package/src/loops/tdd.json

@@ -0,0 +1,25 @@
+{
+  "name": "tdd",
+  "description": "Plan the work, then build it test-first: each iteration writes a failing test, makes it pass, and reviews the diff, until the plan is complete.",
+  "category": "tests",
+  "nodes": ["plan", "identify", "red-test", "apply", "test", "review"],
+  "start": "plan",
+  "edges": [
+    { "from": "plan", "on": "pass", "to": "identify" },
+    { "from": "identify", "on": "more", "to": "red-test" },
+    { "from": "identify", "on": "done", "to": "$close" },
+    { "from": "red-test", "on": "red", "to": "apply" },
+    { "from": "red-test", "on": "green", "to": "test" },
+    { "from": "red-test", "on": "untestable", "to": "$stop" },
+    { "from": "apply", "on": "pass", "to": "test" },
+    { "from": "test", "on": "pass", "to": "review" },
+    { "from": "test", "on": "fail", "to": "apply" },
+    { "from": "review", "on": "pass", "to": "identify" },
+    { "from": "review", "on": "fail", "to": "apply" }
+  ],
+  "loops": [
+    { "name": "iterations", "nodes": ["identify", "red-test", "apply", "test", "review"], "max": 20, "iteration": true },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 5 },
+    { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
+  ]
+}

package/src/loops/update-contract.json

@@ -0,0 +1,33 @@
+{
+  "name": "update-contract",
+  "description": "Change an interface with live consumers — an API, a schema, an event — as expand, migrate one consumer per iteration, contract: plan it for the user to review, then apply, test, check old and new consumers, and review.",
+  "category": "architecture",
+  "rules": [
+    "Contract files (OpenAPI, AsyncAPI, protobuf, Avro, GraphQL schemas, Flyway and Liquibase migrations) stop for a human by default; a stop on one is expected, not a failure.",
+    "`geneseed loop init --contracts <globs>` appends more contract globs, and LOOP.md's `contracts` can be trimmed."
+  ],
+  "nodes": ["migration-plan", "identify", "apply", "test", "compat-check", "review"],
+  "start": "migration-plan",
+  "edges": [
+    { "from": "migration-plan", "on": "pass", "to": "identify" },
+    { "from": "migration-plan", "on": "fail", "to": "$stop" },
+    { "from": "identify", "on": "more", "to": "apply" },
+    { "from": "identify", "on": "done", "to": "$close" },
+    { "from": "apply", "on": "pass", "to": "test" },
+    { "from": "test", "on": "pass", "to": "compat-check" },
+    { "from": "test", "on": "fail", "to": "apply" },
+    { "from": "compat-check", "on": "pass", "to": "review" },
+    { "from": "compat-check", "on": "fail", "to": "apply" },
+    { "from": "review", "on": "pass", "to": "identify" },
+    { "from": "review", "on": "fail", "to": "apply" }
+  ],
+  "loops": [
+    { "name": "iterations", "nodes": ["identify", "apply", "test", "compat-check", "review"], "max": 20, "iteration": true },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 5 },
+    { "name": "review-fix", "nodes": ["apply", "test", "compat-check", "review"], "max": 3 }
+  ],
+  "contracts": [
+    "**/openapi*.yaml", "**/openapi*.yml", "**/openapi*.json", "**/asyncapi*.yaml", "**/*.proto", "**/*.avsc",
+    "**/*.graphqls", "**/*.graphql", "**/asyncapi*.yml", "**/asyncapi*.json", "**/db/migration/**", "**/db/changelog/**"
+  ]
+}

package/src/skills/brick-forge.md

@@ -32,7 +32,9 @@ that…".
    <4-10 lines of direct instructions, ending with exactly how to choose among the outcomes>
    ```
 
-   No double-brace tokens in the body: the loop hands it to the model raw.
+   No double-brace tokens in the body: the loop hands it to the model raw. If the brick finds
+   something the next brick needs, have it write that to a file in the OS temp directory and
+   report the path with the outcome — the loop skill records it as a note.
 3. **Overriding by name** — a project or global brick named like a shipped one replaces it in
    every template. That is allowed; say so to the user. `geneseed loop check` lists overrides under `overridden`.
 4. **Check it:** `geneseed loop check --brick <path>` (this file alone), then

package/src/skills/bruno-collection-generator.md

@@ -3,9 +3,9 @@
 > {{DESC_BRUNO_COLLECTION_GENERATOR}}
 
 **Trigger:** creating, converting, or reorganising a [Bruno](https://www.usebruno.com/)
-collection — requests, folders, environments, request docs — from backend routes, an
-OpenAPI snippet, pasted API docs, curl commands, or a plain endpoint list, as `.bru`
-files or OpenCollection YAML.
+collection as `.bru` files or OpenCollection YAML. The collection covers requests,
+folders, environments and request docs; the source can be backend routes, an OpenAPI
+snippet, pasted API docs, curl commands, or a plain endpoint list.
 
 ## Procedure
 1. Gather the inputs, and state every assumption you fill in ({{LAW:echo-the-intent}}): the source

package/src/skills/bruno-test-writer.md

@@ -3,9 +3,9 @@
 > {{DESC_BRUNO_TEST_WRITER}}
 
 **Trigger:** writing, reviewing, or strengthening tests for a [Bruno](https://www.usebruno.com/)
-request or collection — assertions, `tests` blocks, pre-request and post-response
-scripts, request chaining, schema checks, edge cases — in `.bru` files or
-OpenCollection YAML.
+request or collection in `.bru` files or OpenCollection YAML. Covers assertions, `tests`
+blocks, pre-request and post-response scripts, request chaining, schema checks, and
+edge cases.
 
 ## Procedure
 1. Understand the request or collection first: method, path, auth, body, headers,

package/src/skills/ci-fix.md

@@ -2,9 +2,9 @@
 
 > {{DESC_CI_FIX}}
 
-**Trigger:** a CI run, pipeline job, or pre-merge check is red — on a PR you opened, a
-branch you are on, or one the user points you at — or the user says "CI is failing",
-"fix the build", "why is the pipeline red". The [debug {{SKILL}}](debug.md) drives
+**Trigger:** a CI run, pipeline job, or pre-merge check is red, or the user says "CI is
+failing", "fix the build", "why is the pipeline red". The red run can be on a PR the agent
+opened, the branch it is on, or one the user points at. The [debug {{SKILL}}](debug.md) drives
 the root-causing once the failure reproduces locally; this {{SKILL}} gets it there and
 gets the fix back through the same gate.
 

package/src/skills/consolidate-memory.md

@@ -2,10 +2,10 @@
 
 > {{DESC_CONSOLIDATE_MEMORY}}
 
-**Trigger:** the {{MEMORY}} index has grown past what a session can usefully read
-(~40 lines), two entries say the same or opposite things, a memory names a file, flag,
-or command that no longer exists, a `feedback` lesson keeps recurring, or the user
-says "clean up memory", "consolidate", "what do you actually remember". Also worth a
+**Trigger:** the {{MEMORY}} index has outgrown one useful read (~40 lines) or holds
+duplicate, contradictory, or stale entries. Stale means a memory naming a file, flag, or
+command that no longer exists; a `feedback` lesson that keeps recurring counts too, as
+does the user saying "clean up memory", "consolidate", "what do you actually remember". Also worth a
 pass after a release or a large refactor, when many recorded facts just changed. The
 [rule {{SKILL}}](rule.md) writes one memory or one rule; this {{SKILL}} tends the
 whole set. The user's wiki is out of scope — that is the [wiki {{SKILL}}](wiki.md).

package/src/skills/council.md

@@ -2,7 +2,7 @@
 
 > {{DESC_COUNCIL}}
 
-**Trigger:** the user asks to "convene a council", "debate this", "argue both sides", "stress-test this decision", or wants a change, plan, or claim challenged from several points of view before committing to it.
+**Trigger:** the user asks to "convene a council", "debate this", or "argue both sides", or wants a decision stress-tested from several points of view. A change, plan, or claim all qualify, as long as it is challenged before committing to it.
 
 ## Procedure
 1. Frame the motion in one line — the exact decision, change, or claim under debate — and name what it feeds (a choice to make, a design to accept, a discussion to settle). Ground it in the real artifact and the project's own docs ({{DOCTRINE:read-the-docs-first}}) so the council argues the actual thing; if the motion is unclear or bundles several questions, split it and ask once, then proceed.

package/src/skills/fresh-eyes.md

@@ -2,7 +2,7 @@
 
 > {{DESC_FRESH_EYES}}
 
-**Trigger:** a task is claimed done and the solving session believes the artifact works — before merge or handoff, or when the user asks to "validate", "fresh eyes", "prove it meets the spec", "did this actually solve it", or "independent sign-off", and the cost of a confidently-wrong "done" is high. This re-judges the *result* from zero context — distinct from [geneseed-code-review](geneseed-code-review.md), which reviews a *diff* with full knowledge of the change. For an open-ended quality critique use [roast-me](roast-me.md); for a multi-stance debate over an undecided question use [council](council.md).
+**Trigger:** work is claimed done and needs a blind check against the original ask. That is before merge or handoff, while the solving session believes the artifact works, or when the user asks to "validate", "fresh eyes", "prove it meets the spec", "did this actually solve it", or "independent sign-off" — and the cost of a confidently-wrong "done" is high. This re-judges the *result* from zero context — distinct from [geneseed-code-review](geneseed-code-review.md), which reviews a *diff* with full knowledge of the change. For an open-ended quality critique use [roast-me](roast-me.md); for a multi-stance debate over an undecided question use [council](council.md).
 
 ## Procedure
 1. Capture the firewall input as TWO things and nothing else: (a) the **verbatim original task/spec** — the raw issue or request text, NOT a solver-written summary or "spec card" (a distilled card launders the solving session's framing into the rubric, the very bias this {{SKILL}} exists to defeat), and (b) a pointer to the **final artifact** as it stands — file paths, built output, or the command to run it. If the raw task is too thin to yield acceptance criteria, have the **user** (never the solver) confirm a one-line acceptance bar, then proceed ({{LAW:echo-the-intent}}); if it is too fuzzy even for that, this is a judgement call — convene [council](council.md) instead.

package/src/skills/git-archaeology.md

@@ -2,7 +2,7 @@
 
 > {{DESC_GIT_ARCHAEOLOGY}}
 
-**Trigger:** you need to learn something *from* the history — when a regression was
+**Trigger:** something must be learned *from* the history — when a regression was
 introduced, who last touched a line and why, or where a symbol or string entered the
 codebase. Read-only: this {{SKILL}} investigates, it does not change history (to repair
 or rewrite, use git-rescue.md; to write a new commit, use commit.md).

package/src/skills/git-rescue.md

@@ -2,9 +2,10 @@
 
 > {{DESC_GIT_RESCUE}}
 
-**Trigger:** the repository is in a broken or messy state — a bad rebase/merge/reset,
-lost commits, a detached HEAD, a half-finished operation, work stranded in a stash — or
-you intend to deliberately rewrite history (interactive rebase, squash, amend). For
+**Trigger:** commits are lost, a rebase/merge/reset went wrong, or history is to be
+deliberately rewritten (interactive rebase, squash, amend). The repository can also be
+messy in other ways: a detached HEAD, a half-finished operation, or work stranded in a
+stash. For
 finding *when/why* something changed without altering history, use git-archaeology.md.
 
 ## Procedure

package/src/skills/handoff.md

@@ -2,7 +2,7 @@
 
 > {{DESC_HANDOFF}}
 
-**Trigger:** the context window is filling, a session is ending mid-task, or you're passing work to another agent or developer.
+**Trigger:** the context window is filling, a session is ending mid-task, or work is passing to another agent or developer.
 
 ## Procedure
 1. Capture the state in the worklog (`WORKLOG.md` or the task's plan file): the goal, what's done, the step in progress, and the exact next step.

package/src/skills/herdr.md

@@ -4,7 +4,7 @@
 > {{DESC_HERDR}}
 <!-- invocation: user -->
 
-**Trigger:** you are running inside a herdr-managed pane (`HERDR_ENV=1`) and a task would benefit from another pane — splitting off a server, watching a long-running build, spawning a sibling agent, or reading what a neighbour is doing. If `HERDR_ENV` is unset or not `1`, you are not inside herdr — stop and do not try to control panes from outside.
+**Trigger:** the session runs inside a herdr-managed pane (`HERDR_ENV=1`) and a task would benefit from another pane. Typical cases: splitting off a server, watching a long-running build, spawning a sibling agent, or reading what a neighbour is doing. If `HERDR_ENV` is unset or not `1`, you are not inside herdr — stop and do not try to control panes from outside.
 
 **Requires:** `HERDR_ENV=1` in the environment and the `herdr` binary on `PATH`.
 

package/src/skills/learn-mode.md

@@ -4,8 +4,8 @@
 
 <!-- invocation: user -->
 
-**Trigger:** the user wants to *learn while building* rather than be handed finished code —
-"learn mode", "turn on learning", "I want to understand what we build", "let me design it,
+**Trigger:** the user wants to *learn while building* rather than be handed finished code.
+Phrases: "learn mode", "turn on learning", "I want to understand what we build", "let me design it,
 you write it". Also "pause learning" / "resume learning" / "stop learn mode". To be taught a
 topic outside a build, use the [teach {{SKILL}}](teach.md); to have knowledge tested, the
 [quiz {{SKILL}}](quiz.md).

package/src/skills/loop.md

@@ -4,7 +4,9 @@
 
 **Trigger:** the user asks to run a loop, or to work a requirement in small validated
 iterations, each one committed on its own; or names a loop template (`bugfix`, `refactor`,
-`feature`).
+`feature`, `tdd`, `legacy-tests`, `legacy-refactor`, `deps-upgrade`, `ci-repair`,
+`architecture-decision`, `enforce-architecture-rule`, `update-contract`, `spec-first-feature`,
+`api-endpoint`, `remove-dead-code`, `fix-flaky-tests`).
 
 Default trust preset: **{{TRUST_LABEL}}**
 
@@ -36,7 +38,8 @@ action prints one JSON object — act on its keys, never on your own reading of
    Write it to `<name>.json` in the OS temp directory — never inside the worktree, where it would
    be scored and committed — and validate it: `geneseed loop check --graph <file>`.
 4. `geneseed loop init --title "<title>" --requirement "<requirement>" --graph <template|file> --preset {{TRUST}}`.
-   A refused graph prints `problems` — fix them and retry.
+   Add `--contracts <globs>` naming the interface or schema files the requirement changes when
+   the template's defaults do not cover them. A refused graph prints `problems` — fix them and retry.
 
 ## The cycle
 
@@ -44,17 +47,25 @@ Repeat `geneseed loop next` and act on its JSON:
 
 - **`{awaiting}`** — a person must decide. Present it: `launch` → the graph in `LOOP.md`;
   `declared` → the card, its score and the threshold; `actual` → `git diff --cached` and the
-  `reasons`. Then **end the run** and wait. On their answer:
+  `reasons`; `gate` → what `node` produced (the file its `note` names, or `git diff`), the
+  `note` and the `outcome` it reported — `ok` follows the outcome the brick reported (on a held
+  `fail` it stops; to continue, `amend` with your answers), `amend` re-runs that brick with their
+  note. Then
+  **end the run** and wait. On their answer:
   `geneseed loop decide --verdict ok|no|amend --note "<their words>"` and continue.
 - **`{verify, run}`** — run exactly the `run` command it prints.
 - **`{node, validate: true}`** — score the card before the brick runs:
-  `geneseed loop score --declared` (the card `identify` recorded), or for a setup brick with no
-  card `geneseed loop score --declared --actions <kinds> --write-set <files> --intent <label>`.
+  `geneseed loop score --declared` (the card the iteration head recorded), or for a setup brick with no
+  card `geneseed loop score --declared --actions <kinds> --write-set <files> --intent <label>`
+  (`spec`: `--actions new-file --write-set 'specs/**'`).
+  Single-quote any glob in `--write-set` (safe in bash and PowerShell; unquoted, the shell expands it).
   `blocking` turns into an `{awaiting}` on the next `next`.
 - **`{node}`** — run the brick: dispatch its `agent` (or follow its `skill`) with the `prompt`,
-  the `card` and the `notes`. Then report the outcome, one of its `outcomes`:
-  `git status --porcelain | geneseed loop record --outcome <outcome>` — `identify` adds
-  `--card '<card json>'` when it reports `more`.
+  the `card`, the `notes` and the template's `rules`. Then report the outcome, one of its `outcomes`:
+  `git status --porcelain | geneseed loop record --outcome <outcome>` — the iteration head
+  (`identify`, `upgrade-scout`, `ci-triage`) adds `--card '<card json>'` when it reports `more`;
+  a brick that reports a note file's path gets `--note-file <path>`, so its finding lands in
+  `notes`; `--note "<short, one line, no git command>"` only for a note you write yourself.
 - **`{terminal: "$close"}`** — see *The end*. **`{terminal: "$stop"}`** — report the `reason`
   and the `summary`, and leave the branch as it is.
 
@@ -69,8 +80,9 @@ What `score --diff`, `decide` and `record` print back:
   keeping `LOOP.md`: `git stash -u -m loop-discarded -- . :^LOOP.md` (never `git stash push` —
   the word `push` trips the git gate mid-run).
 - **`{done: true}`**, **`{empty}`**, **`{resumed}`**, **`{dropped}`**, **`{node}`**, **`{verify}`**,
-  **`{stopped}`**, a declared score, and any result with `commit: false` (a blocking diff score
-  included — it surfaces as `{awaiting}`) — call `next` again.
+  **`{awaiting}`** (a gate), **`{stopped}`**, a declared score, and any result with
+  `commit: false` (a blocking diff score included — it surfaces as `{awaiting}`) — call `next`
+  again.
 - **`{error}`** — read it; it names the step you skipped (`score --declared` before a mutate
   brick, `score --diff` before `record`). Do the step, never edit the state block to get past it.
   An `{error}` from `record` that mentions JSON means the shell mangled the card's quotes: retry

package/src/skills/opencode-theme.md

@@ -3,9 +3,9 @@
 > {{DESC_THEME}}
 <!-- invocation: user -->
 
-**Trigger:** the user wants their own OpenCode colour theme — "make me a theme",
-"create a custom theme", "I want my own colours", "a theme that matches <brand>", "a
-darker/transparent version of <theme>", or asks to tweak the shipped colours. For
+**Trigger:** the user wants their own OpenCode colour theme, or asks to tweak the shipped
+colours. Phrases: "make me a theme", "create a custom theme", "I want my own colours", "a
+theme that matches my brand", "a darker/transparent version of this theme". For
 changing the agent's *voice* (imperial, pirate…) that is a different concept — point
 them at `--theme` / the setup wizard, not this {{SKILL}}.
 

package/src/skills/ponytail.md

@@ -2,7 +2,7 @@
 
 > {{DESC_PONYTAIL}}
 
-**Trigger:** the user says "ponytail", "be lazy", "lazy mode", "simplest/minimal solution", "yagni", "do less", or "shortest path", or complains about over-engineering, bloat, boilerplate, or needless dependencies. Sets a build *mode* that persists across the session, not a one-shot edit — off by default until invoked. Off again on "stop ponytail" / "normal mode". For restructuring code that already exists use [refactor](refactor.md); to critique an artifact use [roast-me](roast-me.md).
+**Trigger:** the user says "ponytail", "be lazy", "lazy mode", "yagni" or "do less", or complains about over-engineering, bloat, or needless dependencies. Also "simplest/minimal solution", "shortest path", or a complaint about boilerplate. Sets a build *mode* that persists across the session, not a one-shot edit — off by default until invoked. Off again on "stop ponytail" / "normal mode". For restructuring code that already exists use [refactor](refactor.md); to critique an artifact use [roast-me](roast-me.md).
 
 ## Procedure
 1. Set the intensity. Ponytail is **off by default**; invoking it turns it on at **full** unless a level is named. **lite** — build what's asked, name the lazier alternative in one line, user picks. **full** — the ladder enforced, shortest diff, shortest explanation. **ultra** — YAGNI extremist, ship the one-liner and challenge the rest of the requirement in the same breath. Switch any time with `/ponytail lite|full|ultra|off` (on OpenCode this command persists the level for the geneseed-ponytail plugin; `off` stops it).

package/src/skills/profile.md

@@ -2,10 +2,9 @@
 
 > {{DESC_PROFILE}}
 
-**Trigger:** the user wants the agent to know who they are — "set up my profile",
-"create my profile", "update my profile" — a fresh install whose `PROFILE.md` is
-still the untouched stub, or an existing profile visibly contradicts how the user
-now works.
+**Trigger:** the user wants the agent to know who they are, or `PROFILE.md` is still
+the untouched stub. Phrases: "set up my profile", "create my profile", "update my
+profile". Also when an existing profile visibly contradicts how the user now works.
 
 ## Procedure
 1. Locate `PROFILE.md` beside the deployed AGENT.md and read it ({{LAW:verify-before-asserting}} — the

package/src/skills/prose.md

@@ -2,9 +2,8 @@
 
 > {{DESC_PROSE}}
 
-**Trigger:** about to hand a human written prose — a commit body, PR description,
-doc, code comment, {{MEMORY}} note, or a written reply — and it should read like a
-person wrote it, not a model.
+**Trigger:** about to hand a human written prose (a commit body, PR description, doc,
+code comment, {{MEMORY}} note, or reply) that should read as a person's, not a model's.
 
 ## Procedure
 1. Draft for content first, fix voice on a second pass — don't self-censor while

package/src/skills/quiz.md

@@ -4,7 +4,7 @@
 
 <!-- invocation: user -->
 
-**Trigger:** the user wants what they know *tested*, not explained — "drill me on X",
+**Trigger:** the user wants what they know *tested*, not explained. Phrases: "drill me on X",
 "quiz me until it sticks", "let me explain X to you and catch me", "I think I already
 know X, prove me wrong", "find the holes in what I know". Three shapes, picked from the
 ask: a **drill** (practise until reflex), a **feynman** (explain it back, get caught on

package/src/skills/react-view-transitions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: react-view-transitions
-description: Guide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.
+description: Guide for implementing smooth, native-feeling animations using React's View Transition API (`ViewTransition` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.
 license: MIT
 metadata:
   author: vercel

package/src/skills/react-view-transitions/VENDOR.md

@@ -1,6 +1,6 @@
 # Vendored skill — react-view-transitions
 
-This folder is a third-party skill vendored **verbatim** (one line aside, below) into Geneseed, not a
+This folder is a third-party skill vendored **verbatim** (two lines aside, below) into Geneseed, not a
 Geneseed-authored skill. It rides along in the rendered bundle and is exempt from
 Geneseed's authoring gates (token, dead-link, hermeticity, skill counts) — it is
 listed in the generator's `VENDORED_SKILL_DIRS`.
@@ -15,13 +15,18 @@ listed in the generator's `VENDORED_SKILL_DIRS`.
 The skill follows the [Agent Skills](https://agentskills.io/) format (`SKILL.md` +
 `references/`). Its internal links point at the upstream project's own files; do not
 "fix" them to Geneseed paths — that is why the folder is gate-exempt. To update,
-re-copy the upstream folder, re-apply the one deviation below, and bump the commit above.
+re-copy the upstream folder, re-apply the two deviations below, and bump the commit above.
 
-**The one deviation:** upstream's frontmatter says `name: vercel-react-view-transitions`;
+**Deviation 1:** upstream's frontmatter says `name: vercel-react-view-transitions`;
 here it is `name: react-view-transitions`. The Agent Skills format requires the name to
 match the skill's folder, and a strict host skips a skill that breaks it —
 renaming the folder instead would rename the installed skill on every host.
 
+**Deviation 2:** upstream's `description:` writes the component as `` `<ViewTransition>` ``;
+here it is `` `ViewTransition` ``. The Agent Skills spec forbids XML tags in a description, and
+`checkBuild`'s description arm reports one for every first-party skill — the tag would be the
+only one left in any install's catalogue.
+
 **Deliberately not copied:** upstream's `README.md` (the repo-facing readme: install
 command and folder tree, nothing an agent reads). `AGENTS.md`, upstream's compiled
 all-in-one copy, IS kept — `SKILL.md`'s closing section points the agent at it.

package/src/skills/research.md

@@ -2,9 +2,9 @@
 
 > {{DESC_RESEARCH}}
 
-**Trigger:** a question needs current, external, or wide-ranging information that is
-not in this repository or your own knowledge — facts to gather and verify from the
-open web.
+**Trigger:** a question needs current, external, or wide-ranging facts that are neither
+in this repository nor in the model's own knowledge. They are gathered and verified from
+the open web.
 
 **Requires:** a host web-search or web-fetch capability ({{DOCTRINE:tool-discovery}}) — without one,
 stop and report it ({{LAW:surface-failures}}); never substitute recall for verified research.

package/src/skills/review-response.md

@@ -2,8 +2,8 @@
 
 > {{DESC_REVIEW_RESPONSE}}
 
-**Trigger:** you have received review feedback — from a human or another agent — and
-are about to act on it.
+**Trigger:** review feedback has arrived — from a human or another agent — and is about
+to be acted on.
 
 ## Procedure
 1. Read every comment in full before changing anything. Group related comments.

package/src/skills/rule.md

@@ -2,9 +2,9 @@
 
 > {{DESC_RULE}}
 
-**Trigger:** anything the user wants to outlive this session — a standing rule of
-their own ("always…", "never…", "from now on…", "make that a rule") or a durable
-fact ("remember that…", "note that…", "keep in mind…"). Also fires when a
+**Trigger:** the user says "always…", "never…", "from now on…" or "remember that…".
+Anything the user wants to outlive this session counts: a standing rule ("make that a
+rule") or a durable fact ("note that…", "keep in mind…"). Also fires when a
 `feedback` {{MEMORY}} lesson keeps recurring and deserves promotion, or when
 `user-rules.md` needs review — a trial rule past its date, a stale rule, a bloated
 set. Nothing reaches `user-rules.md` or {{MEMORY}} except through here ({{DOCTRINE:persist-insight}}).

package/src/skills/security-audit.md

@@ -2,10 +2,10 @@
 
 > {{DESC_SECURITY_AUDIT}}
 
-**Trigger:** a change touches the security surface — authentication, authorisation,
-session or token handling, input from outside the trust boundary, file or shell
-access, cryptography, secrets, a new dependency, a network-facing endpoint — or the
-user asks for a "security review", "threat model", or "is this safe". The
+**Trigger:** a change touches the security surface, or the user asks for a "security
+review", "threat model", or "is this safe". The surface: authentication, authorisation,
+session or token handling, input from outside the trust boundary, file or shell access,
+cryptography, secrets, a new dependency, a network-facing endpoint. The
 [geneseed-code-review {{SKILL}}](geneseed-code-review.md) reviews a diff for
 correctness first; this one asks a different question of the same diff: *how would
 this be attacked, and what does it leak*. Run both before shipping anything on the

package/src/skills/teach.md

@@ -4,7 +4,7 @@
 
 <!-- invocation: user -->
 
-**Trigger:** the user wants to *learn* something and asks you to teach — "teach me X",
+**Trigger:** the user wants to *learn* something and asks to be taught. Phrases: "teach me X",
 "get me up to speed on X", "this is confusing, break it down", "explain this passage",
 "how do I get to X in N days". Three shapes, picked from the ask: a **crash course**
 (from zero to functional, fast), a **decode** (confusing material handed over, make it

package/src/skills/wiki.md

@@ -2,9 +2,9 @@
 
 > {{DESC_WIKI}}
 
-**Trigger:** a task needs knowledge the user keeps in their machine-wide
-knowledge base (declared in `wiki.jsonc`, AGENT.md §8), or the work has produced
-a durable, cross-project fact worth writing back into it.
+**Trigger:** a task needs the user's machine-wide knowledge base, or has produced a
+durable cross-project fact worth writing back. The knowledge base is declared in
+`wiki.jsonc` (AGENT.md §8).
 
 ## Procedure
 

package/src/skills/workflow.md

@@ -2,10 +2,10 @@
 
 > {{DESC_WORKFLOW}}
 
-**Trigger:** a task that benefits from *deterministic* multi-agent orchestration — a
-fan-out across independent units, a staged find→verify pipeline, a fresh-context
-handoff between phases, or a loop that accumulates to a target — **and** the host
-exposes a workflow tool. When it does not, use [parallel-agents](parallel-agents.md)
+**Trigger:** a task benefits from *deterministic* multi-agent orchestration **and** the
+host exposes a workflow tool. The shapes: a fan-out across independent units, a staged
+find→verify pipeline, a fresh-context handoff between phases, or a loop that accumulates
+to a target. When the host has no workflow tool, use [parallel-agents](parallel-agents.md)
 or [council](council.md) instead — those are *model-driven*; this {{SKILL}} is
 *code-driven*.
 

package/src/skills/worktree.md

@@ -2,8 +2,8 @@
 
 > {{DESC_WORKTREE}}
 
-**Trigger:** work must not share a working tree with what is already in flight — a
-[pipeline](pipeline.md) crew needs its own tree, a second task starts while the first
+**Trigger:** the user says "worktree" or "isolate this", or work must not share the
+checkout with work in flight. That covers a [pipeline](pipeline.md) crew needing its own tree, a second task starts while the first
 is uncommitted, another agent or session is editing this checkout, a risky migration
 or rewrite needs a disposable copy, or the user says "worktree", "isolate this",
 "don't touch my checkout". Also the first thing to reach for when `git status` shows

package/web/dist/assets/Activity-Ca2Aruu7.js

@@ -0,0 +1 @@
+import{r as e}from"./rolldown-runtime-hePW80VL.js";import{i as t,t as n}from"./react-Bbzhmq4v.js";import{t as r}from"./api-D_ixdyEY.js";import{J as i,N as a,k as o,l as s,y as c}from"./index-CMPgezFm.js";import{a as l,i as u,n as d,o as f,r as p,t as m}from"./activity-CObqyxkL.js";import{t as h}from"./usePoll-BOqeunzF.js";var g=e(t(),1),_=n();function v({s:e}){let t=p[e.status]||p.idle,n=e.files,r=e.todos,i=r&&r.total>0||e.error||e.blocked_on;return(0,_.jsxs)(`a`,{className:`card pad-md act-card`,href:`#/activity/${encodeURIComponent(e.session_id)}`,children:[(0,_.jsxs)(`div`,{className:`row between wrap gap-12`,children:[(0,_.jsxs)(`div`,{className:`row gap-10`,style:{minWidth:0},children:[(0,_.jsx)(`span`,{className:`feed-dot ${t.cls||`acc`}`,style:{width:9,height:9}}),(0,_.jsxs)(`div`,{style:{minWidth:0},children:[(0,_.jsx)(`h3`,{style:{margin:0},children:e.title||l(e.cwd)||e.session_id}),e.cwd&&(0,_.jsx)(`div`,{className:`dim mono`,style:{fontSize:12,...m},title:e.cwd,children:e.cwd})]})]}),(0,_.jsxs)(`div`,{className:`row gap-8`,style:{flexShrink:0},children:[e.model&&(0,_.jsx)(`span`,{className:`badge mono`,title:`model`,children:e.model}),e.agent&&(0,_.jsx)(`span`,{className:`badge`,children:e.agent}),(0,_.jsxs)(`span`,{className:`badge ${t.cls}`,children:[(0,_.jsx)(`span`,{className:`dot`}),t.label]}),(0,_.jsx)(o,{name:`chevron`,className:`glyph act-chev`})]})]}),e.phase&&(0,_.jsxs)(`div`,{className:`row gap-8`,style:{marginTop:10,fontSize:14},children:[(0,_.jsx)(o,{name:`activity`}),(0,_.jsx)(`span`,{style:m,children:e.phase})]}),(e.tokens>0||e.cost>0||e.turn_started_at||n&&n.count>0)&&(0,_.jsxs)(`div`,{className:`row wrap`,style:{gap:16,marginTop:12,fontSize:13,color:`var(--text-2)`},children:[e.tokens>0&&(0,_.jsxs)(`span`,{children:[f(e.tokens),` tok`]}),e.cost>0&&(0,_.jsxs)(`span`,{children:[`$`,e.cost.toFixed(2)]}),e.turn_started_at?(0,_.jsx)(`span`,{children:(0,_.jsx)(d,{startedAt:e.turn_started_at})}):null,n&&n.count>0&&(0,_.jsxs)(`span`,{children:[n.count,` file`,n.count===1?``:`s`,` `,(0,_.jsxs)(`span`,{style:{color:`var(--good)`},children:[`+`,n.additions]}),` `,(0,_.jsxs)(`span`,{style:{color:`var(--bad)`},children:[`−`,n.deletions]})]})]}),i&&(0,_.jsxs)(`div`,{className:`row between wrap gap-12`,style:{marginTop:12,paddingTop:10,borderTop:`1px solid var(--line)`},children:[r&&r.total>0?(0,_.jsxs)(`span`,{className:`row gap-8 dim`,style:{fontSize:13},children:[(0,_.jsx)(u,{done:r.done,total:r.total}),`plan `,r.done,`/`,r.total]}):(0,_.jsx)(`span`,{}),e.error?(0,_.jsx)(`span`,{className:`badge bad`,title:e.error,style:{maxWidth:300,...m},children:e.error}):e.blocked_on?(0,_.jsx)(`span`,{className:`badge bad`,title:e.blocked_on,style:{maxWidth:300,...m},children:e.blocked_on}):null]}),(0,_.jsxs)(`div`,{className:`dim mono`,style:{fontSize:11,marginTop:8},children:[`updated `,a(e.updated_at),` ago`]})]})}function y(){let[e,t]=(0,g.useState)(null),[n,a]=(0,g.useState)(``);h(e=>r.activity().then(n=>{e()&&(t(n),a(``))},t=>{e()&&a(t.message)}),2e3,[]);let o=!e||e.enabled!==!1,l=e?.activity||[],u=i(),d=async()=>{let e=!o;try{let n=await r.activityToggle(e);t(e=>({...e||{},enabled:n.enabled,activity:n.enabled&&e?.activity||[]})),a(``)}catch(e){a(e.message)}};return(0,_.jsxs)(`div`,{className:`narrow`,children:[(0,_.jsxs)(`div`,{className:`head-row mb-16`,children:[(0,_.jsxs)(`div`,{children:[(0,_.jsx)(`h1`,{className:`h`,children:`Activity`}),(0,_.jsx)(`p`,{className:`sub`,children:`Live OpenCode sessions this harness is running: what each one is doing right now. Refreshes every couple of seconds; sessions drop off when their process exits.`})]}),(0,_.jsxs)(`div`,{className:`row gap-10`,style:{alignItems:`center`,flexShrink:0},children:[(0,_.jsx)(`span`,{className:`dim mono`,style:{fontSize:12},children:o?`tracking on`:`tracking off`}),(0,_.jsx)(`div`,{className:`sw-toggle${o?` on`:``}`,role:`switch`,"aria-checked":o,"aria-label":`Toggle activity tracking`,tabIndex:0,onClick:d,onKeyDown:e=>{(e.key===`Enter`||e.key===` `)&&(e.key===` `&&e.preventDefault(),d())}})]})]}),(0,_.jsx)(s,{error:n,style:{marginBottom:12}}),e?o?l.length===0?(0,_.jsxs)(`div`,{className:`empty`,children:[(0,_.jsx)(`div`,{className:`big`,children:`No active sessions`}),`Run `,(0,_.jsx)(`code`,{children:`opencode`}),` and the sessions it spins up appear here.`]}):(0,_.jsx)(`div`,{className:`stack gap-12`,ref:u,children:l.map(e=>(0,_.jsx)(`div`,{"data-flip":e.session_id,children:(0,_.jsx)(v,{s:e})},e.session_id))}):(0,_.jsxs)(`div`,{className:`empty`,children:[(0,_.jsx)(`div`,{className:`big`,children:`Activity tracking is off`}),`The plugin isn't recording sessions. Flip the switch to turn it back on.`]}):(0,_.jsx)(c,{label:`Reading live sessions…`})]})}export{y as default};

package/web/dist/assets/ActivityDetail-Bo7v4Z_r.js

@@ -0,0 +1 @@
+import{r as e}from"./rolldown-runtime-hePW80VL.js";import{i as t,t as n}from"./react-Bbzhmq4v.js";import{t as r}from"./api-D_ixdyEY.js";import{N as i,k as a,y as o}from"./index-CMPgezFm.js";import{a as s,n as c,o as l,r as u,t as d}from"./activity-CObqyxkL.js";import{t as f}from"./usePoll-BOqeunzF.js";var p=e(t(),1),m=n();function h(e){return e.kind===`tool`?e.status===`error`?`bad`:e.status===`completed`?`ok`:`acc`:{retry:`warn`,error:`bad`,subtask:`acc`,text:`acc`}[e.kind]||``}function g({rec:e}){let t=e.who===`you`,n=[];t||(e.kind===`tool`&&e.ms!=null&&n.push(`${(e.ms/1e3).toFixed(1)}s`),e.kind===`step`&&(e.tokens&&n.push(`${l(e.tokens)} tok`),e.cost&&n.push(`$${e.cost.toFixed(2)}`)),e.kind===`subtask`&&e.agent&&n.unshift(e.agent));let r=!t&&(e.kind===`text`||e.kind===`thinking`||e.kind===`step`),i=t?e.text:e.label||e.snippet||e.kind;return(0,m.jsxs)(`div`,{className:`row gap-10`,style:{alignItems:`baseline`},children:[(0,m.jsx)(`span`,{className:`badge ${t?``:`acc`}`,style:{flexShrink:0,minWidth:52,justifyContent:`center`},children:t?`you`:`agent`}),(0,m.jsxs)(`div`,{style:{minWidth:0,flex:1,fontSize:13},children:[!t&&(0,m.jsx)(`span`,{className:`feed-dot ${h(e)||`acc`}`,style:{display:`inline-block`,marginRight:8,verticalAlign:`middle`}}),e.kind===`thinking`&&(0,m.jsx)(`span`,{className:`dim`,children:`thinking: `}),r?(0,m.jsx)(`span`,{className:`dim`,children:i}):t?i:(0,m.jsx)(`b`,{children:i}),e.error&&(0,m.jsxs)(`span`,{className:`dim`,children:[`: `,e.error]})]}),n.length>0&&(0,m.jsx)(`span`,{className:`dim mono`,style:{flexShrink:0,fontSize:12},children:n.join(` · `)})]})}function _({turns:e}){return!e||e.length===0?(0,m.jsx)(`div`,{className:`dim`,style:{fontSize:13},children:`No conversation captured yet.`}):(0,m.jsx)(`div`,{className:`stack gap-12`,children:e.map((e,t)=>{let n=e.role===`user`;return(0,m.jsxs)(`div`,{className:`row gap-10`,style:{alignItems:`baseline`},children:[(0,m.jsx)(`span`,{className:`badge ${n?``:`acc`}`,style:{flexShrink:0,minWidth:52,justifyContent:`center`},children:n?`you`:`agent`}),(0,m.jsx)(`div`,{style:{minWidth:0,fontSize:13,color:n?`inherit`:`var(--text-2)`},children:e.text})]},t)})})}function v({sid:e}){let[t,n]=(0,p.useState)(null),[h,v]=(0,p.useState)(``),[y,b]=(0,p.useState)(!1),[x,S]=(0,p.useState)(!1);f(t=>r.activityDetail(e).then(e=>{t()&&(n(e),v(``),b(!1))},e=>{t()&&(e.status===404?b(!0):v(e.message))}),2e3,[e]);let C=(0,m.jsxs)(`a`,{className:`btn ghost sm`,href:`#/activity`,style:{marginBottom:12,display:`inline-flex`,gap:6},children:[(0,m.jsx)(a,{name:`arrow`,style:{transform:`rotate(180deg)`}}),` Activity`]});if(y)return(0,m.jsxs)(`div`,{className:`narrow`,children:[C,(0,m.jsxs)(`div`,{className:`empty`,children:[(0,m.jsx)(`div`,{className:`big`,children:`Session ended`}),`It's no longer live. `,(0,m.jsx)(`a`,{href:`#/activity`,children:`Back to Activity`}),`.`]})]});if(!t)return(0,m.jsxs)(`div`,{className:`narrow`,children:[C,(0,m.jsx)(o,{label:`Loading session…`})]});let w=t.session,T=u[w.status]||u.idle,E=w.files,D=w.todos,O=!!(E&&E.items&&E.items.length>0),k=!!(D&&D.items&&D.items.length>0),A=t.conversation||[],j=t.timeline||[],M=[...A.filter(e=>e.role===`user`).map(e=>({who:`you`,text:e.text,t:e.t||0})),...j.map(e=>({...e,who:`agent`}))].sort((e,t)=>(e.t||0)-(t.t||0));return(0,m.jsxs)(`div`,{className:`narrow`,children:[C,h&&(0,m.jsx)(`p`,{className:`badge bad`,style:{marginBottom:12},children:h}),(0,m.jsxs)(`div`,{className:`card pad-md`,children:[(0,m.jsxs)(`div`,{className:`row between wrap gap-12`,children:[(0,m.jsxs)(`div`,{style:{minWidth:0},children:[(0,m.jsx)(`h1`,{className:`h`,style:{margin:0},children:w.title||s(w.cwd)||w.session_id}),w.cwd&&(0,m.jsx)(`div`,{className:`dim mono`,style:{fontSize:12,...d},title:w.cwd,children:w.cwd})]}),(0,m.jsxs)(`div`,{className:`row gap-8`,style:{flexShrink:0},children:[w.model&&(0,m.jsx)(`span`,{className:`badge mono`,children:w.model}),w.agent&&(0,m.jsx)(`span`,{className:`badge`,children:w.agent}),(0,m.jsxs)(`span`,{className:`badge ${T.cls}`,children:[(0,m.jsx)(`span`,{className:`dot`}),T.label]})]})]}),w.phase&&(0,m.jsxs)(`div`,{className:`row gap-8`,style:{marginTop:10,fontSize:14},children:[(0,m.jsx)(a,{name:`activity`}),(0,m.jsx)(`span`,{style:d,children:w.phase})]}),(0,m.jsxs)(`div`,{className:`row wrap`,style:{gap:16,marginTop:12,fontSize:13,color:`var(--text-2)`},children:[w.tokens>0&&(0,m.jsxs)(`span`,{children:[l(w.tokens),` tok`]}),w.cost>0&&(0,m.jsxs)(`span`,{children:[`$`,w.cost.toFixed(2)]}),w.turn_started_at?(0,m.jsx)(`span`,{children:(0,m.jsx)(c,{startedAt:w.turn_started_at})}):null,(0,m.jsxs)(`span`,{className:`dim`,children:[`updated `,i(w.updated_at),` ago`]})]}),(w.error||w.blocked_on)&&(0,m.jsx)(`div`,{style:{marginTop:10},children:(0,m.jsx)(`span`,{className:`badge bad`,style:{maxWidth:`100%`,...d},children:w.error||w.blocked_on})})]}),(O||k)&&(0,m.jsxs)(`div`,{className:`grid gap-12`,style:{marginTop:12,gridTemplateColumns:O&&k?`minmax(0, 1fr) minmax(0, 1fr)`:`1fr`},children:[O&&(0,m.jsxs)(`div`,{className:`card pad-md`,children:[(0,m.jsx)(`div`,{className:`card-head`,children:(0,m.jsxs)(`h3`,{children:[`Files touched `,(0,m.jsxs)(`span`,{className:`dim`,children:[`(`,E.count,`)`]})]})}),(0,m.jsx)(`div`,{className:`stack`,style:{gap:6,marginTop:8},children:E.items.map(e=>(0,m.jsxs)(`div`,{className:`row between gap-12`,style:{fontSize:13},children:[(0,m.jsx)(`span`,{className:`mono`,style:{...d,minWidth:0,flex:1},title:e.file,children:e.file}),(0,m.jsxs)(`span`,{style:{flexShrink:0},children:[(0,m.jsxs)(`span`,{style:{color:`var(--good)`},children:[`+`,e.additions]}),` `,(0,m.jsxs)(`span`,{style:{color:`var(--bad)`},children:[`−`,e.deletions]})]})]},e.file))})]}),k&&(0,m.jsxs)(`div`,{className:`card pad-md`,children:[(0,m.jsx)(`div`,{className:`card-head`,children:(0,m.jsxs)(`h3`,{children:[`Plan`,` `,(0,m.jsxs)(`span`,{className:`dim`,children:[`(`,D.done,`/`,D.total,`)`]})]})}),(0,m.jsx)(`div`,{className:`stack`,style:{gap:6,marginTop:8},children:D.items.map((e,t)=>(0,m.jsxs)(`div`,{className:`row gap-8`,style:{fontSize:13},children:[(0,m.jsx)(`span`,{className:`feed-dot ${e.status===`completed`?`ok`:e.status===`in_progress`?`acc`:``}`}),(0,m.jsx)(`span`,{style:{textDecoration:e.status===`completed`?`line-through`:`none`,color:e.status===`completed`?`var(--text-3)`:`inherit`},children:e.content})]},t))})]})]}),(0,m.jsxs)(`div`,{className:`card pad-md`,style:{marginTop:12},children:[(0,m.jsxs)(`div`,{className:`card-head`,style:{justifyContent:`space-between`,marginBottom:12},children:[(0,m.jsx)(`h3`,{children:`Timeline`}),j.length>0&&(0,m.jsx)(`button`,{className:`btn ghost sm`,onClick:()=>S(e=>!e),children:x?`Show conversation`:`Show all ${j.length} steps`})]}),x?(0,m.jsx)(`div`,{className:`stack gap-12`,children:M.map((e,t)=>(0,m.jsx)(g,{rec:e},t))}):(0,m.jsx)(_,{turns:A})]})]})}export{v as default};