Skip to content

jahonn/dev-workflow-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Dev Workflow Skill

A structured 6-phase development sprint: Think → Plan → Build → Review → Test → Ship. Role-based subagents at each phase. Inspired by Garry Tan's gstack.

Works with any Agent Skills compatible tool: Claude Code, OpenAI Codex, Trae, Cursor, Gemini CLI, and more.

What This Is

gstack is Garry Tan's (CEO of Y Combinator) open-source software factory for Claude Code — 15 specialist roles and 6 power tools that turn Claude Code into a virtual engineering team.

This skill takes gstack's core insight — structured roles beat generic prompting — and packages it as a portable Agent Skill that works across 20+ AI coding tools, not just Claude Code.

What we kept from gstack:

  • The Think → Plan → Build → Review → Test → Ship workflow
  • Role-based subagent spawning (YC Coach, Eng Manager, Staff Engineer, QA Lead, Release Engineer)
  • Design doc as the central artifact that flows between phases
  • Paranoid review culture

What we changed:

  • Simplified from 15 skills to 6 phases (most people don't need all 15)
  • Made it tool-agnostic via Agent Skills standard
  • Focused on solo dev / small team use case
  • Added model selection guidance per phase

Phases

# Phase Role Spawns Output
1 Think YC Office Hours Coach Sonnet DESIGN.md
2 Plan Eng Manager Sonnet PLAN.md
3 Build Implementer Haiku/Sonnet Code + Tests
4 Review Staff Engineer Sonnet Review Report
5 Test QA Lead Sonnet Bug Report + Fixes
6 Ship Release Engineer Haiku PR / Deploy

Install

Via npm

npm install -g @jahonn/agentskills-cli
agentskills install ./dev-workflow-skill -t all

Via ClawHub (OpenClaw)

clawhub install gstack-workflow

Manual

Copy the skill directory to your tool's skill folder:

# Claude Code
cp -r dev-workflow-skill ~/.claude/skills/dev-workflow

# Codex
cp -r dev-workflow-skill ~/.codex/skills/dev-workflow

Usage

Full sprint

"Build me a [feature]" → runs all 6 phases
"Run dev-workflow on [description]"

Partial sprint

"Just review and ship this branch" → Review → Ship
"I have DESIGN.md, skip to Plan"

Single phase

"/think [idea]"
"/review"
"/ship"

How It Works

Each phase spawns a focused subagent with a specialized prompt. The subagent works in isolation, produces a structured artifact, and passes it to the next phase.

User idea → DESIGN.md → PLAN.md → Code → Review → Tests → PR
           (Think)     (Plan)    (Build) (Review) (Test)  (Ship)

Key principle: no code until the plan is approved. Challenge scope ruthlessly.

Frameworks Used

  • YC Office Hours — reframing problems before solving them
  • Amazon Working Backwards — press release before PRD
  • INVEST — user story quality criteria
  • RICE — feature prioritization

Credit

Built on the ideas from gstack by Garry Tan. gstack is MIT licensed. This skill is an independent implementation inspired by gstack's philosophy, not a fork.

Related

License

MIT

About

Structured 6-phase development workflow inspired by gstack. Think → Plan → Build → Review → Test → Ship with role-based subagents. Works with Claude Code, Codex, Trae, Cursor and 20+ AI tools

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors