Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@
"name": "Christian Bager Bach Houmann",
"url": "https://github.com/chhoumann"
},
"description": "pstack for T3 Code: Lauren Tan's pstack rewritten in place for T3, with every subagent, panel, schedule, and PR watch dispatched through T3's orchestration so panels mix Claude, GPT, and Grok.",
"description": "pstack for T3 Code: Lauren Tan's pstack rewritten in place for T3, with every subagent, panel, schedule, and PR watch dispatched through T3's orchestration so panels mix Claude, Gemini, GPT, and Grok.",
"plugins": [
{
"name": "t3-pstack",
"source": "./plugins/pstack",
"description": "pstack for T3 Code: rigorous agent workflows whose panels and fan-outs run across model families through T3. Original pstack by Lauren Tan (poteto).",
"version": "2.3.0"
"version": "2.4.0"
}
]
}
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -120,12 +120,12 @@ jobs:
- name: Typecheck
run: bun run typecheck
- name: Test
run: bun test watch-pr check-plan.test.ts
run: bun test watch-pr
# Upstream's scripts are not Prettier output, so this checks the port's
# own TypeScript. Pinned here, not in package.json, so bun.lock stays
# identical to upstream's.
- name: Check formatting
run: bunx prettier@3.6.2 --check watch-pr/settle.ts watch-pr/settle.test.ts watch-pr/verdicts.test.ts resolve-codex-transcript.ts
run: bunx prettier@3.6.2 --check watch-pr/settle.ts watch-pr/settle.test.ts watch-pr/verdicts.test.ts

# The same test step as upstream's validate-plugins.yml, on the Node 22 it
# uses, the oldest line the statechart launcher runs TypeScript on.
Expand Down
49 changes: 49 additions & 0 deletions CHANGES.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,55 @@

