Gstack Workflow Assistant

# gstack Workflow Assistant

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection

Transform 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.

## What It Does

gstack provides specialized AI personas and workflows:
- **CEO Review**: Rethink problems and find the 10-star product hiding in requests
- **Engineering Planning**: Lock in architecture, data flow, and edge cases
- **Code Review**: Paranoid staff engineer-level review that catches production bugs
- **Release Management**: One-command shipping with tests and PR creation
- **QA Testing**: Automated browser testing with screenshots and systematic coverage
- **Browser Automation**: Give AI eyes to click through your app and catch breakage
- **Session Management**: Import real browser cookies for authenticated testing
- **Team Retrospectives**: Engineering manager-style retros with per-person insights

## Installation

### Requirements
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
- [Git](https://git-scm.com/)
- [Bun](https://bun.sh/) v1.0+
- macOS or Linux (x64/arm64) for browser automation

### Global Installation
```bash
git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack
./setup
```

### Project Installation
```bash
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack
./setup
```

Add to your `CLAUDE.md`:
```markdown
## gstack
Use /browse skill from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.

Available skills:
- /plan-ceo-review - Product strategy review
- /plan-eng-review - Technical architecture planning  
- /review - Thorough code review
- /ship - One-command branch shipping
- /browse - Browser automation and testing
- /qa - Systematic QA testing
- /setup-browser-cookies - Session management
- /retro - Engineering retrospectives
```

## Core Commands

### Planning Workflows

#### CEO Product Review
```typescript
// Start with feature description, then review strategy
You: I want to add seller photo upload to the listing app

You: /plan-ceo-review
// AI responds as CEO: challenges assumptions, finds bigger opportunity
// "Photo upload" → "AI-powered listing creation from photos"
```

#### Engineering Architecture Review
```typescript
You: /plan-eng-review
// AI responds as tech lead:
// - Architecture diagrams
// - State machines
// - Async job boundaries  
// - Failure modes
// - Test matrices
```

### Code Quality Workflows

#### Thorough Code Review
```typescript
You: /review
// Paranoid staff engineer review:
// - Race conditions
// - Trust boundaries
// - Missing error handling
// - Production failure modes
```

#### One-Command Shipping
```typescript
You: /ship
// Automated release process:
// 1. Sync main branch
// 2. Run test suite
// 3. Resolve review comments
// 4. Push branch
// 5. Open pull request
```

### QA and Testing Workflows

#### Browser Automation
```typescript
You: /browse https://myapp.com
// AI navigates your app:
// - Takes screenshots
// - Clicks through workflows
// - Identifies breakage
// - Tests responsive design
```

#### Systematic QA Testing
```typescript
You: /qa
// Branch-aware testing:
// - Analyzes git diff
// - Identifies affected pages
// - Tests localhost:3000
// - Full exploration mode
// - Regression testing

You: /qa