66 lines (44 loc) · 2.18 KB

Agent Adapter Contract v1

Purpose

Цей документ задає спільний contract для всіх adapter skill-ів у memory-system.

Required sequence

1. Intake

Adapter приймає user intent або task intent і визначає:

тему;
ключові сутності;
очікуваний результат;
потенційні зони змін.

2. Retrieval

Adapter повинен:

почати з memory/indexes/mem-index-vault.md;
знайти стартові вузли;
обійти links до глибини 2;
прочитати не більше 10 документів;
сформувати короткий робочий контекст.

3. Task execution

Основна робота виконується лише після retrieval.

4. Post-task write

Після завершення роботи adapter повинен:

пройти write gate;
вибрати merge або create;
оновити updated_at;
додати або оновити links;
перевірити, чи потрібне оновлення vault-index.

5. Consolidation boundary

Adapter:

оновлює canonical doc, якщо нова інформація прямо розширює його;
створює note, якщо є ризик конфлікту, паралельного редагування або недостатньої впевненості;
рекомендує consolidation, якщо накопичилося 3 або більше споріднених note.

Vault-index maintenance

Adapter повинен оновити vault-index, якщо створений або змінений документ є:

canonical concept
canonical context
active decision
active task
index або summary node

Prohibited behavior

читати весь vault без retrieval budget
створювати документ без schema v1 frontmatter
дублювати архітектурне знання в task
тихо переписувати історію старого decision
залишати canonical write без перевірки links і index impact