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

docs/cursor/MISSING_DOCS_ANALYSIS.md

@@ -0,0 +1,178 @@
+# Аналіз відсутніх документів для microDAO2
+
+**Що вже є vs що не вистачає для повного розуміння архітектури**
+
+---
+
+## ✅ Що вже є (31 документ)
+
+### Фундамент (00-13) — ✅ Повний
+- Overview, Product Brief, Architecture, API, UI/UX, Coding Standards
+- Tasks, Testing Checklist
+- Agent System (Onboarding, Evolutionary, UI, LLM, Runtime, Memory)
+
+### Модулі (14-20) — ✅ Повний
+- Messenger, Projects, Followups, Co-Memory, Governance, Notifications, Integrations
+
+### Інтерфейс та системи (21-24) — ✅ Повний
+- Agent-Only Interface, Operator Modes, Domains/Wallet/DAO, Agent Cards
+
+### Інтеграція — ✅ Є
+- DAARION_city_integration.md
+- MVP_VERTICAL_SLICE.md
+
+---
+
+## ❌ Що не вистачає (критичне для старту)
+
+### 1. **24_access_keys_capabilities_system.md** ✅ СТВОРЕНО
+**Статус:** Створено першу версію
+
+**Що має містити:**
+- Універсальна система capability-ключів
+- Wallet Agent детальна специфікація
+- Embassy Module детальна специфікація
+- Runtime capability-check
+- Інтеграція з Governance Agent
+
+**Чому важливо:** Без цього неможливо реалізувати безпеку та доступи.
+
+---
+
+### 2. **DAARION_city_platforms_catalog.md** ✅ СТВОРЕНО
+**Статус:** Створено першу версію
+
+**Що має містити:**
+- Каталог всіх платформ (GreenFood, EnergyUnion, DAARWIZZ, Water Union, Essence Stream)
+- Агентські модулі кожної платформи
+- Ключі доступу для кожної платформи
+- Embassy Module інтеграція
+
+**Чому важливо:** Для розуміння повної екосистеми та інтеграції платформ.
+
+---
+
+### 3. **25_deployment_infrastructure.md** ✅ СТВОРЕНО
+**Статус:** Створено першу версію
+
+**Що містить:**
+- Deployment процес (local/dev/staging/prod)
+- Infrastructure setup (Postgres, NATS, API Gateway, Frontend, Object Storage)
+- Environment variables
+- Database migrations
+- CI/CD pipeline
+- Monitoring та logging
+- Backups & Restore
+- Rollout Strategies
+
+---
+
+### 4. **26_security_audit.md** ✅ СТВОРЕНО
+**Статус:** Створено першу версію
+
+**Що містить:**
+- Security best practices (16 категорій)
+- Authentication та authorization flow
+- Data encryption (E2EE)
+- Audit logging
+- Rate limiting
+- Vulnerability management
+- Incident Response playbooks
+- Compliance checklist
+
+---
+
+### 5. **27_database_schema_migrations.md** ✅ СТВОРЕНО
+**Статус:** Створено першу версію + SQL міграції (Варіант C)
+
+**Що містить:**
+- Повна схема БД (всі таблиці)
+- Migration стратегія (9 міграцій)
+- Seed data (seeds.sql з 25 capabilities)
+- Backup та restore (в 25_deployment_infrastructure.md)
+- SQL міграції готові до використання
+
+---
+
+## 📋 Що не вистачає (можна додати пізніше)
+
+### 6. **28_performance_optimization.md**
+- Caching стратегія
+- Database indexing
+- Query optimization
+- Frontend optimization
+- WebSocket optimization
+
+### 7. **29_error_handling_monitoring.md**
+- Error handling patterns
+- Monitoring setup
+- Alerting
+- Logging strategy
+- Error tracking (Sentry тощо)
+
+### 8. **30_api_full_specification.md**
+- Повна API специфікація для всіх модулів
+- OpenAPI 3.1 повна версія
+- WebSocket протокол
+- Rate limits
+- Error codes
+
+### 9. **31_testing_strategy.md**
+- Unit testing
+- Integration testing
+- E2E testing
+- Performance testing
+- Security testing
+
+### 10. **32_embassy_module_detailed.md**
+- Детальна специфікація Embassy Module
+- UI/UX для Embassy
+- Інтеграція з Wallet Agent
+- Capability management
+
+---
+
+## 🎯 Рекомендації перед стартом розробки
+
+### Критичні (треба додати):
+
+1. ✅ **24_access_keys_capabilities_system.md** — система ключів доступу
+2. ✅ **DAARION_city_platforms_catalog.md** — каталог платформ
+3. ⚠️ **25_deployment_infrastructure.md** — deployment процес
+4. ⚠️ **26_security_audit.md** — безпека
+5. ⚠️ **27_database_schema_migrations.md** — схема БД та міграції
+
+### Важливі (можна додати під час розробки):
+
+6. **28_performance_optimization.md**
+7. **29_error_handling_monitoring.md**
+8. **30_api_full_specification.md**
+9. **31_testing_strategy.md**
+10. **32_embassy_module_detailed.md**
+
+---
+
+## 📊 Пріоритети
+
+### Для MVP (перші користувачі):
+1. **24_access_keys_capabilities_system.md** — критично
+2. **DAARION_city_platforms_catalog.md** — важливо
+3. **27_database_schema_migrations.md** — важливо
+4. **25_deployment_infrastructure.md** — можна спростити для MVP
+5. **26_security_audit.md** — можна базовий рівень для MVP
+
+### Для production:
+- Всі документи з розділу "Критичні"
+- Документи з розділу "Важливі"
+
+---
+
+## ✅ Висновок
+
+**Мінімум для старту MVP:**
+- ✅ 24_access_keys_capabilities_system.md
+- ✅ DAARION_city_platforms_catalog.md
+- ⚠️ 27_database_schema_migrations.md (базова версія)
+
+**Решту можна додавати під час розробки або після MVP.**
+