Skip to content

Commit b85497d

Browse files
Sinabinaclaude
authored andcommitted
docs: make the front door agree with the release it ships in
The README banner said 'not a released 2.0' and pointed at a branch that isn't this one; it now states the beta, the judgment-only default, and where the evidence lives. The uninstall example named the deleted design skill and omitted make-pdf. The 'See it work' transcript — the most persuasive artifact in the file — sat inside the fold labeled 'Legacy 1.x workflow'; it now sits above the fold with a one-line note that the classic names still route. INSTALL.md's worked bootstrap output ran against the unpublished rc.6 release; it now says what happens until the tag exists. BOOTSTRAP_RELEASE_UNAVAILABLE tells the developer the skills work without the runtime instead of leaving them at a dead end. No voice changes; facts only. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent b5de3b9 commit b85497d

9 files changed

Lines changed: 74 additions & 57 deletions

File tree

README.md

Lines changed: 54 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
# gstack
22

3-
> **GStack 2.0 is under verification on `codex/gstack-2`.** It is not a
4-
> released 2.0 until every gate in
5-
> [`docs/gstack-2/STATUS.md`](docs/gstack-2/STATUS.md) passes. The material
6-
> below the GStack 2 quick start remains useful background, but host-specific
7-
> `./setup` instructions and the many-command catalog describe the 1.x
3+
> **GStack 2.0.0 public beta.** The Markdown-only skills install below is the
4+
> supported path; its evidence and the beta's known issues live in
5+
> [`docs/gstack-2/STATUS.md`](docs/gstack-2/STATUS.md). The optional managed
6+
> runtime publishes with the `v2.0.0-rc.6` release tag — until `setup` finds
7+
> it, every skill runs in judgment-only mode, which is a supported
8+
> configuration, not a failure. Material below the quick start about
9+
> host-specific `./setup` and the many-command catalog describes the 1.x
810
> compatibility surface.
911
1012
GStack 2 presents one engineering judgment layer through exactly five public
@@ -215,6 +217,52 @@ Fork it. Improve it. Make it yours. And if you want to hate on free open source
215217
- **First-time Claude Code users** — structured roles instead of a blank prompt
216218
- **Tech leads and staff engineers** — rigorous review, QA, and release automation on every PR
217219

220+
## See it work
221+
222+
*(This transcript uses the classic command names — they still route via the compatibility aliases. On the 2.0 surface you can also just describe the task, or start with `/plan`.)*
223+
224+
```
225+
You: I want to build a daily briefing app for my calendar.
226+
You: /office-hours
227+
Claude: [asks about the pain — specific examples, not hypotheticals]
228+
229+
You: Multiple Google calendars, events with stale info, wrong locations.
230+
Prep takes forever and the results aren't good enough...
231+
232+
Claude: I'm going to push back on the framing. You said "daily briefing
233+
app." But what you actually described is a personal chief of
234+
staff AI.
235+
[extracts 5 capabilities you didn't realize you were describing]
236+
[challenges 4 premises — you agree, disagree, or adjust]
237+
[generates 3 implementation approaches with effort estimates]
238+
RECOMMENDATION: Ship the narrowest wedge tomorrow, learn from
239+
real usage. The full vision is a 3-month project — start with
240+
the daily briefing that actually works.
241+
[writes design doc → feeds into downstream skills automatically]
242+
243+
You: /plan-ceo-review
244+
[reads the design doc, challenges scope, runs 10-section review]
245+
246+
You: /plan-eng-review
247+
[ASCII diagrams for data flow, state machines, error paths]
248+
[test matrix, failure modes, security concerns]
249+
250+
You: Approve plan. Exit plan mode.
251+
[writes 2,400 lines across 11 files. ~8 minutes.]
252+
253+
You: /review
254+
[AUTO-FIXED] 2 issues. [ASK] Race condition → you approve fix.
255+
256+
You: /qa https://staging.myapp.com
257+
[opens real browser, clicks through flows, finds and fixes a bug]
258+
259+
You: /ship
260+
Tests: 42 → 51 (+9 new). PR: github.com/you/app/pull/42
261+
```
262+
263+
You said "daily briefing app." The agent said "you're building a chief of staff AI" — because it listened to your pain, not your feature request. Eight commands, end to end. That is not a copilot. That is a team.
264+
265+
218266
<details>
219267
<summary>Legacy 1.x workflow and host-specific documentation</summary>
220268

