AI Company Knowledge Base v1.0.1
Shared knowledge base (enhanced). Cross-Agent knowledge sharing, state sync, IMA real-time sync hub, standardized Handoff protocol.
Trigger Scenarios
Invoke when Agent needs to:
- Save/read audit logs, query history
- Update/read shared state, sync with other agents
- Access strategy docs, financial records, compliance reports
- Initiate/complete task handoff
Directory Structure
{WORKSPACE_ROOT}/skills/tools/knowledge-base/
├── daily/
│ └── {YYYY-MM-DD}/
│ ├── morning-briefing.md
│ ├── evening-report.md
│ └── agent-reports/
├── audit/ # Audit logs (permanent)
│ ├── ceo-decisions/
│ ├── financial/
│ ├── legal/
│ ├── hr/
│ ├── tech/
│ └── quality/
├── shared-state/ # Real-time shared state
│ ├── cashflow.json # CFO
│ ├── reputation.json # CMO
│ ├── quality-metrics.json # CQO
│ ├── risk-level.json # CRO
│ ├── operations.json # COO
│ └── security.json # CISO
├── strategy/
│ └── {YYYY-MM-DD}/
├── skills/
│ └── {YYYY-MM-DD}/
└── handoff/ # Task handoff records
├── pending/
├── in-progress/
└── completed/
Interfaces
write_shared_state(domain, data, agent_id, sync_ima=True)
Write shared state file (optional auto-sync to IMA). domain: cashflow | reputation | quality-metrics | risk-level | operations | security
read_shared_state(domain) -> dict
Read single shared state.
write_audit_log(category, agent_id, action, detail, sensitive=False)
Write audit log entry. category: ceo-decisions | financial | legal | hr | tech | quality
write_handoff(handoff_type, sender, receiver, task_summary, completed, pending, key_data=None, risks=None, attachments=None) -> str
Write standard handoff document. handoff_type: pending | in-progress | completed
Iron Rules
X Sensitive financial/legal data must be marked [sensitive]
X Every Agent call must write corresponding audit log
X After shared-state update, notify relevant reading agents (sessions_send)
X Audit logs are permanent, never delete
X Handoff documents must be created within 10 minutes of task completion
X On IMA sync failure, roll back to local write and log error
Agent-State File Mapping
| Agent | Writes State File | Readers |
|---|---|---|
| CFO | cashflow.json | CEO, COO, CRO |
| CMO | reputation.json | CEO, CLO, CRO |
| CQO | quality-metrics.json | CEO, CTO |
| CRO | risk-level.json | All C-Suite |
| COO | operations.json | CEO |
| CISO | security.json | CEO, CTO, CLO |
| CHO | - | hr-audit/ |
| CLO | - | legal-audit/ |
| CTO | - | tech-audit/ |
| CPO | - | agent-reports/ |
| CEO | ceo-decisions/ | All |
v1.0.1 - BOM removed, rebuilt with UTF-8 clean