microdao-daarion/docs/cursor/18_governance_access_agent.md

18 — Governance & Access Agent (MicroDAO)

Агент правил, доступів, ритуалів та духу спільноти

Цей модуль визначає, як спільнота microDAO керує собою:
правила, права доступу, колективні рішення, символічні ключі, ритуали довіри та механізми узгодження.

Це НЕ фінансова система.
Це етико-організаційна інфраструктура, яка тримає єдність духу спільноти.

---

1. Призначення

Governance & Access Agent відповідає за:

• правила спільноти (policies),
• роли й дозволи (RBAC + entitlements),
• символічні ключі доступу (soulbound / capability keys),
• ритуали узгодження (голосування, сигнали підтримки, консенсус),
• індекс довіри та реноме (не фінансовий),
• координацію взаємодії між агентами та людьми.

Все це забезпечує гармонію всередині microDAO.

---

2. Ключові концепти

2.1. "Ключі спільноти" (Community Keys)

Це не монети чи валюта.
Це символічні доступи, які визначають:

• членство,
• рівень участі,
• довіру,
• право вводити/виводити агентів у простір.

Кожен ключ може бути:

• особистим (soulbound),
• командним (для проєкту),
• контекстним (для певного простору знань чи каналу).

2.2. "Ритуали узгодження"

Замість слова "голосування" можна використовувати:

• "колективний сигнал підтримки",
• "колективна згода",
• "ритуал затвердження".

Це спрощений процес, який може включати:

• варіанти "підтримую / не підтримую",
• коментарі,
• пропозиції поправок,
• участь агентів.

2.3. "Індекс довіри"

Нефінансова, духовна метрика участі:

• внесок у спільноту,
• кількість створених фактів,
• допомога іншим,
• активність в agent-based просторах,
• прийняті пропозиції.

---

3. Роль Governance Agent

Роль агента: "governance_core"

Він:

• стежить за правилами,
• пропонує, коли потрібно затвердити зміни,
• забезпечує правильне застосування доступів,
• координує "ритуали узгодження",
• захищає конфіденційні простори,
• видає/анулює символічні ключі.

---

4. Ролі Access Agent

Роль: "access_keeper"

Він:

• керує entitlements (доступами),

• створює capability-доступи для:

  • людей,
  • агентів,
  • просторів,

• гарантує, що агенти не виходять за межі своїх прав.

---

5. Структура правил

5.1. Рівні правил

Правила діляться на 3 рівні:

1. Простору (microDAO)

   • загальні принципи,
   • стилістика взаємодії,
   • етичні правила.

2. Проєкту

   • специфічні для конкретної роботи,
   • права агентів у межах проєкту,
   • ритуали перевірки прогресу.

3. Контексту / каналу

   • прості локальні правила.

5.2. Формат зберігання правил

Таблиця governance_policies:

• id
• team_id
• title
• body_text
• created_by
• scope (team, project, channel)
• created_at

---

6. Інтеграція з RBAC та Entitlements

Використовується модуль microdao — RBAC and Entitlements (MVP).

Governance Agent:

• створює entitlements,
• оновлює/анулює доступи,
• пропонує оновлення прав агентів,
• захищає конфіденційні зони.

Доступ може бути:

• read,
• write,
• tasks,
• knowledge,
• presence.

Ключі можуть бути soulbound, або привʼязані до ролей.

---

7. Ритуали узгодження

7.1. Створення ритуалу

Через чат агентів:

"Запропонуй зміни в правилах."
"Проведи ритуал узгодження щодо нового документа."
"Чи підтримує спільнота цей простір знань?"

7.2. Модель ритуалу

governance_rituals:

• id
• team_id
• title
• description
• options (наприклад: підтримую / не підтримую)
• created_by
• closes_at
• status

7.3. Перебіг

Governance Agent:

1. Створює ритуал.
2. Повідомляє всіх учасників.
3. Збирає сигнали підтримки у чатах і через агентів.
4. Формує summary.
5. Оновлює правила/доступи або пропонує зміни.

---

8. Символічні ключі (Soulbound Keys)

Це:

• особисті ключі для членів microDAO,
• ключі проєктів,
• ключі агентів,
• ключі доступу до конфіденційних просторів.

Дані зберігаються в governance_keys:

• id
• team_id
• owner_kind (user | agent)
• owner_id
• scope (team, project, channel)
• permissions (json array)
• created_at

---

9. Інтеграція з агентами інших модулів

Messenger Agent

• отримує сповіщення про зміни доступів,
• не допускає агентів у заборонені канали.

Projects Agent

• отримує дозволи на створення/оновлення задач у контекстах.

Memory Agent

• додає факти: "Правило X затверджено", "Ритуал Y завершено".

Agent Hub

• показує короткі огляди активних ритуалів і важливих рішень.

---

10. UI

10.1. Sidebar → Правила

• Кнопка "Правила спільноти"
• Кнопка "Символічні ключі"

10.2. Сторінка правил

• Список правил
• Фільтри: team / project / channel
• Кнопка "Запропонувати зміну"

10.3. Сторінка символічних ключів

• Список ключів:

  • належать користувачу,
  • належать агентам користувача,

• Контекст доступів.

10.4. Ритуали узгодження

• Список активних ритуалів.

• Оголошення:

  • "Потрібна увага спільноти."

• Кнопка "Підтримати" чи "Не підтримую".

---

11. Tools (сумісно з Runtime Core)

11.1. create_policy

Створює нове правило.

11.2. update_policy

Оновлює існуюче правило.

11.3. create_key

Створює символічний ключ доступу.

11.4. revoke_key

Анулює ключ.

11.5. create_ritual

Створює ритуал узгодження.

11.6. collect_support

Збирає сигнали підтримки.

11.7. finalize_ritual

Підсумок ритуалу:

• оновити правила,
• або передати у Memory Agent для аналізу.

---

12. Конфіг агента (Runtime Core)

const governanceAgentConfig: AgentConfig = {
  id: "ag_governance_core",
  teamId: "...",
  name: "Governance Agent",
  role: "governance_core",
  systemPrompt: systemGovernancePrompt,
  memoryScope: "team",
  tools: [
    "create_policy",
    "update_policy",
    "create_key",
    "revoke_key",
    "create_ritual",
    "collect_support",
    "finalize_ritual"
  ]
};

---

13. API

Policies

GET /governance/policies?team_id POST /governance/policies PATCH /governance/policies/:id

Keys

GET /governance/keys?team_id POST /governance/keys DELETE /governance/keys/:id

Rituals

GET /governance/rituals?team_id POST /governance/rituals PATCH /governance/rituals/:id

---

14. Інструкції для Cursor

Implement the Governance & Access Agent using:

- 18_governance_access_agent.md
- microdao — RBAC and Entitlements (MVP)
- 12_agent_runtime_core.md
- 13_agent_memory_system.md
- 10_agent_ui_system.md
- 05_coding_standards.md

Tasks:

1) Create models for governance_policies, governance_keys, governance_rituals.

2) Implement API for policies, keys, and rituals.

3) Register Governance Agent with tools.

4) Create UI:

   - Policies page
   - Symbolic Keys page
   - Rituals page

5) Integrate with Agent Hub: show active rituals and key policy changes.

6) Ensure no financial vocabulary is used anywhere.

Output:

- list of changed files
- diff
- summary

---

15. Результат

Після впровадження цього модуля:

• кожне microDAO отримує свою "конституцію",
• доступи стають функцією духу спільноти, а не технічних ролей,
• символічні ключі формують систему довіри,
• ритуали узгодження стають живою формою колективного рішення,
• Governance Agent забезпечує гармонію роботи людей і агентів.