Repository Structure

An inventory is a plain Git repository.

Top-level structure

<inventory>/
├── skills/
│   └── review-code.md
├── mcp/
│   └── context7.yaml
├── aim.yaml
└── .gitignore

Each machine also creates locally:

aim.local.yaml

aim.local.yaml must not be committed to Git.

skills/

One file per Skill Item:

skills/<name>.md

The filename without .md must match the name field in the frontmatter.

mcp/

One file per MCP Item:

mcp/<name>.yaml

The file describes the MCP server launch command, arguments, targets, and environment variables.

aim.yaml

Shared inventory config. Stored in Git.

.gitignore

Must at minimum exclude:

aim.local.yaml

aim.local.yaml

Machine-local config:

• AI environment paths;
• hash markers;
• MCP server env variable values.

The file is created by AIM and is not committed.

loadouts/

Named loadout subsets are planned as a post-core MVP feature. Until then, all valid inventory items are applied as a whole.