\r \r

AI Company Knowledge Base v1.0.1\r

\r

Shared knowledge base (enhanced). Cross-Agent knowledge sharing, state sync, IMA real-time sync hub, standardized Handoff protocol.\r \r ---\r \r

Trigger Scenarios\r

\r Invoke when Agent needs to:\r

• Save/read audit logs, query history\r
• Update/read shared state, sync with other agents\r
• Access strategy docs, financial records, compliance reports\r
• Initiate/complete task handoff\r \r

Directory Structure\r

\r

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