GStack: AI code factory from Y Combinator with Claude Code

GStack: Y Combinator's AI Code Factory for Turbocharging Development with Claude Code

Modern software development faces significant challenges in scaling and maintaining high productivity. In this context, the concept of leveraging artificial intelligence to automate coding and project management is gaining traction. Garry Tan, CEO of Y Combinator, introduced his approach to building an "AI worker factory" — GStack, a framework that enables developers to significantly increase the volume of generated code and manage a virtual team of AI agents powered by Claude Code. This article delves into GStack's architecture, its key components, and practical implementation aspects.

Garry Tan's AI Code Factory Concept

Garry Tan asserts that with AI agents, he can write tens of thousands of lines of code daily, managing a virtual team of over ten distinct roles. His GStack project is positioned as a "software creation factory," transforming Claude Code into a manageable team of virtual engineers. GStack is a completely free and open-source solution, distributed under the MIT license. Its target audience includes tech entrepreneurs, tech leads striving for strict quality control, and startups actively developing their products. It's a tool for those working with code solo or in small teams who need a scalable approach to developing new functionalities.

At GStack's core is Claude Code — a versatile AI assistant capable of reading and editing code, executing commands, and integrating with various development tools. Productive use of Claude Code requires a paid subscription. GStack extends its capabilities by providing a set of specialized skills.

Modular Approach to AI Agents: SKILL.md and GStack

A key feature of GStack is its modular architecture, based on the SKILL.md standard. SKILL.md is a widely adopted format for creating AI skills, where each file represents a specialized skill for an LLM agent. This approach allows the agent to focus on a specific task, avoiding "context pollution" and increasing the accuracy of instruction execution. Skills are organized into specialized directories, similar to using libraries in traditional programming.

Garry Tan emphasizes that skill specialization is critical. If an AI assistant is constantly asked to perform diverse tasks, it starts to "infer" user expectations. For instance, a request to "review a pull request" can be interpreted in various ways: checking formatting, deep structural analysis, or dependency identification. GStack's modular approach solves this problem by providing the agent with a clearly defined "mindset" and scope of responsibility for each task.

Within GStack, each skill represents a specific role, or "mode," with its unique context and objective. These modes are not merely operational states but rather specialized "personas" for AI agents. The true power of GStack is unleashed when these modes are combined in a specific sequence:

Planning mode: Focused on product development, user empathy, and long-term planning. Generates an internal document for other roles.
Engineering mode: Acts as a system architect, focusing on component interdependencies, reliability, and technical metrics, resisting feature creep.
Review mode: Operates like a meticulous engineer, searching for errors and verifying the success of CI/CD integrations.
Shipping mode: Thinks in checklists, rigorously ensuring all necessary steps are completed.
QA mode: Verifies the functionality and accessibility of user interfaces, and the relevance of tests.

The recommended command invocation chain for GStack is: /plan-ceo-review → /plan-eng-review → [Implement] → /review → /ship → /qa.

GStack Installation and Usage

To work with GStack, you'll need: Claude Code (with a Pro subscription or higher), Git, Bun v1.0+, and Node.js (for Windows). The most challenging step might be installing Claude Code itself, as it requires a subscription and may be unavailable in some regions without a VPN and an international phone number. Once you have access to Claude Code, GStack installation is performed with a single command:

Install gstack: run git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing, never use mcp__claude-in-chrome__* tools, and lists the available skills: /office-hours, /plan-ceo-review, /plan-eng-review, /plan-design-review, /design-consultation, /review, /ship, /browse, /qa, /qa-only, /design-review, /setup-browser-cookies, /retro, /investigate, /document-release, /codex, /careful, /freeze, /guard, /unfreeze, /gstack-upgrade. Then ask the user if they also want to add gstack to the current project so teammates get it.

This command clones the GStack repository into Claude Code's skills directory and runs the setup script. GStack does not install binaries into system directories or run background processes; it resides in the home folders ~/.claude/skills/ and ~/.gstack/. After installation and restarting Claude Code, the new skills become available as slash commands in the interface. GStack updates are performed using the /gstack-upgrade command, while uninstallation requires manually removing the following directories and symbolic links:

# Remove symlinks that Claude Code uses for skill discovery
rm -f ~/.claude/skills/gstack-*

# Remove the gstack installation directory
rm -rf ~/.claude/skills/gstack

# Optionally remove the config directory
rm -rf ~/.gstack

Key Takeaways

GStack is an open-source framework from the CEO of Y Combinator, leveraging Claude Code to create a scalable 'factory' for code generation.
Modular Approach: GStack utilizes the SKILL.md standard, specializing AI agents for specific tasks (Planning, Engineering, Review, Shipping, QA) to enhance efficiency and accuracy.
AI Teamwork: The framework enables sequential interaction among multiple AI agents, each fulfilling its role in the development cycle.
Technical Requirements: Operation requires Claude Code Pro, Git, Bun v1.0+, and Node.js, along with addressing regional restrictions for Claude Code.
Productivity Boost: GStack aims to significantly increase coding output and automate routine tasks for developers and technical leads.

— Editorial Team