Gstack Workflow Assistant

1---2name: gstack-workflow-assistant3description: Team of specialist AI workflows for Claude Code with CEO review, engineering planning, code review, shipping, QA testing, and browser automation4triggers:5  - "plan this feature like a CEO"6  - "review this code thoroughly"7  - "ship this branch"8  - "test this in browser"9  - "run QA on my app"10  - "do engineering retrospective"11  - "browse and test this page"12  - "setup browser session"13---14 15# gstack Workflow Assistant16 17> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection18 19Transform Claude Code from a generic assistant into a team of specialists you can summon on demand. Eight opinionated workflow skills that act as CEO, Engineering Manager, Release Manager, and QA Engineer with slash commands for planning, review, shipping, and testing.20 21## What It Does22 23gstack provides specialized AI personas and workflows:24- **CEO Review**: Rethink problems and find the 10-star product hiding in requests25- **Engineering Planning**: Lock in architecture, data flow, and edge cases26- **Code Review**: Paranoid staff engineer-level review that catches production bugs27- **Release Management**: One-command shipping with tests and PR creation28- **QA Testing**: Automated browser testing with screenshots and systematic coverage29- **Browser Automation**: Give AI eyes to click through your app and catch breakage30- **Session Management**: Import real browser cookies for authenticated testing31- **Team Retrospectives**: Engineering manager-style retros with per-person insights32 33## Installation34 35### Requirements36- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)37- [Git](https://git-scm.com/)38- [Bun](https://bun.sh/) v1.0+39- macOS or Linux (x64/arm64) for browser automation40 41### Global Installation42```bash43git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack44cd ~/.claude/skills/gstack45./setup46```47 48### Project Installation49```bash50cp -Rf ~/.claude/skills/gstack .claude/skills/gstack51rm -rf .claude/skills/gstack/.git52cd .claude/skills/gstack53./setup54```55 56Add to your `CLAUDE.md`:57```markdown58## gstack59Use /browse skill from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.60 61Available skills:62- /plan-ceo-review - Product strategy review63- /plan-eng-review - Technical architecture planning  64- /review - Thorough code review65- /ship - One-command branch shipping66- /browse - Browser automation and testing67- /qa - Systematic QA testing68- /setup-browser-cookies - Session management69- /retro - Engineering retrospectives70```71 72## Core Commands73 74### Planning Workflows75 76#### CEO Product Review77```typescript78// Start with feature description, then review strategy79You: I want to add seller photo upload to the listing app80 81You: /plan-ceo-review82// AI responds as CEO: challenges assumptions, finds bigger opportunity83// "Photo upload" → "AI-powered listing creation from photos"84```85 86#### Engineering Architecture Review87```typescript88You: /plan-eng-review89// AI responds as tech lead:90// - Architecture diagrams91// - State machines92// - Async job boundaries  93// - Failure modes94// - Test matrices95```96 97### Code Quality Workflows98 99#### Thorough Code Review100```typescript101You: /review102// Paranoid staff engineer review:103// - Race conditions104// - Trust boundaries105// - Missing error handling106// - Production failure modes107```108 109#### One-Command Shipping110```typescript111You: /ship112// Automated release process:113// 1. Sync main branch114// 2. Run test suite115// 3. Resolve review comments116// 4. Push branch117// 5. Open pull request118```119 120### QA and Testing Workflows121 122#### Browser Automation123```typescript124You: /browse https://myapp.com125// AI navigates your app:126// - Takes screenshots127// - Clicks through workflows128// - Identifies breakage129// - Tests responsive design130```131 132#### Systematic QA Testing133```typescript134You: /qa135// Branch-aware testing:136// - Analyzes git diff137// - Identifies affected pages138// - Tests localhost:3000139// - Full exploration mode140// - Regression testing141 142You: /qa https://staging.myapp.com --quick143// Quick smoke test: 5 pages in 30 seconds144```145 146#### Session Management147```typescript148You: /setup-browser-cookies staging.myapp.com149// Imports cookies from real browser (Chrome, Arc, Brave, Edge)150// Enables testing authenticated pages without manual login151```152 153### Team Workflows154 155#### Engineering Retrospectives156```typescript157You: /retro158// Engineering manager-style retro:159// - Analyzes git history160// - Per-person contributions161// - Growth opportunities162// - Team dynamics163// - Saves to .context/retros/164```165 166## Configuration167 168### Browser Settings169gstack creates isolated browser instances in `.gstack/` directory:170```typescript171// Automatic browser configuration172{173  userDataDir: '.gstack/browser-data',174  headless: false, // for debugging175  viewport: { width: 1280, height: 720 },176  timeout: 30000177}178```179 180### Project Structure181```182your-project/183├── .claude/184│   └── skills/185│       └── gstack/186│           ├── skills/           # Workflow prompts187│           ├── browse/           # Browser automation188│           └── package.json189├── .gstack/                      # Browser data (gitignored)190│   ├── browser-data/191│   └── screenshots/192└── .context/193    └── retros/                   # Retrospective history194```195 196## Integration Patterns197 198### Multi-Session Workflow199Use [Conductor](https://conductor.build) for parallel sessions:200```typescript201// Session 1: Feature development202You: /plan-ceo-review203You: /plan-eng-review204// [implement feature]205 206// Session 2: Code review207You: /review208// [fix issues]209 210// Session 3: QA testing  211You: /qa --full212 213// Session 4: Release214You: /ship215```216 217### CI/CD Integration218```yaml219# .github/workflows/gstack-qa.yml220name: gstack QA221on: [pull_request]222jobs:223  qa:224    runs-on: ubuntu-latest225    steps:226      - uses: actions/checkout@v3227      - run: cd .claude/skills/gstack && ./setup228      - run: echo "/qa --regression" | claude-code229```230 231### Team Onboarding232```markdown233# Add to team docs234## Development Workflow2351. `/plan-ceo-review` - Validate product direction2362. `/plan-eng-review` - Lock architecture  2373. Implement feature2384. `/review` - Paranoid code review2395. `/qa` - Test branch thoroughly2406. `/ship` - One-command release2417. `/qa staging.app.com` - Staging verification242```243 244## Advanced Usage245 246### Custom QA Scenarios247```typescript248// Feature-specific testing249You: /qa --focus=checkout-flow250You: /qa --mobile-only251You: /qa --accessibility252 253// Performance testing254You: /browse https://app.com255// Then: "Run lighthouse audit on this page"256```257 258### Cross-Browser Testing259```typescript260// Test in multiple browsers261You: /setup-browser-cookies app.com262You: /browse app.com --browser=chrome263// [switch session]264You: /browse app.com --browser=firefox265```266 267### Regression Testing268```typescript269// Before major changes270You: /qa --baseline271// [make changes]  272You: /qa --compare-baseline273// AI identifies visual/functional regressions274```275 276## Troubleshooting277 278### Binary Issues279```bash280# Rebuild browser automation binary281cd .claude/skills/gstack282rm -rf browse/dist283./setup284```285 286### Permission Errors287```bash288# Fix executable permissions289cd .claude/skills/gstack290chmod +x setup browse/dist/browse291```292 293### Missing Dependencies294```bash295# Reinstall Node dependencies296cd .claude/skills/gstack297rm -rf node_modules298bun install299```300 301### Browser Automation Failures302```typescript303// Debug browser issues304You: /browse --debug305// Runs browser in non-headless mode for inspection306 307// Clear browser data308rm -rf .gstack/browser-data309```310 311### Skill Registration Issues312```typescript313// Re-register skills314cd .claude/skills/gstack315./setup316 317// Verify skills are available318You: /plan-ceo-review --help319```320 321The skills work by providing specialized prompts and browser automation tools that transform Claude Code into domain experts. Each workflow enforces specific cognitive modes - CEO strategic thinking, engineering rigor, paranoid review, or systematic testing - instead of generic assistance.