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