Репозиторий құрылымы

Inventory — қарапайым Git репозиторийі.

Жоғарғы деңгей құрылымы

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

loadouts/ каталогы міндетті емес: онсыз репозиторий толық жарамды.

Жергілікті деңгейде әр машинада да жасалады:

aim.local.yaml

aim.local.yaml Git-ке түспеуі керек.

skills/

Бір файл — бір Skill Item:

skills/<name>.md

.md жоқ файл атауы frontmatter-дегі name өрісімен сәйкес болуы керек.

Дағды қалта түрінде де сақтала алады — оны AI ортасынан келген қалталық дағды үшін aiman add skill <dir> және aiman import skill осылай жазады:

skills/<name>/SKILL.md
skills/<name>/references/...

Бұл жағдайда дағды атауын директория атауы белгілейді. Толығырақ — инвентарь форматында.

mcp/

Бір файл — бір MCP Item:

mcp/<name>.yaml

Файл MCP серверінің іске қосу командасын, аргументтерді, targets және env айнымалыларын сипаттайды.

aim.yaml

Инвентарьдың жалпы конфигурациясы. Git-ке сақталады.

.gitignore

Кем дегенде мыналарды алып тастауы керек:

aim.local.yaml

aim.local.yaml

Машинаның жергілікті конфигурациясы:

• AI орталарына жолдар;
• hash белгілері;
• MCP серверлерінің env айнымалыларының мәндері.

Файл AIM жасайды және commit жасалмайды.

loadouts/

Бір файл — бір Loadout Item, инвентарьдың атаулы ішкі жиыны:

loadouts/<name>.yaml

Мысал:

name: Documentation Work
description: Құжаттамамен жұмысқа арналған дағдылар мен MCP
targets:
  - claude-code
items:
  - skill:create-spec
  - skill:wpage
  - mcp:context7

Файл атауы туралы келісім: kebab-case; файл атауы — нормаланғаннан кейінгі name өрісі (бос орындар → дефис, кіші регистр). name: Documentation Work → loadouts/documentation-work.yaml. Сәйкессіздік — aiman push кезіндегі ескерту, қате емес.

Каталог міндетті емес. aiman init оны жасамайды — алғашқы loadout қажет болғанда өзіңіз жасаңыз.

Loadout aiman apply --loadout <name> командасымен қолданылады (CLI анықтамалығы); өрістердің форматы мен инварианттары — инвентарь форматында.

Жариялау. aiman push loadouts/ каталогын валидациялайды және бұл файлдарды skills/ мен mcp/ файлдарымен бірге жариялайды — бөлек git add командасының қажеті жоқ.