Key concepts
Agent OS is built around a few core ideas: standards capture your conventions, profiles organize them across projects, and a simple file structure keeps everything accessible.
Standards
Standards are declarative documentation of your coding conventions. They describe patterns and rules—"our API responses use this format"—without prescribing procedures.
Standards live in agent-os/standards/ and are indexed in index.yml for quick matching.
Standards vs Skills
Standards describe what conventions to follow. Skills describe how to do tasks. Understanding when to use each helps you organize your tooling effectively.
Profiles
Profiles are named collections of standards in your base installation. They let you maintain different standards sets for different project types and share them across projects.
File structure
Agent OS creates a specific folder structure in your project. Understanding what goes where helps you maintain and extend it.
Stay updated on Agent OS
Get notified of major new releases and updates to Agent OS.