chore: organize documentation structure for monorepo
- 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
This commit is contained in:
Apple
404
docs/cursor/18_governance_access_agent.md
Normal file
404
docs/cursor/18_governance_access_agent.md
Normal file
@@ -0,0 +1,404 @@
|
||||
# 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 забезпечує гармонію роботи людей і агентів.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user