fullstack-agentic-flow 2.0.0

package/payload/commands/sequence.md

@@ -0,0 +1,22 @@
+Verify `.ai-agents/state/current-stage.md` shows `gate-1-approved`. If not, stop
+and tell the user to approve the contracts at Gate 1 first.
+
+Read the feature's **Tracks** value, then launch **in parallel**:
+
+| Agent | Instructions | Runs when |
+|-------|-------------|-----------|
+| 03a backend-sequence | `.ai-agents/agents/03a-backend-sequence.md` | tracks is `backend` or `both` |
+| 03b ui-sequence | `.ai-agents/agents/03b-ui-sequence.md` | tracks is `ui` or `both` |
+
+Both emit structured output through the `output_task_sequence` tool schema
+defined in their instructions. Do not accept free-text JSON — parse failures here
+are silent and corrupt the plan.
+
+Both append to `.ai-agents/state/current-plan.md` under their own headings.
+Neither may overwrite the dependency map or the other's section.
+
+There is no gate after sequencing. The human gate is the diff review after each
+commit.
+
+When both finish, tell the user to run `/implement` and name the first available
+task and its track.

package/payload/commands/status.md

@@ -0,0 +1,37 @@
+Print something the user can read in five seconds. Read
+`.ai-agents/state/current-stage.md` and `current-plan.md`, and run the project's
+version control to get recent history.
+
+## Format
+
+```
+FEATURE   {name} ({slug})          TRACKS  {backend | ui | both}
+STAGE     {stage}                  GATE    {open gate, or —}
+RISK      {L0–L3 — driving dimension, or "not assessed"}   TOPOLOGY  {from §1.1}
+
+BACKEND   ▓▓▓▓▓░░░░░  {n}/{total}   next: task {n} — {title}
+UI        ▓▓▓░░░░░░░  {n}/{total}   next: task {n} — {title}  [blocked on backend {n}]
+
+RECENT    {last 5 commits on the feature branch, one line each}
+
+TDD       {n} tests logged red → green this feature
+FLAGS     {critical findings, blockers, unresolved seam decisions, escapes — or "none"}
+
+NEXT      {the single command to run}
+NOTES     {changesets waiting for release: n in .ai-agents/changes/}
+```
+
+Omit a track's row entirely if the feature does not use it.
+
+If no architecture context exists, print only that, plus which command comes
+next: `/scaffold` when the repository is empty or holds only framework default
+output, `/bootstrap` when it has real code.
+
+If the stage is `scaffolded`, print the scaffold commits and remind the user that
+reviewing the backend and UI slice files is Gate A — those become the exemplars
+every future feature imitates.
+
+If no feature is in progress, print the stage as `idle` and point at `/intake`.
+
+Lead with flags when any exist. A blocked release matters more than progress
+bars.

package/payload/legacy/v1-checksums.json