@@ -321,49 +369,6 @@ Or target a specific agent with `./setup --host <name>`:
321369
**Want to add support for another agent?** See [docs/ADDING_A_HOST.md](docs/ADDING_A_HOST.md).
322370
It's one TypeScript config file, zero code changes.
323371

324-
## See it work
325-
326-
```
327-
You: I want to build a daily briefing app for my calendar.
328-
You: /office-hours
329-
Claude: [asks about the pain — specific examples, not hypotheticals]
330-
331-
You: Multiple Google calendars, events with stale info, wrong locations.
332-
Prep takes forever and the results aren't good enough...
333-
334-
Claude: I'm going to push back on the framing. You said "daily briefing
335-
app." But what you actually described is a personal chief of
336-
staff AI.
337-
[extracts 5 capabilities you didn't realize you were describing]
338-
[challenges 4 premises — you agree, disagree, or adjust]
339-
[generates 3 implementation approaches with effort estimates]
340-
RECOMMENDATION: Ship the narrowest wedge tomorrow, learn from
341-
real usage. The full vision is a 3-month project — start with
342-
the daily briefing that actually works.
343-
[writes design doc → feeds into downstream skills automatically]
344-
345-
You: /plan-ceo-review
346-
[reads the design doc, challenges scope, runs 10-section review]
347-
348-
You: /plan-eng-review
349-
[ASCII diagrams for data flow, state machines, error paths]
350-
[test matrix, failure modes, security concerns]
351-
352-
You: Approve plan. Exit plan mode.
353-
[writes 2,400 lines across 11 files. ~8 minutes.]
354-
355-
You: /review
356-
[AUTO-FIXED] 2 issues. [ASK] Race condition → you approve fix.
357-
358-
You: /qa https://staging.myapp.com
359-
[opens real browser, clicks through flows, finds and fixes a bug]
360-
361-
You: /ship
362-
Tests: 42 → 51 (+9 new). PR: github.com/you/app/pull/42
363-
```
364-
365-
You said "daily briefing app." The agent said "you're building a chief of staff AI" — because it listened to your pain, not your feature request. Eight commands, end to end. That is not a copilot. That is a team.
366-
367372
## The sprint
368373

369374
gstack is a process, not a collection of tools. The skills run in the order a sprint runs:
@@ -513,7 +518,7 @@ them. Confirm the agent/scope with `npx skills remove --help`; a noninteractive
513518
selected removal has this shape:
514519

515520
```bash
516-
npx skills remove --skill plan design qa debug review ship \
521+
npx skills remove --skill plan qa debug review ship make-pdf \
517522
--agent <host> --yes
518523
```
519524

docs/gstack-2/INSTALL.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,12 @@ node references/support/runtime-bootstrap.mjs preview --capability pdf --browser
9999
node references/support/runtime-bootstrap.mjs install --capability pdf --browser managed --yes
100100
```
101101

102-
Real output from step 2 on macOS arm64:
102+
**Until the signed `v2.0.0-rc.6` release is published** (it ships with the
103+
release tag), step 2 exits with `BOOTSTRAP_RELEASE_UNAVAILABLE` and downloads
104+
nothing. That is expected during the beta: the runtime is optional, and every
105+
skill runs in judgment-only mode without it.
106+
107+
Real output from step 2 on macOS arm64, once the release exists:
103108

104109
```
105110
GStack optional runtime 2.0.0 for darwin-arm64

runtime/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -532,7 +532,8 @@ async function fetchJson(fetch_, url, options = {}) {
532532
if (!response.ok) {
533533
if (options.official && response.status === 404) {
534534
throw bootstrapError(
535-
`Official runtime release ${BOOTSTRAP_RELEASE_TAG} is not published at ${url}. No files were downloaded or installed.`,
535+
`Official runtime release ${BOOTSTRAP_RELEASE_TAG} is not published at ${url}. No files were downloaded or installed. ` +
536+
`The runtime is optional: every skill runs in judgment-only mode without it. Retry after the release is published.`,
536537
"BOOTSTRAP_RELEASE_UNAVAILABLE",
537538
);
538539
}

skills/debug/references/support/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

skills/make-pdf/references/support/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

skills/plan/references/support/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

skills/qa/references/support/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

skills/review/references/support/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

skills/ship/references/support/runtime-bootstrap.mjs

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)