# florianbruniaux/claude-cowork-guide architecture

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

- Interactive diagram: https://gitdiagram.com/florianbruniaux/claude-cowork-guide
- Repository: https://github.com/florianbruniaux/claude-cowork-guide

## Overview

#### Purpose and Delivery Model
This is a documentation/content repository for Claude Cowork, Anthropic’s desktop assistant, aimed at knowledge workers and small businesses. It distributes guided learning, copy-paste prompts, and operational workflow playbooks rather than executable application code. The primary entry point is `README.md`, with French parity via `README.fr.md`.

#### User Onboarding and Core Guides
The canonical learning sequence introduces Cowork, setup, capabilities, security, and troubleshooting. These documents establish operating boundaries: local folder access, human approval of plans, backup before deletion, and avoiding credentials in accessible folders.
- `guide/00-overview.md`
- `guide/01-getting-started.md`
- `guide/03-security.md`

#### Workflow Playbook Library
The main actionable content is a catalog of business workflows. Each workflow translates a business objective into a repeatable Cowork interaction, typically involving user-provided local files and generated outputs. The workflow index is the discovery boundary, while individual documents provide domain-specific instructions.
- `workflows/README.md`
- `workflows/file-organization.md`
- `workflows/invoice-generation.md`

English variants are maintained beside the primary workflow files (for example, `workflows/file-organization.en.md`), indicating a bilingual publication pipeline.

#### Prompt and Template Assets
Prompt collections provide reusable task instructions for file operations, document creation, extraction/OCR, and research. Persona-oriented Claude configuration examples supplement these with role-specific starting points. These are static consumable assets, not runtime prompt execution code.
- `prompts/file-ops.md`
- `prompts/data-extraction.md`
- `examples/claude-md-templates/consultant.md`

#### Reference and Interactive Navigation
Reference material supports quick lookup and product evaluation; an onboarding prompt supplies a personalized navigation mechanism within Cowork. This layer connects users from general onboarding to appropriate workflow or prompt assets.
- `reference/cheatsheet.md`
- `reference/faq.md`
- `tools/onboarding-prompt.md`

#### Machine-Readable Release and Knowledge Surface
Structured YAML and LLM-oriented text expose repository metadata and release information to automation or AI consumers. Root metadata anchors release/version identity.
- `machine-readable/reference.yaml`
- `machine-readable/claude-cowork-releases.yaml`
- `MANIFEST.yaml`

#### Maintenance, Validation, and Distribution
Shell scripts maintain translation consistency, synchronize version references, and update repository statistics. GitHub Actions invokes translation validation on repository changes. Release-maintenance instructions are available as Claude/Cowork command and agent skill assets.
- `scripts/check-translations.sh`
- `.github/workflows/translation-check.yml`
- `.claude/commands/cowork/update-releases.md`

#### Runtime and External Boundaries
There is no deployed application runtime. Content is consumed in Claude Desktop on macOS and Windows, requiring Pro or Max subscriptions. Cowork is the execution environment: it receives prompts/files and sends them to Anthropic services; users grant filesystem access and review proposed operations. Documented external integrations include Asana, Canva, Cloudflare, Figma, GitHub, Google Drive, Jira, Linear, Notion, Sentry, and Slack.

