c552199eed
- Create /docs structure (microdao, daarion, agents) - Organize 61 cursor technical docs - Add README files for each category - Copy key documents to public categories - Add GitHub setup instructions and scripts
405 lines
10 KiB
Markdown
405 lines
10 KiB
Markdown
# 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)
|
||
|
||
```ts
|
||
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 забезпечує гармонію роботи людей і агентів.
|
||
|
||
|