Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

60 Commits

Folders and files

Repository files navigation

pstack

Pstack-inspired workflows for Google Antigravity (agy), adapted from pstack (0.15.43) by Lauren Tan (poteto).

If you want to go fast, go deep first. Throughput without verification only ships broken code faster. pstack layers disciplined engineering principles, orthogonal design bakeoffs, TLA+ statechart verification, adversarial exploit testing, and zero-slop code hygiene directly on top of Antigravity's built-in swarm runtime.

Install

agy plugin install https://github.com/pstack-ports/agy-pstack-next

No setup command, hook registration, or model config file is required. Start immediately with /agy-pstack-next:pstack (or /pstack in the UI):

/agy-pstack-next:pstack reproduce the idle scroll drift first, fix the root cause, and prove the fix in the browser.

Architecture: Built-in swarm Dependent, Multi-Worktree Safe, Zero Hooks

  • Built on Antigravity's built-in swarm (override nothing). All 10 technical skills load Antigravity's built-in swarm instructions (<appDataDir>/builtin/skills/native_swarm/SKILL.md when /swarm wasn't invoked explicitly, plus swarm_pane when listed in <skills>) via swarm-contract.md with zero overrides, zero restatement of built-in mechanics, and zero global hooks (only /bro runs inline to restate the last reply).
  • Orthogonal axes without model overrides. /crucible and /interrogate enforce independent thinking through orthogonal structural axes (design-a..c, blind judge reading git diffs without board authorship) and fault-surface splits (adv-logic, adv-boundary, blast) on your chosen session model unless you explicitly ask for other models.
  • Multi-worktree & process isolation. Git operations anchor to TARGET_CWD (rev-parse --show-toplevel), peer checkouts use detached HEAD, and runs isolate scratch directories (mktemp -d), ephemeral ports (--port 0), profiles/tmux -L sockets, and PID-scoped teardown.
  • Self-contained briefs & .agents/skills/verify-* gates. Briefs inline the 3–4 relevant rules from principles.md plus resolved <plugin-dir>/skills/... paths (for typescript-best-practices and statechart), and independent verifier workers execute behavioral or formal .agents/skills/verify-* suites cold before any commit lands in TARGET_CWD.

Skills

Skill Purpose
/pstack Unified swarm coordinator covering diagnosis, features, caller-migrating refactors, benchmark hillclimbs, multi-phase programs, and opt-in PR shipping.
/crucible Competing architectural (sketch) or executable (full) prototypes across orthogonal design axes, blind judge, and warm fork + cherry-pick synthesis.
/interrogate Adversarial exploit hunting (workspace: "share" failing repros) paired with transitive caller, wire-schema, and rollout-skew blast-radius proof.
/understand Parallel clue-sharing scouts for mechanism walkthroughs (how), historical provenance under 5 epistemic confidence tiers (why), and interactive walkthroughs (teach).
/typescript-best-practices TypeScript type-system and boundary discipline grounded in concrete syntax and patterns.md when reading or editing .ts/.tsx files.
/statechart Full TLA+ (TLC) model checker and Mermaid statechart compiler (scripts/statechart + Pele SVG rendering) with user-language state/step views and shortest bug paths.
/create-verification-skill Interview a repo, generate a .agents/skills/verify-<app>/ behavioral harness + features/ map, and prove it cold end to end.
/maintain-verification-skill Parallel source-drift audit + single-owner live pass across every mapped feature (clean, changed, or blocked) under strict edit scope.
/create-formal-verification-skill Formally verify a high-consequence concurrency, state-machine, parser, or input invariant (TLA+, SMT, prover, or PBT), prove failure sensitivity, and generate .agents/skills/verify-<area>-formal/.
/maintain-formal-verification-skill Sync formal checks with sync_commit..HEAD code changes, re-prove failure sensitivity, and separate verification drift from real product bugs (in sync, updated, bug, or blocked).
/bro Restate the last reply or a named passage in plain everyday language with zero jargon.

Validate

agy plugin validate --strict --json .

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages