Skip to content

AGENTS.md

Latest commit

 

History

History
70 lines (57 loc) · 3.42 KB

AGENTS.md

File metadata and controls

70 lines (57 loc) · 3.42 KB

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 are discovered automatically from the install locations listed below. 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.
/investigate 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.
/codex Second opinion from OpenAI Codex CLI (cross-model review).

Skill discovery paths

OpenCode loads skills from the following locations (all are searched):

Global (all projects):

  • ~/.config/opencode/skills/*/SKILL.md
  • ~/.agents/skills/*/SKILL.md
  • ~/.claude/skills/*/SKILL.md

Project-local (walked up from current directory to git root):

  • .agents/skills/*/SKILL.md
  • .opencode/skills/*/SKILL.md (not yet used by this adapter — reserved)
  • .claude/skills/*/SKILL.md

The global install (~/.config/opencode/skills/gstack/) is the standard path. Use the project-local .agents/skills/ path if you want teammates to get gstack automatically on git clone without a separate install step.

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 .tmpl templates. Edit the template, not the output.
  • Run bun run gen:skill-docs --host codex to 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.
  • This adapter targets OpenCode. For Claude Code, use the upstream garrytan/gstack.