@@ -0,0 +1,197 @@
+{
+  "pipelineVersion": "1.0.0",
+  "files": [
+    {
+      "path": ".ai-agents/agents/00-bootstrap.md",
+      "sha256": "2f3e7eac18ec20fe6767f8cd2bf6384f3fbe515dc9d671ed2f4e28cc054e6c85"
+    },
+    {
+      "path": ".ai-agents/agents/00a-scaffold.md",
+      "sha256": "79b473c723d3f2f6dd7c70fd7af5f91249f1f7ee438c670daf67a725b1d448ee"
+    },
+    {
+      "path": ".ai-agents/agents/01-intake.md",
+      "sha256": "51dd0e440faa4bdbe78d7aa2a3b0ed4976036eddc1cfe50ac7a985c302a6aac4"
+    },
+    {
+      "path": ".ai-agents/agents/02a-dependency-map.md",
+      "sha256": "e3de703cb82c5a5e23f8ab79e2c13a6f626322c83695c48c0d982d899b4e8433"
+    },
+    {
+      "path": ".ai-agents/agents/02b-backend-contract.md",
+      "sha256": "b7a254d006013cdbf8b092d5cefc8c96492b9d7ce67420ba560f1e313dc8f38f"
+    },
+    {
+      "path": ".ai-agents/agents/02c-ui-contract.md",
+      "sha256": "dc923be0349a20728c933eb5348b4787356c55bbef88fa72c0f76e5dfbbd9b64"
+    },
+    {
+      "path": ".ai-agents/agents/02d-api-seam.md",
+      "sha256": "c423e7a8e6681ff0af72acb38bddcbf19cf3b913ff269a19a4d90ab9f23c1789"
+    },
+    {
+      "path": ".ai-agents/agents/03a-backend-sequence.md",
+      "sha256": "ab2513b37e3172de4177827f1690c40c57b0ed91aaf3467e5d5a3161d1dc6c61"
+    },
+    {
+      "path": ".ai-agents/agents/03b-ui-sequence.md",
+      "sha256": "0b1e744a25ce638ade451a2e6a31f6101768fca8052e25ea0d1beccf330720fb"
+    },
+    {
+      "path": ".ai-agents/agents/04a-backend-implementer.md",
+      "sha256": "e409341695e802a7b0ba4c44bc4bd8d823817274113007857fa981eeaec17649"
+    },
+    {
+      "path": ".ai-agents/agents/04b-ui-implementer.md",
+      "sha256": "4bdb435cb7b13b6717dc5ea3c6279ebb904898627b232cd7558ccc5e08fd598f"
+    },
+    {
+      "path": ".ai-agents/agents/05-ci-validator.md",
+      "sha256": "ba9df6d8d09374a82e25a94f845b6f04031f7b0d32fae65944f6830619883ac8"
+    },
+    {
+      "path": ".ai-agents/agents/06-qa-spec.md",
+      "sha256": "355ffc652c40ad273f51bada47166cf4aca4b4594c9068e1cc01b2f4c6bb9530"
+    },
+    {
+      "path": ".ai-agents/agents/07-security.md",
+      "sha256": "733905a73a7692ce52737d57883f7903f864d05ac5b970b7a93dbce10b2db53a"
+    },
+    {
+      "path": ".ai-agents/agents/08-performance.md",
+      "sha256": "007f19afccc7247795a289be4d2e83dc860da15cfcfe1b6ca74ca99b3f1e061a"
+    },
+    {
+      "path": ".ai-agents/agents/09-changelog.md",
+      "sha256": "fd21d8aa74d728b0ef058a8659b2cd668e2eb79af348a3ceb3557309c17fc3cc"
+    },
+    {
+      "path": ".ai-agents/architecture-context.template.md",
+      "sha256": "995870dbf8f2d1045477e93cac576fbd7967279ed5758b9ac12f6881003dc23e"
+    },
+    {
+      "path": ".ai-agents/archive/README.md",
+      "sha256": "62c301e7409d6821cbc736705a760e3523aad98bf9491680f53d2778a7e15b69"
+    },
+    {
+      "path": ".ai-agents/state/README.md",
+      "sha256": "5643812da7396d994c88734a3bb4f419434e8ffd7f71510da543f96f66ec9c93"
+    },
+    {
+      "path": ".ai-agents/state/current-stage.md",
+      "sha256": "88c685cd71ca892facb07465f0d0afb8b5f89e52566be2f06147321f55f0d0e0"
+    },
+    {
+      "path": ".ai-agents/templates/README.md",
+      "sha256": "fbcd5d003f2e21dc4545042037262ca45466477ebd78fb617c55f06ef145cbb8"
+    },
+    {
+      "path": ".claude/agents/api-seam.md",
+      "sha256": "9766f84775d318d69ccc422d726464fe331c266f5632faefb5b7d48b81f2a3c5"
+    },
+    {
+      "path": ".claude/agents/backend-contract.md",
+      "sha256": "6a8ed62eb33f1544003d61dd8219e98a5451c64a404928f8e4620f054e728a84"
+    },
+    {
+      "path": ".claude/agents/backend-implementer.md",
+      "sha256": "38634b77a48814508f67750b05c3808e47b4964fa9e3ca04053846cf4bc96b9a"
+    },
+    {
+      "path": ".claude/agents/backend-sequence.md",
+      "sha256": "0ad71b64ec824412aef1e9851818b0c1e69f21300ac572e252a850a9c6a14e26"
+    },
+    {
+      "path": ".claude/agents/bootstrap.md",
+      "sha256": "8a278e1e0dab44e799cb5d41241d70816edc87a16c59dc32eb33d911127afbee"
+    },
+    {
+      "path": ".claude/agents/changelog.md",
+      "sha256": "0405e903816321a47f4a0536bc5e32c55bf09e0ebae932cbcd10951b8c1d70e6"
+    },
+    {
+      "path": ".claude/agents/dependency-map.md",
+      "sha256": "455e27c43df38fed8b6c4fdd48afd8e3db964fdb7500a862c1eb1a5a8e40edd1"
+    },
+    {
+      "path": ".claude/agents/intake.md",
+      "sha256": "74f90a4f5a66094c68da9875535af9d3ae5f277598e19e586f3ed95409b0e9ab"
+    },
+    {
+      "path": ".claude/agents/performance-review.md",
+      "sha256": "0bc9d2c953bbead0b55e010a2b9c660fb969e54bd4daea4f542057cd403ae828"
+    },
+    {
+      "path": ".claude/agents/qa-spec.md",
+      "sha256": "678c31146a1db230945846d54fd16784d91413b0bdc618dfe21d7b817bebb426"
+    },
+    {
+      "path": ".claude/agents/scaffold.md",
+      "sha256": "5fa89f80f02ad55d131021b7758767356bc510aedcce3b494768112f303532c8"
+    },
+    {
+      "path": ".claude/agents/security-review.md",
+      "sha256": "e2bee586b8e3aef56f28deddaba385352940943c614a5027775a4fb384dfbd1a"
+    },
+    {
+      "path": ".claude/agents/ui-contract.md",
+      "sha256": "fb8809b6262ada18b14f1e411ab6b26ee6a4b03cbbd8da447f2bdf9c848627fa"
+    },
+    {
+      "path": ".claude/agents/ui-implementer.md",
+      "sha256": "d573b37f0b4a040de48b190518f7ca4b37034843b8cecfe04d081ffb79e627a5"
+    },
+    {
+      "path": ".claude/agents/ui-sequence.md",
+      "sha256": "e003e7b7cd1bb815adeb30e846e3353231bcf1a73809989b8dbdaab9c89ded4e"
+    },
+    {
+      "path": ".claude/commands/bootstrap.md",
+      "sha256": "c06a853c9c6d6b543275a548cdb809a46b2e8343554c921c5583c5d6c0346b35"
+    },
+    {
+      "path": ".claude/commands/changelog.md",
+      "sha256": "37ca7d2dbf92c4482c71790e0a21873d014cf955c5b8a45d94c84fe502fbb632"
+    },
+    {
+      "path": ".claude/commands/contract.md",
+      "sha256": "41a3668f5f91b09aefc14fd73c81d2b6ab13467337103e69e1270136c183129d"
+    },
+    {
+      "path": ".claude/commands/implement.md",
+      "sha256": "923dbbbdca92a45ba1ae34aecc571ede340d59be6e9099325d1f140e43bb9615"
+    },
+    {
+      "path": ".claude/commands/intake.md",
+      "sha256": "d63e1b09579f50ee425ebdb1994adeafdb69f786d0a144407326ff237d84ce3f"
+    },
+    {
+      "path": ".claude/commands/perf.md",
+      "sha256": "e83cff08f98b3e153397d7ce67c5414fd7444b444084c36272cb43ec049e5291"
+    },
+    {
+      "path": ".claude/commands/qa.md",
+      "sha256": "b55b37d6b22b55a76d422f55f081665b05c2eb981fe6d5dd2bbaa1b2a6771457"
+    },
+    {
+      "path": ".claude/commands/resume.md",
+      "sha256": "dd4493ac5be7afd875af878a66591c485f871292a5677362bae87d70ecf7b347"
+    },
+    {
+      "path": ".claude/commands/scaffold.md",
+      "sha256": "b2b4429ccd03421a41f4c43dfccae5aa49421886a0dde0a266cee84a3949f062"
+    },
+    {
+      "path": ".claude/commands/security.md",
+      "sha256": "3a3e602839c98f3a7a1fbe5e3e2ac2a02d2548c857cffb3c7b8073c7e91838e4"
+    },
+    {
+      "path": ".claude/commands/sequence.md",
+      "sha256": "87d028af3bed4d17ce022d7e63f98e728291828ffe876d6412241a2d7a1a402e"
+    },
+    {
+      "path": ".claude/commands/status.md",
+      "sha256": "33c177d9cedbcdf60433237cd6f3ee6b68e7cabcb22147dbe8b0edbde581417c"
+    }
+  ]
+}

