docs-sync

Guilde Lite - Modern Dev Environment

Reproducible, automated development environment for AI/Agent development.

Quick Start

# Clone the repo
git clone https://github.com/YOUR_ORG/guilde-lite.git ~/guilde-lite
cd ~/guilde-lite

# Run bootstrap (choose one)
./install.sh              # Default: all Homebrew + runtimes + configs
./install.sh minimal      # Core + CLI + runtimes only
./install.sh developer    # Minimal + terminal + containers
./install.sh full         # Everything including AI and databases

Staged Installation

Install incrementally to test each step:

# Run stages individually
task stage:1              # Core (git, jj, just, mise, task)
task stage:2              # CLI tools (ripgrep, fd, bat, etc.)
task stage:3              # Terminal (Ghostty, tmux, fonts)
task stage:4              # Containers (OrbStack, kubectl, helm)
task stage:5              # Database clients (psql, redis-cli)
task stage:6              # Cloud/AWS (awscli, granted)
task stage:7              # AI tools (Cursor)
task stage:8              # Security (age, sops, trivy)
task stage:9              # Build tools (cmake, ninja)
task stage:runtimes       # Languages (Go, Python, Rust, Bun)
task stage:configs        # Config files (shell, git, tmux)
task stage:databases      # Start database containers
task stage:ai-tools       # Claude Code

# Verify any stage
task stage:1:verify
task stage:2:verify
# etc.

# See all stages
task help:stages

Preset Bundles

Bundle	What's Included
setup:minimal	Core + CLI + runtimes
setup:developer	Minimal + terminal + containers + build
setup:full	Everything including AI and databases

What's Included

Modern Tooling (Native Drop-in Replacements)

Legacy	Modern	Purpose
nvm/pyenv/goenv	mise	Universal runtime version manager
npm/yarn	bun	JS runtime + package manager
pip/pip-tools	uv	Fast Python package manager
Docker Desktop	OrbStack	Lightweight container engine
grep	ripgrep	Fast search
find	fd	Fast file finder
cat	bat	Syntax-highlighted file viewer
ls	eza	Modern file listing
make	Task	Go-based task runner

Languages & Runtimes

• Go 1.24 - Orchestration, CLI tools, agents
• Rust - Systems programming, performance-critical code
• Python 3.12 - AI/ML, scripting, data processing
• Bun - JavaScript/TypeScript runtime
• Deno - Secure JS/TS runtime

AI Coding Tools

• Claude Code - Anthropic's CLI assistant
• Cursor - AI-native editor
• Additional tools via mise

Databases (with Vector Extensions)

• PostgreSQL 16 + pgvector - Relational + vector similarity
• Redis Stack - Cache + RediSearch + vector search
• MongoDB - Document store
• Qdrant - Purpose-built vector DB
• ChromaDB - Embedding database

Multi-Agent Workflow System

Guilde Lite includes a comprehensive multi-agent orchestration system for AI-assisted development, packaged as a Claude Code plugin.

Loading the Plugin

# Start Claude Code with the guilde-workflows plugin
claude --plugin-dir .

# Or add an alias to ~/.zshrc for convenience
alias claude-guilde='claude --plugin-dir /path/to/guilde-lite'

Quick Start

Once the plugin is loaded, use these commands:

/guilde-workflows:conductor-status      # View current track and progress
/guilde-workflows:conductor-new-track   # Start a new implementation track
/guilde-workflows:conductor-implement   # Work on current phase with TDD
/guilde-workflows:conductor-checkpoint  # Mark phase complete

Key Features

Feature	Description
12 Specialized Agents	Research (haiku), Development (sonnet), Review (opus)
10 Skills	Context loading, TDD phases, code review pipeline
7 Hookify Rules	Safety, TDD enforcement, doc sync reminders
Telemetry	OpenTelemetry metrics with Grafana dashboards

Agent Tiers

• Research (haiku): context-explorer, docs-researcher, codebase-analyzer
• Development (sonnet): spec-builder, frontend-developer, test-automator, database-optimizer
• Review (opus): code-reviewer, security-auditor, architect-reviewer

See docs/MULTI-AGENT-WORKFLOW.md for full documentation.

Commands

task              # List all commands
task setup        # Full environment setup
task verify       # Verify installation
task db:up        # Start databases
task db:down      # Stop databases
task lint         # Run all linters
task test         # Run all tests

AI Agent Sandboxing

Three levels of isolation to prevent AI agents from doing anything nefarious:

# Level 1: Basic (file/network restrictions)
task sandbox:basic -- claude

# Level 2: Container isolation
task sandbox:container -- claude