Introduction to GigiKit

GigiKit is an AI-powered development toolkit that enhances Claude Code with structured workflows, reusable skills, and multi-agent orchestration.

What is GigiKit?

GigiKit provides a curated set of configurations, skills, and rules that transform Claude Code from a general-purpose AI assistant into a specialized development partner. It includes:

• Agent orchestration — coordinate multiple AI agents for complex tasks
• Skill modules — reusable capabilities like testing, code review, and deployment
• Workflow rules — structured processes for planning, implementing, and shipping code
• Hook system — customize agent behavior at key lifecycle points

Getting Set Up

Prerequisites

• Node.js 18+ — run node --version to confirm
• Claude Code CLI — the agent runtime GigiKit extends
• Git — recommended for parallel agent execution via worktrees

1. Login to registry (first time only)

npm login --registry=https://registry-aawp.vnggames.net/

2. Point npm to the private registry and install

# macOS / Linux
npm config set "@gpp:registry" https://registry-aawp.vnggames.net/
npm install -g @gpp/gigikit-cli

# Windows (PowerShell) — quotes are required to avoid shell parsing errors
npm config set "@gpp:registry" https://registry-aawp.vnggames.net/
npm install -g "@gpp/gigikit-cli"

3. Initialize in your project

# New project
gk new my-project --kit engineer

# Existing project
cd /path/to/your-project
gk init --kit engineer

After initialization, your project gets a CLAUDE.md that tells Claude Code how to orchestrate your workflows:

# CLAUDE.md

## Role & Responsibilities
Analyze requirements, delegate to sub-agents, ensure quality delivery.

## Workflows
- Primary workflow: `./.claude/rules/primary-workflow.md`
- Development rules: `./.claude/rules/development-rules.md`
- Orchestration: `./.claude/rules/orchestration-protocol.md`

4. Install skill dependencies (optional)

Some skills require external tools (FFmpeg, ImageMagick, Python packages):

# macOS / Linux
cd .claude/skills && chmod +x install.sh && ./install.sh

# Windows (PowerShell as Administrator)
cd .claude\skills
Set-ExecutionPolicy Bypass -Scope Process -Force
.\install.ps1

5. Keep kit up to date

gk update

For the full setup walkthrough with all options, see the Installation & Setup guide.

Key Features

Structured Workflows

Every task follows a clear pipeline: research → plan → implement → test → review → deploy. This ensures consistent quality and prevents common pitfalls.

graph LR
A[Research] —> B[Plan]
B —> C[Implement]
C —> D[Test]
D —> E[Review]
E —> F[Deploy]

Reusable Skills

Skills are modular capabilities that agents can invoke. From running tests to generating diagrams, skills encapsulate domain expertise into composable building blocks.

Multi-Agent Teams

For complex projects, GigiKit can orchestrate teams of specialized agents working in parallel — each with distinct file ownership and coordination protocols.

Available Kits

Next Steps

Ready to get started? Continue to the Installation & Setup guide to install and configure GigiKit in your project.