Skip to content

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. стилістика взаємодії,

  4. етичні правила.

  5. Проєкту

  6. специфічні для конкретної роботи,

  7. права агентів у межах проєкту,

  8. ритуали перевірки прогресу.

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

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

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 забезпечує гармонію роботи людей і агентів.