Skip to content
Merged
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
5 changes: 2 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

## GStack 2 canonical contract

The public surface is exactly `/plan`, `/design`, `/qa`, `/debug`, `/review`,
and `/ship`. They are lazy dispatchers over the preserved modules under
The public surface is exactly `/plan`, `/qa`, `/debug`, `/review`, and `/ship`.

@cubic-dev-ai cubic-dev-ai Bot Jul 23, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Agent routing is now contradictory: CLAUDE.md presents five canonical skills while AGENTS.md still instructs agents that /design is a sixth public skill and routes design aliases to it. Updating the canonical contract without updating AGENTS.md can cause agents to discover or invoke the retired dispatcher.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At CLAUDE.md, line 5:

<comment>Agent routing is now contradictory: `CLAUDE.md` presents five canonical skills while `AGENTS.md` still instructs agents that `/design` is a sixth public skill and routes design aliases to it. Updating the canonical contract without updating `AGENTS.md` can cause agents to discover or invoke the retired dispatcher.</comment>

<file context>
@@ -2,8 +2,8 @@
 
-The public surface is exactly `/plan`, `/design`, `/qa`, `/debug`, `/review`,
-and `/ship`. They are lazy dispatchers over the preserved modules under
+The public surface is exactly `/plan`, `/qa`, `/debug`, `/review`, and `/ship`.
+They are lazy dispatchers over the preserved modules under
 `skills/*/references/legacy/`; do not rewrite or summarize away the original
</file context>
Fix with cubic

They are lazy dispatchers over the preserved modules under
`skills/*/references/legacy/`; do not rewrite or summarize away the original
question pressure, rubrics, pushback, approval gates, evidence, artifacts,
mutation boundaries, recommendations, or voice. Compatibility files under
Expand Down Expand Up @@ -916,7 +916,6 @@ When the user's request matches an available skill, invoke it via the Skill tool

Key routing rules:
- Product framing, strategy, scope, architecture, DX, specs, or a full planning pipeline → invoke `/plan` with the preserved specialist mode.
- Design systems, alternatives, coded visual output, plan review, web audit, or HIG audit → invoke `/design`.
- Web/device QA, report-only versus fixes, DX journeys, performance, or canaries → invoke `/qa`.
- Bugs and unknown failures → invoke `/debug`; prove root cause before mutation.
- Diff, security, compatibility, or repository-health review → invoke `/review`.
Expand Down
11 changes: 5 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,12 @@
> `./setup` instructions and the many-command catalog describe the 1.x
> compatibility surface.

GStack 2 presents one engineering judgment layer through exactly six public
GStack 2 presents one engineering judgment layer through exactly five public
skills:

| Skill | Start here when… |
|---|---|
| `/plan` | The product, scope, architecture, DX, or specification is unsettled. |
| `/design` | You need a visual direction, alternatives, implementation, or design audit. |
| `/qa` | You need report-only or fix-and-verify evidence from the local browser or a physical iPhone. |
| `/debug` | A failure needs root-cause proof before a fix. |
| `/review` | A diff or repository needs correctness, security, compatibility, or health review. |
Expand All @@ -23,7 +22,7 @@ skills:
DX, Specification, and Full chain**. The other dispatchers refine their small
public mode set into the preserved specialist modules only after selection.

The specialist judgment was not flattened into six generic prompts. Each
The specialist judgment was not flattened into five generic prompts. Each
dispatcher states its mode, depth, mutation boundary, active and skipped
modules, and web-context choice, then lazily reads the preserved specialist
module. See the complete [old-command mapping](docs/gstack-2/SKILL-MIGRATION.md)
Expand All @@ -38,7 +37,7 @@ scope, destination paths, updates, removal, and selected-skill installation:
npx skills add time-attack/gstack/skills
```

That installs the six judgment skills. Install a subset with the installer's
That installs the five judgment skills. Install a subset with the installer's
`--skill` option, or use `-g` for its global scope. GStack does not silently
enroll detected hosts.

Expand Down Expand Up @@ -94,7 +93,7 @@ tree contains legacy GStack 1 entry points and is not the GStack 2 install
surface.

The npm package is deliberately not the skill installer and does not contain
the six skill tree or compiled browser/design/PDF payloads. It is the small
the five skill tree or compiled browser/design/PDF payloads. It is the small
host-neutral runtime control/bootstrap surface used by release tooling. New
users should install skills with `npx skills add time-attack/gstack/skills`; optional
capabilities are downloaded by a skill after consent.
Expand Down Expand Up @@ -132,7 +131,7 @@ I'm [Garry Tan](https://x.com/garrytan), President & CEO of [Y Combinator](https

Same person. Different era. The difference is the tooling.

**gstack is how I do it.** It turns an AI coding host into a virtual engineering team — a CEO who rethinks the product, an eng manager who locks architecture, a designer who catches AI slop, a reviewer who finds production bugs, a QA lead who opens a real browser, a security officer who runs OWASP + STRIDE audits, and a release engineer who ships the PR. In GStack 2 those preserved specialists sit behind six lazy dispatchers rather than dozens of default commands. It remains MIT licensed.
**gstack is how I do it.** It turns an AI coding host into a virtual engineering team — a CEO who rethinks the product, an eng manager who locks architecture, a designer who catches AI slop, a reviewer who finds production bugs, a QA lead who opens a real browser, a security officer who runs OWASP + STRIDE audits, and a release engineer who ships the PR. In GStack 2 those preserved specialists sit behind five lazy dispatchers rather than dozens of default commands. It remains MIT licensed.

This is my open source software factory. I use it every day. I'm sharing it because these tools should be available to everyone.

Expand Down
10 changes: 1 addition & 9 deletions compat/README.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 0 additions & 10 deletions compat/design-consultation.md

This file was deleted.

10 changes: 0 additions & 10 deletions compat/design-html.md

This file was deleted.

10 changes: 0 additions & 10 deletions compat/design-review.md

This file was deleted.

10 changes: 0 additions & 10 deletions compat/design-shotgun.md

This file was deleted.

10 changes: 0 additions & 10 deletions compat/diagram.md

This file was deleted.

10 changes: 0 additions & 10 deletions compat/ios-design-review.md

This file was deleted.

10 changes: 0 additions & 10 deletions compat/make-pdf.md

This file was deleted.

96 changes: 0 additions & 96 deletions compat/migration-map.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 0 additions & 10 deletions compat/plan-design-review.md

This file was deleted.

Loading
Loading