Team AI Directives Starter Kit

A forkable foundation for version-controlled AI agent behavior.

Built on the Twelve-Factor Agentic SDLC — this repository implements Factor XI: Directives as Code, treating all AI instructions as version-controlled assets.

How the pieces fit:

• 12-Factor Agentic SDLC — the methodology (strategic mindset, structured planning, directives as code, traceability)
• This repo — the version-controlled team knowledge base (constitution, personas, rules, skills, CDRs)
• agentic-sdlc-spec-kit — the Spec-Driven Development toolkit; consumes this knowledge base via the bundled team-ai-directives extension
• adlc-team-skills — agent skills that implement the methodology; consume this knowledge base via team-* skills

Quick Start: See GETTING_STARTED.md for a 5-minute setup guide.

Installation

This knowledge base is consumed in two ways at runtime — pick the one that matches your project setup. Fork and clone for authoring and customization.

Option 1: Spec Kit Projects

For projects managed with the Agentic SDLC Spec Kit, install via the specify CLI using the --team-ai-directives flag:

# Initialize project with team-ai-directives
specify init  --team-ai-directives https://github.com/your-org/team-ai-directives.git

The Specify CLI installs the bundled team-ai-directives extension (governance commands and skills) and copies this repository’s default domain skills into the agent’s skills directory. Context modules are referenced through the agent-context extension.

# Or from a specific release tag
specify init  --team-ai-directives https://github.com/your-org/team-ai-directives/archive/refs/tags/v1.3.0.zip

Option 2: Any Skills-Capable Agent

For agents that support the Agent Skills standard (Claude Code, Codex, OpenCode, Cursor, Gemini, and others), install the governance and architecture skills from adlc-team-skills:

# One command: install skills + configure team-ai-directives (runs /team-setup interactively)
npx adlc-cli team setup tikalk/adlc-team-skills -a opencode

# Or install skills only, then invoke /team-setup in your agent
npx skills add tikalk/adlc-team-skills

adlc-cli team setup installs the skills, generates slash commands, wires lifecycle events, and runs the /team-setup skill via agent run to clone, point at, or scaffold this knowledge base. The skills locate it via .adlc/init-options.json or the ADLC_TEAM_AI_DIRECTIVES environment variable.

Option 3: Authoring (Fork and Clone)