This file is the release changelog, with one `## <version> - <title>` entry per release, newest first. The Cursor-to-T3 rewrite rules live in [`tools/substitutions.json`](tools/substitutions.json), and the [sync boundary](CONTRIBUTING.md#the-sync-boundary) in `CONTRIBUTING.md` defines how a change to upstream's skill content is declared.

## 2.4.0 - Lauren's `2f87c85`: shorter skills, worker.md, and Opus 5.5 first with no role above xhigh

t3-pstack moves to Lauren Tan's pstack at cursor/plugins `2f87c85` ([pstack #1249](https://github.com/cursor/plugins/pull/1249)) for all three components, and pstack's version moves from 0.15.42 to 0.15.43. Only pstack changed upstream. cursor-team-kit and thermos have no change between `bf0c7cd` and `2f87c85`, and their pins move with pstack's.

**What changed upstream.**

- Shorter texts. Fourteen principle leaves, `unslop`, and `technical-writing` keep each rule and its test in a shorter body, and `unslop` keeps its rule numbers. Opening a PR is three paragraphs, Babysit is six rules with three modes (`drive`, `threads-only`, `check`), and the multi-phase plan playbook is five steps. Nothing runs `check-plan.mjs` any more, so it and its test are deleted.
- `reflect` is one short file with no subagents. It reads the transcript itself, keeps a finding only if it will still hold and would change a future agent's work, routes each to a skill the session used, and waits for approval before any edit. Its three reviewers, its synthesizer, their four reference files, and the `reflect tooling` and `reflect judgment, divergent, synthesizer` roles are gone.
- `architect` is a short brief. It traces every system the change touches, sketches two shapes, and picks the one where each piece of state has one owner, each task one way to do it, and callers the least to know. A large or contested design runs `arena` instead. Its phases, runner prompt, red-flag list, rationale template, and the `architect runners` role are gone.
- The Orchestrate playbook is deleted, and program-scale work routes to `figure-it-out`. poteto-mode's triggers are ten short lines, Writing the reply is one paragraph, the Comments section is gone, and the playbook list names 22 playbooks.
- New `poteto-mode/worker.md`. It names the operator, the person the run works for, and lists the rules every started agent keeps: the kickoff's bar is the whole bar, block only for a failing run or a bug a user would hit, never ask a person a question, open PRs ready, and the PR title and body shape. The first line of every kickoff points at it, and worker.md passes the same pointer on.
- Opus 5.5 first. Code, prose, and judgment run on Opus 5.5 at xhigh, and trivial edits, swarm workers, and verification on Opus 5.5 at high. Outside a panel, Fable 5.2 runs only when the user names it or after two Opus 5.5 xhigh runs of the same brief fail their check, and the `hardest tasks` role is gone. No role runs above xhigh. Panels keep one seat each on Fable 5.2, Opus 5.5, and Gemini 4 Carbon at high, and the arena cross-judge pool drops Fable, which is the same vendor as Opus.
- setup-pstack offers three budgets (large, medium, small) on a ladder that tops out at xhigh and writes `# defaults: 3`. On a sheet without that line it takes the new cross-judge pool in place of the old three-seat default, turns an `unlimited` budget into `large`, and keeps the earlier Grok migration for a sheet without `# defaults: 2`.

**What the port adapted, and why.**

The defaults in `plugins/pstack/models.json` map Lauren's to T3 entries that this Mac's `orchestrator_capabilities` lists:

| Tier | Roles | 2.3.0 | 2.4.0 |
| --- | --- | --- | --- |
| `default` | `feature, refactoring`, `bug-fix`, `perf-issue`, `hillclimb`, `judgment and prose` | `claudeAgent/claude-opus-5-5 effort=xhigh` | unchanged |
| `fast` | `swarm workers` | `claudeAgent/claude-opus-5-5 effort=high fastMode=true` | `claudeAgent/claude-opus-5-5 effort=high` |
| `panel` | `arena runners`, `interrogate reviewers` | Fable 5.2, Opus 5.5 with `fastMode=true`, and Gemini 4 Carbon, each at high | `claudeAgent/claude-fable-5-2 effort=high`, `claudeAgent/claude-opus-5-5 effort=high`, `antigravity/gemini-4-carbon thinking_level=high` |
| `judges` (new) | `arena cross-judge pool` | on `panel` | `claudeAgent/claude-opus-5-5 effort=high`, `antigravity/gemini-4-carbon thinking_level=high` |

The `strongest` tier is gone with `hardest tasks`. `panel` and `judges` are the list tiers, and each spans two model families. `t3-sheet.mjs` lets a role take a list when its tier's default is one, so the pool keeps the panel's two-family check.

- **Cursor's `-fast` slug maps to the plain model at the same effort.** This is the one deliberate departure from Lauren's text. On T3, Claude's `fastMode` is a priced fast mode, not Cursor's fast slug, so no default turns it on. 2.3.0 mapped `-fast` to `fastMode=true` on `swarm workers`, `reflect tooling`, and the panels' Opus seat, and 2.4.0 drops it there. Lauren's "Opus 5.5 always runs its `-fast` slug" reads "Opus 5.5 runs at standard speed, so leave out `fastMode`, which on T3 is a priced fast mode" in poteto-mode, and setup-pstack never writes `fastMode`. Eval's dispatch-only agent runs on `claudeAgent/claude-opus-5-5 effort=medium`. Each "reasoning level" line keeps the entry's own reasoning option (`effort` on Claude, `reasoningEffort` on Codex and Grok, `thinking_level` on Antigravity).
- **Gemini 4 Carbon** is `antigravity/gemini-4-carbon thinking_level=high`, as in 2.3.0, and "a Gemini seat never runs above `gemini-4-carbon-high`" reads `thinking_level=high`.
- **worker.md resolves on T3.** A kickoff is a `delegate_task` brief, and the child can run on another provider, whose t3-pstack lives in its own config home, or on another machine where the parent's path does not exist. The pointer keeps Lauren's first sentence and adds where the child finds its own copy: "If that file is missing here, read skills/poteto-mode/worker.md in this host's t3-pstack plugin under `${CLAUDE_CONFIG_DIR:-~/.claude}/plugins/` or `${CODEX_HOME:-~/.codex}/plugins/`." worker.md gains one T3 line. The child's kickoff is a `delegate_task` brief, it is a leaf that starts no agent unless its kickoff names one, it never calls `watch_pull_request`, and it reports a wait on a PR to the agent that started it. That squares worker.md with Dispatch on T3's leaf rule and with T3, which gives a child no PR watch. Dispatch on T3 now says a persona's read comes right after the worker.md line. Lauren's other rules apply on T3 as she wrote them.
- **poteto-agent's pinned model.** Lauren's agent file pins `model: claude-opus-5-5-xhigh-fast`. On T3 a `poteto-agent` is a `delegate_task` brief whose `target` sets the model, Claude Code would send a Cursor slug to its API on a native spawn of the registered agent, and Codex registers no plugin agents. So the port drops the line, and poteto-mode's "omit `model` and spawn `generalPurpose`, because `poteto-agent` defaults to Opus 5.5" reads "omit `target`".
- **reflect reads its own T3 thread.** Lauren's reflect reads the transcript itself. On T3 it reads its thread with `t3_thread_read` in the activity view, taking the ID from `t3_thread_configure`. The Claude Code transcript finder (`reflect/scripts/find-transcript.mjs`) and the Codex resolver (`poteto-mode/scripts/resolve-codex-transcript` and its `.ts`) existed only for reflect's old step 1, so they are retired with their tests, their CI format check, and their NOTICE rows. show-me-your-work's rule named a `t3_thread_configuration` tool that T3 does not have, and it now names `t3_thread_configure`.
- **Babysit and Shipping keep the in-turn watcher loop.** Lauren's Babysit drops `/loop` and the `background` mode. The watcher still has no deadline by default, and a shell call stops at the 600-second tool cap, so `drive` keeps the T3 loop: `--timeout 540`, a stop after two unchanged hours or three in all, a stop on the exit 6 merge gates, and `watch_pull_request` for a wait on a human review. Shipping's queued watcher keeps its loop on Lauren's new sentence.
- **Retired roles keep a released sheet working.** `hardest tasks`, `strongest judgment`, `reflect tooling`, `reflect judgment, divergent, synthesizer`, and `architect runners` move to `retired`, so the checker and `doctor` pass their lines unchecked, and setup-pstack drops them on its next run, as Lauren's step 2 says. `doctor` now also warns, naming each retired line and that `/setup-pstack` drops it.
- **Origin** text stays as Lauren wrote it.
- **Substitutions.** 73 rules matched only text Lauren deleted or reworded, from reflect, architect, Orchestrate, check-plan, the old multi-phase plan, and poteto-mode's removed lists, and they are gone. 37 rules anchor on her 0.15.43 text. Most carry an earlier rule's T3 form onto her new sentence, and six are new: the kickoff trigger, the worker.md pointer, worker.md's T3 line, poteto-agent's model line, reflect's thread read, and eval's dispatch-only model. arena's rule that the judge first tries a model that ran fewer candidates, a port addition since 1.0.2, anchored on a sentence Lauren replaced with "use the first entry from another vendor", so it goes. With the default runners and pool it picked the same judge. The rule count moves from 174 to 138.
- **The forks.** Before the sync, every non-forked file whose derivation the new rules and `models.json` changed took the new derivation at `bf0c7cd`, as in 2.3.0, so each synced as a clean update. The six forks that conflicted took Lauren's text by hand. poteto-mode keeps its four rules from Michael Denyer's pstack-claude on Lauren's shorter text, and differs from her derived text by seven lines. setup-pstack keeps its T3 sheet steps with Lauren's three budgets, retired roles, `# defaults: 3` migration, and xhigh cap, at 32 changed lines (34 at 2.3.0). Feature, Opening a PR, Shipping, and Worktree cleanup keep their declared rules on her new text. Opening a PR's fork entry drops its note on the `reset --hard` sentence, which Lauren deleted.

**Verification.**

On macOS 27.0 with Claude Code 2.1.325 and Codex 0.169.0:

- `bun tools/generate.mjs --check` reports 13 generated files current. `GIT_CONFIG_GLOBAL=/dev/null bun test tests/ --timeout 30000` passes 508, skips 56, and fails 0. 2.3.0 passed 564, and the difference is the transcript finder's and the Codex resolver's tests, which go with them. The installer's end-to-end test passes 18 of 18. The poteto-mode script tests pass 106 of 106 without check-plan's, with typecheck and Prettier clean. `validate-skills` keeps every local link inside the skills tree, markdownlint reports 0 errors, and zizmor and actionlint pass the workflow.
- The dry run at `2f87c85` passes for all three components, with no undeclared fork and no substitution that matches nothing.
- This Mac's sheet has no `# defaults:` line and carries `strongest judgment`, `reflect tooling`, `reflect judgment, divergent, synthesizer`, and `architect runners` lines. With this release installed in throwaway Claude Code and Codex homes, each installed `t3-sheet.mjs` printed `ok: every role line parses and dispatches on this T3` on a copy of it against this Mac's live `orchestrator_capabilities`, and exited 0. `doctor --catalog` reported "machine sheet valid" and warned "retired roles: no skill reads" each retired line. With 2.3.0's `retired` list, the same checker printed `"strongest judgment" is not a pstack role` and three more lines and exited 1. The new checker and `doctor` tests fail on 2.3.0 and pass here.
- In both installed homes, `find` on the pointer's fallback path returns `skills/poteto-mode/worker.md`, and no installed file carries a Cursor model slug.

This is a minor release. worker.md is new, and the Orchestrate playbook and reflect's and architect's fan-outs are removed, as 2.3.0's removal of `how` and `why`'s fan-outs was minor. It is not a major release, because no user has to act. A sheet written by any 2.x release passes `doctor` and setup-pstack's check, with a warning for each retired line, and poteto-mode keeps honoring its lines and tells the user once per session to rerun `/setup-pstack`. Neither hooks file changes. Rerun `/setup-pstack` to take the new defaults, drop `fastMode` from unchanged roles, and drop the retired lines. On Codex, run `npx -y github:chhoumann/t3-pstack update` after it, as after every release.

## 2.3.0 - Lauren's `bf0c7cd`: why and how are one file each, and the defaults move to Fable 5.2, Opus 5.5, and Gemini 4 Carbon

t3-pstack moves to Lauren Tan's pstack at cursor/plugins `bf0c7cd` ([pstack #1236](https://github.com/cursor/plugins/pull/1236)) for all three components, and pstack's version moves from 0.15.36 to 0.15.42. Only pstack changed upstream. cursor-team-kit and thermos have no change between `c742dd6` and `bf0c7cd`, and their pins move with pstack's.
Expand Down
4 changes: 2 additions & 2 deletions CONTEXT.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ Names for the concepts this repo's design discussions keep reaching for. Archite
- **Installer** - `tools/install.mjs`, the package's `t3-pstack` bin, run as `npx -y github:chhoumann/t3-pstack <install|update|doctor>`. It installs the plugin in every Claude Code and Codex home T3 can run, trusts the Codex session-start hook, moves the model sheet to its machine path, and checks the result.
- **Frozen hooks file** - `hooks/hooks.json` or `hooks/codex-hooks.json`, pinned in `tools/frozen-hooks.json`. Codex trusts a hook by a hash of its entry, so a change stops the hook in every Codex home until the installer reruns. What the hook says lives in `session-start.sh` and the routing text, which change freely.
- **Model policy** - the role defaults in `plugins/pstack/models.json`, as tiers of T3 entries. The generator stamps them into each skill's Models section and setup-pstack's sheet block.
- **Role** - a named unit of delegated work with its own model choice (`arena runners`, `hardest tasks`, `swarm workers`). The role vocabulary lives in `models.json`, which also lists the retired roles whose lines an older sheet may still carry.
- **Panel** - a role whose value is a list (`arena runners`, `architect runners`, `interrogate reviewers`, `arena cross-judge pool`). A panel spans at least two model families; a family is the first segment of a model ID's last `/` part, except that a `claude-fable-*` model's family is `claude-fable`.
- **Role** - a named unit of delegated work with its own model choice (`arena runners`, `judgment and prose`, `swarm workers`). The role vocabulary lives in `models.json`, which also lists the retired roles whose lines an older sheet may still carry.
- **Panel** - a role whose value is a list (`arena runners`, `interrogate reviewers`, `arena cross-judge pool`). A panel spans at least two model families; a family is the first segment of a model ID's last `/` part, except that a `claude-fable-*` model's family is `claude-fable`.
- **Substitution** - a rule in `tools/substitutions.json` that rewrites one upstream sentence or token into its T3 form. An anchored insert is a substitution that keeps the upstream sentence and appends T3 text.
- **Fork** - a file the port keeps in its own form, declared in `tools/forks.json` with its reason. Every upstream change to it needs a person.
- **Port-only file** - a file under a component's local path that upstream does not carry, such as the manifests, the hooks, `models.json`, and `settle.ts`.
Expand Down
Loading
Loading