ai-workspace-template

<p align="center">
  <a href="#"><img src=".ai-workspace/docs/images/icon.png" alt="AI Workspace Template" width="128"></a>
</p>

# AI Workspace Template

A unified, multi-repo workspace for AI coding agents and developers.

Unified instructions, docs, skills, and commands — one source of truth across Claude Code, Cursor, OpenCode, and more.

📖 [**Documentation**](https://michaelyochpaz.github.io/ai-workspace-template/)

## The Problem

AI agents work great inside a single repo. But real projects span multiple repositories, and that's where things break down — agents can't see code in other repos, don't know what branch each one is on, and can't coordinate changes across boundaries. Your AI configuration ends up duplicated and out of sync across tools.

```mermaid
flowchart TB
    subgraph workspace[" AI Workspace "]
        config["AGENTS.md · Agent Docs · Skills · Commands"]
        repos["backend · frontend · infra"]
    end

    workspace -- "full context at session start" --> agent(["🤖 AI Agent"])
```

## ✨ Features

- **📂 Cross-repo visibility** — All your repositories live as git submodules in one workspace. Agents see everything.

- **📋 Modular agent docs** — Write focused documentation in `agent-docs/` that agents selectively read based on task relevance. Dozens of docs, minimal token usage.

- **🔍 Tool discovery** — Define CLI tools your team uses (`gh`, `glab`, `jq`, etc.). The workspace detects what's installed and tells agents how to use them — automatically, at session start.

- **⚡ Skills & commands** — Define once in `skills/` and `commands/`, distribute automatically to every AI tool's expected directory. One source of truth.

- **🔄 Auto-generated AGENTS.md** — Your agent instructions, doc listings, and workspace config are merged from templates on every commit. Always in sync, never stale.

- **📊 Repository status** — At session start, agents are told each repo's branch, uncommitted changes, and how far behind the remote. No more "which bran