Main entry points: [`tools/onboarding-prompt.md`](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/tools/onboarding-prompt.md) (Onboarding navigator), [`workflows/README.md`](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/README.md) (Workflow catalog), [`guide/00-overview.md`](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/guide/00-overview.md) (Core guides), [`prompts/file-ops.md`](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/prompts/file-ops.md) (Prompt collections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning & navigation"]
  node_readme["Repository entry point<br/>documentation<br/>[README.md]"]
  node_readme_fr["French entry point<br/>documentation<br/>[README.fr.md]"]
  node_core_guides["Core guides<br/>guide series<br/>[00-overview.md]"]
  node_security["Security guidance<br/>security guide<br/>[03-security.md]"]
  node_onboarding_prompt["Onboarding navigator<br/>interactive prompt"]
  node_reference["Quick reference<br/>reference docs<br/>[cheatsheet.md]"]
end

subgraph group_workflows["Workflow library"]
  node_workflow_index["Workflow catalog<br/>workflow index<br/>[README.md]"]
  node_file_organization["File organization<br/>workflow playbook"]
  node_invoice_generation["Invoice generation<br/>workflow playbook"]
  node_translations["English workflow variants<br/>localized content"]
end

subgraph group_assets["Reusable assets"]
  node_prompts["Prompt collections<br/>prompt assets<br/>[file-ops.md]"]
  node_persona_templates["Persona templates<br/>Claude configuration examples<br/>[consultant.md]"]
end

subgraph group_publication["Release &amp; maintenance"]
  node_manifest["Release manifest<br/>repository metadata<br/>[MANIFEST.yaml]"]
  node_machine_reference["Machine-readable reference<br/>YAML knowledge surface<br/>[reference.yaml]"]
  node_release_data["Release data<br/>YAML release catalog"]
  node_translation_check["Translation validation<br/>maintenance script"]
  node_github_action{{"Translation CI<br/>GitHub Actions workflow"}}
  node_release_command["Release update command<br/>Claude command asset<br/>[update-releases.md]"]
end

node_cowork["Claude Cowork<br/>desktop execution environment"]
node_anthropic_services(("Anthropic services<br/>external AI service"))
node_local_files[("User local files<br/>user-controlled filesystem")]
node_integrations(("External integrations<br/>connected services"))

node_readme -->|"starts learning sequence"| node_core_guides
node_readme_fr -.->|"French parity"| node_core_guides
node_core_guides -->|"establishes safeguards"| node_security
node_core_guides -->|"continues to navigation"| node_onboarding_prompt
node_onboarding_prompt -->|"routes to playbooks"| node_workflow_index
node_onboarding_prompt -->|"routes to prompts"| node_prompts
node_onboarding_prompt -->|"routes to lookup"| node_reference
node_workflow_index -->|"indexes"| node_file_organization
node_workflow_index -->|"indexes"| node_invoice_generation
node_translations -.->|"English variant"| node_file_organization
node_prompts -->|"complemented by"| node_persona_templates
node_translation_check -->|"validates"| node_translations
node_github_action -->|"invokes on changes"| node_translation_check
node_release_command -->|"maintains"| node_release_data
node_manifest -->|"anchors version identity"| node_release_data
node_machine_reference -->|"exposes repository metadata"| node_manifest
node_cowork -->|"sends prompts and files"| node_anthropic_services
node_cowork -->|"uses approved access"| node_local_files
node_cowork -->|"connects to"| node_integrations
node_workflow_index -->|"playbooks are consumed in"| node_cowork
node_prompts -->|"prompts are consumed in"| node_cowork

click node_readme "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/README.md"
click node_readme_fr "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/README.fr.md"
click node_core_guides "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/guide/00-overview.md"
click node_security "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/guide/03-security.md"
click node_onboarding_prompt "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/tools/onboarding-prompt.md"
click node_reference "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/reference/cheatsheet.md"
click node_workflow_index "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/README.md"
click node_file_organization "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/file-organization.md"
click node_invoice_generation "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/invoice-generation.md"
click node_translations "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/file-organization.en.md"
click node_prompts "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/prompts/file-ops.md"
click node_persona_templates "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/examples/claude-md-templates/consultant.md"
click node_manifest "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/MANIFEST.yaml"
click node_machine_reference "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/machine-readable/reference.yaml"
click node_release_data "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/machine-readable/claude-cowork-releases.yaml"
click node_translation_check "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/scripts/check-translations.sh"
click node_github_action "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/.github/workflows/translation-check.yml"
click node_release_command "https://github.com/florianbruniaux/claude-cowork-guide/blob/main/.claude/commands/cowork/update-releases.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_readme,node_readme_fr,node_core_guides,node_security,node_onboarding_prompt,node_reference toneBlue
class node_workflow_index,node_file_organization,node_invoice_generation,node_translations toneAmber
class node_prompts,node_persona_templates toneMint
class node_manifest,node_machine_reference,node_release_data,node_translation_check,node_github_action,node_release_command toneRose
class node_cowork,node_anthropic_services,node_local_files,node_integrations toneNeutral
```

## Components

### Learning & navigation

- [Repository entry point](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/README.md): documentation · English entry point to the learning sequence. · `README.md`
- [French entry point](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/README.fr.md): documentation · French-parity entry point. · `README.fr.md`
- [Core guides](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/guide/00-overview.md): guide series · Overview, setup, and security boundaries for Cowork. · `guide/00-overview.md`
- [Security guidance](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/guide/03-security.md): security guide · Covers folder access, approvals, backups, and credential safety. · `guide/03-security.md`
- [Onboarding navigator](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/tools/onboarding-prompt.md): interactive prompt · Routes users to suitable repository resources inside Cowork. · `tools/onboarding-prompt.md`
- [Quick reference](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/reference/cheatsheet.md): reference docs · Cheatsheet and FAQ for lookup and evaluation. · `reference/cheatsheet.md`

### Workflow library

- [Workflow catalog](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/README.md): workflow index · Discovery boundary for business playbooks. · `workflows/README.md`
- [File organization](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/file-organization.md): workflow playbook · Guided local-file organization workflow. · `workflows/file-organization.md`
- [Invoice generation](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/invoice-generation.md): workflow playbook · Guided document-generation workflow. · `workflows/invoice-generation.md`
- [English workflow variants](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/workflows/file-organization.en.md): localized content · English files are maintained beside primary workflow documents. · `workflows/file-organization.en.md`

### Reusable assets

- [Prompt collections](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/prompts/file-ops.md): prompt assets · Reusable file-operation and data-extraction instructions. · `prompts/file-ops.md`
- [Persona templates](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/examples/claude-md-templates/consultant.md): Claude configuration examples · Role-specific Claude starting points. · `examples/claude-md-templates/consultant.md`

### Release & maintenance

- [Release manifest](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/MANIFEST.yaml): repository metadata · Anchors release and version identity. · `MANIFEST.yaml`
- [Machine-readable reference](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/machine-readable/reference.yaml): YAML knowledge surface · Structured metadata for automation and AI consumers. · `machine-readable/reference.yaml`
- [Release data](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/machine-readable/claude-cowork-releases.yaml): YAML release catalog · Machine-readable Claude Cowork release information. · `machine-readable/claude-cowork-releases.yaml`
- [Translation validation](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/scripts/check-translations.sh): maintenance script · Checks consistency between localized content. · `scripts/check-translations.sh`
- [Translation CI](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/.github/workflows/translation-check.yml): GitHub Actions workflow · Runs translation validation on repository changes. · `.github/workflows/translation-check.yml`
- [Release update command](https://github.com/florianbruniaux/claude-cowork-guide/blob/main/.claude/commands/cowork/update-releases.md): Claude command asset · Instructions for maintaining release information. · `.claude/commands/cowork/update-releases.md`

### Other components

- **Claude Cowork**: desktop execution environment · Users provide prompts and files, approve plans, and review operations.
- **Anthropic services**: external AI service
- **User local files**: user-controlled filesystem · Cowork access is explicitly granted by the user.
- **External integrations**: connected services · Includes productivity, design, developer, and collaboration tools.

## Connections

- Repository entry point → Core guides: starts learning sequence
- French entry point → Core guides: French parity
- Core guides → Security guidance: establishes safeguards
- Core guides → Onboarding navigator: continues to navigation
- Onboarding navigator → Workflow catalog: routes to playbooks
- Onboarding navigator → Prompt collections: routes to prompts
- Onboarding navigator → Quick reference: routes to lookup
- Workflow catalog → File organization: indexes
- Workflow catalog → Invoice generation: indexes
- English workflow variants → File organization: English variant
- Prompt collections → Persona templates: complemented by
- Translation validation → English workflow variants: validates
- Translation CI → Translation validation: invokes on changes
- Release update command → Release data: maintains
- Release manifest → Release data: anchors version identity
- Machine-readable reference → Release manifest: exposes repository metadata
- Claude Cowork → Anthropic services: sends prompts and files
- Claude Cowork → User local files: uses approved access
- Claude Cowork → External integrations: connects to
- Workflow catalog → Claude Cowork: playbooks are consumed in
- Prompt collections → Claude Cowork: prompts are consumed in