# automatedmarketer/cowork-ai-os architecture

> Architecture diagram of the GitHub repository automatedmarketer/cowork-ai-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/automatedmarketer/cowork-ai-os
- Repository: https://github.com/automatedmarketer/cowork-ai-os

## Overview

Cowork AI OS is a Claude Cowork plugin that guides users through configuring a personalized AI workspace, then supports daily work and ongoing upkeep. Its main workflow is onboarding: the user completes guided setup, configures identity and working preferences, and gets recommendations for skills and connectors. Daily-brief and communication skills support recurring work; browsing, auditing, optimization, and skill-building provide discovery and maintenance capabilities. The README documents these capabilities, but no product source excerpts were provided, so edges below reflect only README-stated relationships.

Main entry points: [`cowork-ai-os/skills/onboard/SKILL.md`](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard/SKILL.md) (Guided onboarding), [`cowork-ai-os/skills/browse-skills/SKILL.md`](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/browse-skills/SKILL.md) (Skill discovery), [`cowork-ai-os/skills/browse-connectors/SKILL.md`](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/browse-connectors/SKILL.md) (Connector discovery), [`cowork-ai-os/skills/onboard`](https://github.com/automatedmarketer/cowork-ai-os/tree/main/cowork-ai-os/skills/onboard) (Identity setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Guided setup"]
  node_onboard["Guided onboarding<br/>[SKILL.md]"]
  node_identity["Identity setup"]
  node_daily_setup["Daily brief setup<br/>[SKILL.md]"]
  node_file_setup["File setup<br/>[SKILL.md]"]
  node_connector_setup["Connector setup<br/>[05-connectors.md]"]
end

subgraph group_discovery["Discovery"]
  node_browse_skills["Skill discovery<br/>[SKILL.md]"]
  node_browse_connectors["Connector discovery<br/>[SKILL.md]"]
  node_community_skills{{"Community plugins"}}
  node_mcp_connectors{{"MCP connectors"}}
end

subgraph group_work["Daily work"]
  node_morning_brief["Morning brief<br/>[SKILL.md]"]
  node_brief_comms["Brief communications<br/>[SKILL.md]"]
  node_voice_writer["Voice writing<br/>[SKILL.md]"]
  node_tidy_downloads["Tidy downloads<br/>[SKILL.md]"]
end

subgraph group_maintenance["System upkeep"]
  node_add_skill["Add skills<br/>[SKILL.md]"]
  node_audit["System audit<br/>[SKILL.md]"]
  node_optimize["Performance tuning<br/>[SKILL.md]"]
  node_tune_up["System tune-up<br/>[SKILL.md]"]
  node_level_up["Level up<br/>[SKILL.md]"]
end

node_user(("Cowork user"))

node_user -->|"starts setup"| node_onboard
node_onboard -->|"guides setup"| node_identity
node_onboard -->|"configures brief"| node_daily_setup
node_onboard -->|"configures folders"| node_file_setup
node_onboard -->|"sets connectors"| node_connector_setup
node_onboard -->|"invokes recommender"| node_browse_skills
node_onboard -->|"invokes recommender"| node_browse_connectors
node_browse_skills -->|"recommends plugins"| node_community_skills
node_browse_connectors -->|"recommends connectors"| node_mcp_connectors
node_user -->|"uses daily"| node_morning_brief
node_user -->|"uses for briefs"| node_brief_comms
node_user -->|"uses writing skill"| node_voice_writer
node_user -->|"uses file skill"| node_tidy_downloads
node_user -->|"builds skills"| node_add_skill
node_user -->|"runs upkeep"| node_audit
node_user -->|"tunes performance"| node_optimize
node_user -->|"runs upkeep"| node_tune_up
node_user -.->|"evolves setup"| node_level_up

click node_onboard "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard/SKILL.md"
click node_identity "https://github.com/automatedmarketer/cowork-ai-os/tree/main/cowork-ai-os/skills/onboard"
click node_daily_setup "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard-daily-brief/SKILL.md"
click node_file_setup "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard-file-organization/SKILL.md"
click node_connector_setup "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard/phases/05-connectors.md"
click node_browse_skills "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/browse-skills/SKILL.md"
click node_browse_connectors "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/browse-connectors/SKILL.md"
click node_morning_brief "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/morning-brief/SKILL.md"
click node_brief_comms "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/brief-source-comms/SKILL.md"
click node_voice_writer "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/voice-writer/SKILL.md"
click node_tidy_downloads "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/tidy-downloads/SKILL.md"
click node_add_skill "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/add-skill/SKILL.md"
click node_audit "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/audit/SKILL.md"
click node_optimize "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/optimize/SKILL.md"
click node_tune_up "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/tune-up/SKILL.md"
click node_level_up "https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/level-up/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_onboard,node_identity,node_daily_setup,node_file_setup,node_connector_setup,node_user toneBlue
class node_browse_skills,node_browse_connectors,node_community_skills,node_mcp_connectors toneAmber
class node_morning_brief,node_brief_comms,node_voice_writer,node_tidy_downloads toneMint
class node_add_skill,node_audit,node_optimize,node_tune_up,node_level_up toneRose
```

## Components

### Guided setup

- [Guided onboarding](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard/SKILL.md): `cowork-ai-os/skills/onboard/SKILL.md`
- [Identity setup](https://github.com/automatedmarketer/cowork-ai-os/tree/main/cowork-ai-os/skills/onboard): `cowork-ai-os/skills/onboard`
- [Daily brief setup](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard-daily-brief/SKILL.md): `cowork-ai-os/skills/onboard-daily-brief/SKILL.md`
- [File setup](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard-file-organization/SKILL.md): `cowork-ai-os/skills/onboard-file-organization/SKILL.md`
- [Connector setup](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/onboard/phases/05-connectors.md): `cowork-ai-os/skills/onboard/phases/05-connectors.md`

### Discovery

- [Skill discovery](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/browse-skills/SKILL.md): `cowork-ai-os/skills/browse-skills/SKILL.md`
- [Connector discovery](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/browse-connectors/SKILL.md): `cowork-ai-os/skills/browse-connectors/SKILL.md`
- **Community plugins**
- **MCP connectors**

### Daily work

- [Morning brief](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/morning-brief/SKILL.md): `cowork-ai-os/skills/morning-brief/SKILL.md`
- [Brief communications](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/brief-source-comms/SKILL.md): `cowork-ai-os/skills/brief-source-comms/SKILL.md`
- [Voice writing](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/voice-writer/SKILL.md): `cowork-ai-os/skills/voice-writer/SKILL.md`
- [Tidy downloads](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/tidy-downloads/SKILL.md): `cowork-ai-os/skills/tidy-downloads/SKILL.md`

### System upkeep

- [Add skills](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/add-skill/SKILL.md): `cowork-ai-os/skills/add-skill/SKILL.md`
- [System audit](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/audit/SKILL.md): `cowork-ai-os/skills/audit/SKILL.md`
- [Performance tuning](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/optimize/SKILL.md): `cowork-ai-os/skills/optimize/SKILL.md`
- [System tune-up](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/tune-up/SKILL.md): `cowork-ai-os/skills/tune-up/SKILL.md`
- [Level up](https://github.com/automatedmarketer/cowork-ai-os/blob/main/cowork-ai-os/skills/level-up/SKILL.md): `cowork-ai-os/skills/level-up/SKILL.md`

### Other components

- **Cowork user**

## Connections

- Cowork user → Guided onboarding: starts setup (evidence: `README.md`)
- Guided onboarding → Identity setup: guides setup (evidence: `README.md`)
- Guided onboarding → Daily brief setup: configures brief (evidence: `README.md`)
- Guided onboarding → File setup: configures folders (evidence: `README.md`)
- Guided onboarding → Connector setup: sets connectors (evidence: `README.md`)
- Guided onboarding → Skill discovery: invokes recommender (evidence: `README.md`)
- Guided onboarding → Connector discovery: invokes recommender (evidence: `README.md`)
- Skill discovery → Community plugins: recommends plugins (evidence: `README.md`)
- Connector discovery → MCP connectors: recommends connectors (evidence: `README.md`)
- Cowork user → Morning brief: uses daily (evidence: `README.md`)
- Cowork user → Brief communications: uses for briefs (evidence: `README.md`)
- Cowork user → Voice writing: uses writing skill (evidence: `README.md`)
- Cowork user → Tidy downloads: uses file skill (evidence: `README.md`)
- Cowork user → Add skills: builds skills (evidence: `README.md`)
- Cowork user → System audit: runs upkeep (evidence: `README.md`)
- Cowork user → Performance tuning: tunes performance (evidence: `README.md`)
- Cowork user → System tune-up: runs upkeep (evidence: `README.md`)
- Cowork user → Level up: evolves setup
