Концепциялар

Loadout

Loadout — өнімнің метафорасы: AI-құралдармен жұмыс жасайтын әзірлеушінің толық оқ қорамсасы. Оған дағдылар, MCP серверлері және AI орталарын жұмысқа дайын ететін параметрлер кіреді.

aiman sync командасы — жаңа машинада бұл қорамсаны жылдам қайта зарядтайды.

Болашақта loadout сонымен қатар техникалық сущность болады: инвентарьдың атаулы бөлтопшасы, мысалы Documentation Work немесе Architecture Work. Ағымдағы MVP-да мұндай мүмкіндік жоқ: AIM барлық жарамды инвентарьды тұтасымен қолданады.

Inventory

Inventory (инвентарь) — AIM пайдаланушының AI орталарына қолданатын файлдары бар Git репозиторийі.

Ағымдағы үлгіде инвентарь мыналарды қамтиды:

• skills/ — дағдылар;
• mcp/ — MCP серверлері;
• aim.yaml — жалпы конфигурация;
• .gitignore — кем дегенде aim.local.yaml-ды шығарып тастайды;
• aim.local.yaml — әр машинадағы жергілікті файл, Git-ке сақталмайды.

Library Item

Library Item — инвентарьдың бірлігі. Ағымдағы MVP-да екі тип бар: Skill Item және MCP Item.

Инвентарьдағы орынға кандидат — AI орталары өнеркәсіптік стандарт ретінде қабылдаған сущность: оның тұрақты форматы бар, оны бірнеше өндіруші қолдайды және оны орталар арасында елеулі өзгертулерсіз тасымалдауға болады. Мұндай сущность тасымалданатын актив ретінде мағынасы бар — оны орталықтандырып сақтап, адаптерлер арқылы қолданған жөн.

Skill Item

Skill Item — AI ортасына арналған Markdown нұсқаулығы.

Файл skills/<name>.md ретінде сақталады:

---
name: review-code
description: Дұрыстыққа баса назар аударып code review жүргіз
targets:
  - claude-code
  - cursor
tags:
  - review
---

# Role

...

Қолданғаннан кейін AIM дағдыны нақты AI ортасы күтетін форматта орнатады.

MCP Item

MCP Item — MCP серверінің YAML сипаттамасы:

name: context7
description: MCP арқылы кітапхана құжаттамасы
command: npx
args:
  - -y
  - "@upstash/context7-mcp"
targets:
  - claude-code
  - cursor
  - codex
env:
  - name: API_KEY
    description: API key
    required: true

Env айнымалыларының мәндері Git-ке сақталмайды. AIM оларды жергілікті сұрайды және aim.local.yaml-да сақтайды.

Болашақтағы мүмкін түрлер

AI орталары жаңа стандарттар туралы келіскен сайын инвентарьға қосымша түрлер кіруі мүмкін.

Субагент нұсқаулығы. Claude Code субагент нұсқаулықтарын қазірдің өзінде қолдайды. Codex CLI мен Cursor бұл форматты қабылдаған кезде, ол дербес Library Item бола алады.

Жоба/каталог жүйелік нұсқаулығы. Claude Code оны CLAUDE.md-да, Codex — AGENTS.md-да сақтайды, Cursor екі файлды да оқиды. Бұл нұсқаулықтар іс жүзінде ұқсас форматқа жақындап жатыр. Болашақта AIM мұндай нұсқаулықты бірыңғай актив ретінде сақтап, sync кезінде адаптерлер арқылы орталарға бөле алады.

Ағымдағы MVP-да бұл түрлердің ешқайсысы жүзеге асырылмаған. Library Item — тек Skill Item немесе MCP Item.

Инвентарьды жинау

Инвентарьды басқарудың алдында оны толтыру керек. AIM элементтер қосудың екі тәсілін қолдайды.

aiman add — жергілікті файлдан немесе stdin-нен:

aiman add skill cool-skill.md
cat prompt.md | aiman add skill -

aiman add mcp jira.yaml
cat jira.yaml | aiman add mcp -

MCP сервері қосылған кезде AIM файлдан env айнымалыларының нақты мәндерін автоматты түрде шығарып, aim.local.yaml-да сақтайды — инвентарьға (және Git-ке) тек секретсіз дескрипторлар түседі.

aiman import — орнатылған AI ортасынан:

aiman import skill review-code --from claude-code
aiman import skill my-prompt --from codex

aiman import mcp context7 --from claude-code
aiman import mcp jira --from cursor --dry-run

MCP серверін импорттаған кезде AIM AI ортасының тірі конфигурациясын оқып, env-strip қолданады және дескрипторды mcp/<name>.yaml-ға жазады. Env айнымалыларының нақты мәндері aim.local.yaml-ға түседі, бірақ Git-ке емес.

Элемент қосылғаннан кейін ол жергілікті инвентарьда пайда болады (skills/<name>.md немесе mcp/<name>.yaml). Жариялау үшін aiman push пайдаланыңыз.

Нақты командалар мен флагтар туралы — CLI анықтамалығында.

Adapter

Adapter — нақты AI ортасының форматын білетін AIM бөлігі.

Адаптер мыналарға жауапты:

• AI ортасының базалық каталогын анықтауға;
• aiman import skill кезінде дағдыларды сканерлеуге — адаптер AI ортасының дағдыларды қайда сақтайтынын біледі;
• aiman import mcp кезінде MCP конфигурациясын сканерлеуге — адаптер ортаның тірі конфигурациясын оқиды;
• Skill Item орнатуға;
• MCP серверін тиісті JSON немесе TOML конфигіне жазуға.

Қолдау көрсетілетін орталар:

• Claude Code;
• Cursor;
• Codex CLI.

apply, push және sync

aiman apply Git операцияларынсыз ағымдағы жергілікті жұмыс ағашын қолданады. Бұл дағды әзірлеудің ішкі циклы.

aiman push инвентарьды валидациялайды, commit жасайды және өзгерістерді қашықтағы репозиторийге жібереді. Бұл — жариялау.

aiman sync Git-тен жарияланған күйді алып, жергілікті AI орталарына қолданады. Бұл — басқа машинаға тасымалдау немесе ағымдағыны жаңарту.

aim.local.yaml

aim.local.yaml әр машинада жеке жасалады және Git-ке түспейді.

Онда мыналар сақталады:

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

Hash белгілері ақпараттық сипатта: олар күйді түсіндіруге көмектеседі, бірақ push пен sync-тің қауіпсіздігі Git күйіне сүйенеді.

---

Одан әрі

• Жұмыс циклдары — инвентарьды жинау, жариялау және синхрондау.
• AI орталары — қолдау көрсетілетін адаптерлер және анықтау жолдары.
• Репозиторий құрылымы — инвентарьдың толық форматы.
• CLI анықтамалығы — барлық командалар.