AI tooling
How this repo is wired for AI agents — openspec workflow, the .ai/ skill registry, the surfaces inventory, and the AGENTS.md convention.
This section documents the machinery that lets humans and AI agents collaborate on the ITU monorepo without stepping on each other. It covers the openspec change workflow, the shared skill registry under .ai/, the surface inventory that keeps proposals honest, and the AGENTS.md convention that gives every agent a consistent entry point.
If you're new to the repo, start with the Quick Start to get the monorepo running locally — the AI tooling assumes a working checkout.
In this section
Openspec workflow
Proposal → design → specs → tasks → archive. How changes are scoped, planned, implemented, and retired.
Skills registry
What lives under .ai/skills/, how the manifest fans skills out to Claude, Codex, and Cursor.
Surfaces inventory
The .ai/surfaces.yaml catalogue of moving parts, and how proposals declare what they touch.
AGENTS.md convention
Canonical agent instructions, on-demand concepts/ loading, and why CLAUDE.md just @imports AGENTS.md.
Why read this?
If you're about to propose a non-trivial change, run an agent against the repo, or wire up a new provider, the pages in this section are the shortest path from zero to a correct mental model. They exist because the repo is large, the agents are many, and consistency is cheaper than heroics.