mirror of
https://github.com/garrytan/gstack.git
synced 2026-05-02 11:45:20 +02:00
Garry Tan
6fc696dfb8
Tests (28 new): - Codex output path routing, frontmatter validation (name+description only) - No .claude/skills/ path leaks in Codex output (regression guard) - /codex skill exclusion, hook→prose conversion, multiline YAML - --host agents alias, dynamic template discovery - Codex skill validation + $B command validation - find-browse priority chain verification - Replace static ALL_SKILLS list with dynamic filesystem scan CI: - Add Codex freshness check to skill-docs workflow Docs: - AGENTS.md: Codex-facing project instructions - README: multi-agent installation section - CONTRIBUTING: dual-host development workflow - CHANGELOG: v0.9.0 multi-agent support entry Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.5 KiB
2.5 KiB
gstack — AI Engineering Workflow
gstack is a collection of SKILL.md files that give AI agents structured roles for software development. Each skill is a specialist: CEO reviewer, eng manager, designer, QA lead, release engineer, debugger, and more.
Available skills
Skills live in .agents/skills/. Invoke them by name (e.g., /office-hours).
| Skill | What it does |
|---|---|
/office-hours |
Start here. Reframes your product idea before you write code. |
/plan-ceo-review |
CEO-level review: find the 10-star product in the request. |
/plan-eng-review |
Lock architecture, data flow, edge cases, and tests. |
/plan-design-review |
Rate each design dimension 0-10, explain what a 10 looks like. |
/design-consultation |
Build a complete design system from scratch. |
/review |
Pre-landing PR review. Finds bugs that pass CI but break in prod. |
/debug |
Systematic root-cause debugging. No fixes without investigation. |
/design-review |
Design audit + fix loop with atomic commits. |
/qa |
Open a real browser, find bugs, fix them, re-verify. |
/qa-only |
Same as /qa but report only — no code changes. |
/ship |
Run tests, review, push, open PR. One command. |
/document-release |
Update all docs to match what you just shipped. |
/retro |
Weekly retro with per-person breakdowns and shipping streaks. |
/browse |
Headless browser — real Chromium, real clicks, ~100ms/command. |
/setup-browser-cookies |
Import cookies from your real browser for authenticated testing. |
/careful |
Warn before destructive commands (rm -rf, DROP TABLE, force-push). |
/freeze |
Lock edits to one directory. Hard block, not just a warning. |
/guard |
Activate both careful + freeze at once. |
/unfreeze |
Remove directory edit restrictions. |
/gstack-upgrade |
Update gstack to the latest version. |
Build commands
bun install # install dependencies
bun test # run tests (free, <5s)
bun run build # generate docs + compile binaries
bun run gen:skill-docs # regenerate SKILL.md files from templates
bun run skill:check # health dashboard for all skills
Key conventions
- SKILL.md files are generated from
.tmpltemplates. Edit the template, not the output. - Run
bun run gen:skill-docs --host codexto regenerate Codex-specific output. - The browse binary provides headless browser access. Use
$B <command>in skills. - Safety skills (careful, freeze, guard) use inline advisory prose — always confirm before destructive operations.