package/payload/root/contracts-README.md

@@ -0,0 +1,19 @@
+# Contracts
+
+Cross-repository interface contracts, one directory per feature slug:
+
+```
+contracts/{slug}/
+├── seam.md              the frozen seam, verbatim
+├── openapi.yaml | schema.graphql | …   machine-readable fragment
+└── VERSION              semver, timestamp, sha256 of the files above
+```
+
+- **Backend repositories** (`split-backend`) write these with `/seam export`
+  (agent 02d does it at Gate 1). They are a published interface: they stay
+  after the feature is released.
+- **Frontend repositories** (`split-frontend`) receive them with
+  `/seam import {path-or-url}` and never edit them. A missing field is a
+  counterpart request to the backend repository.
+
+CI verifies every `VERSION` checksum on each push.

package/payload/root/pipeline-section.md

@@ -0,0 +1,33 @@
+## Delivery pipeline (fullstack-agentic-flow)
+
+This repository uses a gated, multi-agent delivery pipeline. Its instructions
+live in `.ai-agents/`; this section only points at them.
+
+**Before any feature work**, read in this order:
+
+1. `.ai-agents/architecture-context.md` — this repository's topology, canon
+   mapping, conventions, and rules (written by `/bootstrap`)
+2. `.ai-agents/state/current-stage.md` — where the current feature is
+3. `.ai-agents/toolchain.md` — which skills to use, and what outranks what
+
+**Non-negotiable, in every task:**
+
+- **Test first.** Write the test, run it, see it fail for the stated reason,
+  then implement. Log red → green in `.ai-agents/state/tdd-log.md`.
+- **Typed data.** No untyped arrays, maps, `mixed`, or `any` across a boundary.
+  Named Data classes instead, even when that means many small ones
+  (`.ai-agents/canon/typed-data.md`).
+- **Canon placement.** Backend code goes in the layer
+  `.ai-agents/canon/backend-canon.md` and architecture-context §5.0 say.
+- **One task, one commit, then stop.** Never push; a human reviews every diff.
+- **Everything happens before the merge.** Impact verification, QA, security,
+  performance, the release note and the archive all land on the branch. Once it
+  merges, the feature is done.
+- **Stop rather than improvise** when a contract or the frozen seam is wrong.
+
+**Precedence when instructions conflict:** the human at a gate → pipeline state
+files → architecture context and canon → the agent file for this step →
+discipline skills (superpowers, ponytail, impeccable) → memory and graph recall.
+Memory and graphs are recall, never truth.
+
+Pipeline commands: