Skip to main content
Agent Teams Lite is a zero-dependency, pure Markdown orchestration pattern. Installation is simple: copy skill files and add orchestrator instructions to your tool’s configuration.

​
Installation Process

All installations follow the same pattern:
1

Run the installer

Clone the repository and run the interactive installer:
git clone https://github.com/gentleman-programming/agent-teams-lite.git
cd agent-teams-lite
./scripts/install.sh
The installer will prompt you to choose your AI coding assistant.
2

Add orchestrator instructions

After copying skills, add the orchestrator instructions to your tool’s configuration file. Each tool has a specific config location:
  • Claude Code: ~/.claude/CLAUDE.md
  • OpenCode: ~/.config/opencode/opencode.json
  • Gemini CLI: ~/.gemini/GEMINI.md
  • Codex: ~/.codex/agents.md
  • VS Code: .github/copilot-instructions.md
  • Antigravity: ~/.gemini/GEMINI.md or .agent/rules/
  • Cursor: .cursorrules
3

Verify installation

Open your AI assistant in any project and type:
/sdd-init
If the command is recognized, installation was successful.

​
Supported Tools

Claude Code

Full sub-agent support via Task tool

OpenCode

Full sub-agent support via Task tool

Gemini CLI

Inline skill execution

Codex

Inline skill execution

VS Code

Agent mode with context files

Antigravity

Native skill support

Cursor

Inline skill execution

​
Sub-Agent Support Levels

Different tools provide different levels of sub-agent support:

​
Full Sub-Agent Delegation

Claude Code and OpenCode support true sub-agent delegation via their Task tools. Each phase runs in a fresh context window, keeping the orchestrator lightweight. Benefits:
  • Minimal context compression
  • Better output quality per phase
  • Orchestrator stays lightweight for long sessions

​
Inline Skill Execution

Gemini CLI, Codex, VS Code, Antigravity, and Cursor run skills inline within a single context window. The orchestrator reads skill instructions directly. Benefits:
  • Simpler setup
  • Works everywhere
  • Still provides structured workflow

​
Quick Install Commands

​
Interactive Mode

cd agent-teams-lite
./scripts/install.sh

​
Non-Interactive Mode

./scripts/install.sh --agent claude-code

​
Persistence Options

Agent Teams Lite supports three artifact storage modes:

engram

Recommended. Persistent storage via Engram MCP server. Keeps your repository clean.

openspec

File-based artifacts in openspec/ directory. Only used when explicitly requested.

none

Ephemeral mode. No persistence. Results returned inline only.

​
Default Policy

  1. If Engram is available → use engram (recommended)
  2. If user explicitly asks for file artifacts → use openspec
  3. Otherwise → use none (no writes)
openspec is NEVER chosen automatically. It only activates when you explicitly request file-based artifacts.

​
What Gets Installed

The installer copies these files to your tool’s skill directory:

​
Skills

  • sdd-init/SKILL.md — Bootstrap project context
  • sdd-explore/SKILL.md — Investigate codebase
  • sdd-propose/SKILL.md — Create change proposal
  • sdd-spec/SKILL.md — Write specifications
  • sdd-design/SKILL.md — Technical design
  • sdd-tasks/SKILL.md — Task breakdown
  • sdd-apply/SKILL.md — Implement code (v2.0 with TDD)
  • sdd-verify/SKILL.md — Validate implementation (v2.0 with real tests)
  • sdd-archive/SKILL.md — Archive completed change

​
Shared Conventions

  • _shared/persistence-contract.md — Storage mode resolution
  • _shared/engram-convention.md — Engram artifact naming
  • _shared/openspec-convention.md — File structure reference

​
Additional Files (OpenCode Only)

  • sdd-*.md command files in ~/.config/opencode/commands/

​
Next Steps

Choose your AI coding assistant to see detailed installation instructions:

Claude Code

OpenCode

Gemini CLI

Codex

VS Code

Antigravity

Cursor

Build docs developers (and LLMs) love

Get started for freeTalk to us