# cowork-reference.yaml
# Quick lookup for Claude Cowork - ~2K tokens target
# Source: guide/ documentation
# Purpose: Condensed index for LLMs to quickly answer user questions about Cowork

version: "1.6.1"
updated: "2026-04-01"
status: "research-preview"

# ════════════════════════════════════════════════════════════════
# CORE DOCUMENTATION - File paths for detailed info
# ════════════════════════════════════════════════════════════════
docs:
  hub: "README.md"
  overview: "guide/00-overview.md"
  getting_started: "guide/01-getting-started.md"
  capabilities: "guide/02-capabilities.md"
  security: "guide/03-security.md"
  troubleshooting: "guide/04-troubleshooting.md"
  cheatsheet: "reference/cheatsheet.md"
  faq: "reference/faq.md"
  comparison: "reference/comparison.md"
  glossary: "reference/glossary.md"

# ════════════════════════════════════════════════════════════════
# PROMPTS LIBRARY (70 ready-to-use)
# ════════════════════════════════════════════════════════════════
prompts:
  file_ops: "prompts/file-ops.md"  # 20 prompts
  document_creation: "prompts/document-creation.md"  # 15 prompts
  data_extraction: "prompts/data-extraction.md"  # 15 prompts
  research: "prompts/research.md"  # 17 prompts
  # FR versions mirror same structure with .fr.md suffix

# ════════════════════════════════════════════════════════════════
# WORKFLOWS (28 step-by-step guides)
# ════════════════════════════════════════════════════════════════
workflows:
  # Administrative (6)
  client_followup_tracker: "workflows/client-followup-tracker.md"
  compliance_checklist: "workflows/compliance-checklist.md"
  invoice_generation: "workflows/invoice-generation.md"
  payment_reminders: "workflows/payment-reminders.md"
  price_comparison: "workflows/price-comparison.md"
  quote_to_invoice: "workflows/quote-to-invoice.md"
  # Sales & Marketing (5)
  competitor_analysis: "workflows/competitor-analysis.md"
  newsletter_creation: "workflows/newsletter-creation.md"
  presentation_slides: "workflows/presentation-slides.md"
  prospect_research: "workflows/prospect-research.md"
  quote_creation: "workflows/quote-creation.md"
  # Operations (5)
  financial_model_validation: "workflows/financial-model-validation.md"
  inventory_tracking: "workflows/inventory-tracking.md"
  project_planning: "workflows/project-planning.md"
  quality_checklist: "workflows/quality-checklist.md"
  supplier_order: "workflows/supplier-order.md"
  # Communication (6)
  email_templates: "workflows/email-templates.md"
  knowledge_transfer: "workflows/knowledge-transfer.md"
  review_response: "workflows/review-response.md"
  social_media_posts: "workflows/social-media-posts.md"
  website_audit: "workflows/website-audit.md"
  workforce_planning: "workflows/workforce-planning.md"
  # Organization (6)
  expense_tracking: "workflows/expense-tracking.md"
  file_organization: "workflows/file-organization.md"
  meeting_prep: "workflows/meeting-prep.md"
  memory_setup: "workflows/memory-setup.md"
  scheduled_automation: "workflows/scheduled-automation.md"
  work_log: "workflows/work-log.md"

# ════════════════════════════════════════════════════════════════
# QUICK REFERENCE - Essential facts
# ════════════════════════════════════════════════════════════════
essentials:
  what: "Agentic desktop feature for knowledge workers - file manipulation without code"
  platform: "macOS and Windows (since Feb 10, 2026; Linux not announced)"
  subscription: "Pro ($17/mo annual, ~$20/mo monthly) or Max ($100-200/mo) - both have access"
  usage_limits: "Resets every 5 hours; Free ~9, Pro ~45, Max5x ~225, Max20x ~900 messages per window"
  context: "1M tokens beta (Opus 4.6), previously ~200K; context compaction extends sessions"
  output_tokens: "128K (Opus 4.6)"
  vpn_compatible: "NO - #1 issue, VM routing conflict"
  model: "Opus 4.6 with adaptive thinking (4 effort levels)"

# ════════════════════════════════════════════════════════════════
# CAN DO / CANNOT DO
# ════════════════════════════════════════════════════════════════
capabilities:
  can_do:
    - "Read/write local files in sandbox"
    - "Create Office docs (Word, Excel, PowerPoint)"
    - "Extract data from images (OCR)"
    - "Organize folders/files"
    - "Web research via Chrome (improved browser automation)"
    - "Generate PDFs"
    - "11 official plugins (Asana, Canva, Cloudflare, Figma, GitHub, Google Drive, Jira, Linear, Notion, Sentry, Slack)"
    - "Scheduled tasks (recurring automation)"
    - "Agent Teams (research preview - multi-agent coordination)"
    - "Context compaction (beta - longer sessions)"
    - "Direct Excel and PowerPoint integrations"
    - "Desktop Commander (cross-session memory + advanced file ops)"
  cannot_do:
    - "Execute code or scripts"
    - "Make API calls (except via plugins)"
    - "Access cloud storage directly (except Google Drive plugin)"
    - "Process audio/video"
    - "Work with VPN active"
    - "Run on Linux"
    - "Operate in background"

# ════════════════════════════════════════════════════════════════
# EXTENSIONS & PLUGINS
# ════════════════════════════════════════════════════════════════
extensions:
  claude_legal:
    announced: "2026-02-03"
    status: "First official Cowork extension"
    purpose: "Automated legal document review and risk detection"
    capabilities:
      - "Contract review and key term extraction"
      - "Risk and compliance issue identification"
      - "NDA and agreement triage"
      - "Regulatory compliance tracking"
    disclaimer: "Does NOT provide legal advice - review by qualified legal professional required"
    model_support: "Opus 4.6 achieved 90.2% on BigLaw Bench (Feb 2026)"

plugins:
  announced: "2026-01-30"
  count: 11
  list:
    - Asana
    - Canva
    - Cloudflare
    - Figma
    - GitHub
    - Google Drive
    - Jira
    - Linear
    - Notion
    - Sentry
    - Slack

# ════════════════════════════════════════════════════════════════
# PROMPTING FORMULA (CTOC)
# ════════════════════════════════════════════════════════════════
prompting:
  framework: "CTOC - Context → Task → Output → Constraints"
  context: "Background, files, situation"
  task: "Clear single objective"
  output: "Exact format and location"
  constraints: "Rules, limits, preferences"
  example: |
    CONTEXT: I have 50 receipts from Paris business trip in ~/Cowork-Workspace/input/receipts/
    TASK: Extract all expenses into a spreadsheet
    OUTPUT: Save as ~/Cowork-Workspace/output/paris-expenses.xlsx
    CONSTRAINTS: Use EUR currency, semicolon formulas, categorize by type

# ════════════════════════════════════════════════════════════════
# COMMON ERRORS - Exact messages + solutions
# ════════════════════════════════════════════════════════════════
errors:
  vm_timeout:
    message: "Failed to start Claude's workspace — VM connection timeout after 60 seconds"
    cause: "VPN active"
    solution: "Disconnect VPN completely before using Cowork"
  chrome_host:
    message: "Chrome native messaging host not found"
    cause: "Extension mismatch or missing host"
    solution: "Manual installation via bash (see troubleshooting doc)"
  context_limit:
    message: "Context limit reached"
    cause: "System overhead or very large tasks"
    actual_limit: "1M beta with Opus 4.6 (context compaction helps); previously ~165K usable"
    solution: "Break into batches of 10-20 files; context compaction extends sessions"
  access_denied:
    message: "Access denied — path outside allowed directories"
    cause: "Folder not granted"
    solution: "Re-grant folder access in System Preferences"
  session_terminated:
    message: "Session terminated unexpectedly"
    cause: "Sleep/background/VPN"
    solution: "Keep app foreground, disable sleep, disconnect VPN"

# ════════════════════════════════════════════════════════════════
# TOKEN BUDGET - Task costs
# ════════════════════════════════════════════════════════════════
tokens:
  simple_qa: "5K-10K"
  file_inventory: "20K-30K"
  small_file_org: "30K-50K (10-20 files)"
  large_file_org: "80K-150K (50+ files)"
  multi_doc_synthesis: "50K-100K"
  ocr_batch: "60K-100K (10+ images)"
  agentic_overhead: "15-30% (Plan→Execute→Check cycles)"

# ════════════════════════════════════════════════════════════════
# OCR ACCURACY (from Perplexity research)
# ════════════════════════════════════════════════════════════════
ocr:
  field_extraction: "~97% (vendor, date, totals)"
  line_items: "~63% (table rows)"
  warning: "Budget 30-50% of 'saved' time for error correction"
  best_for: "Single-currency, clear fonts, standard formats"

# ════════════════════════════════════════════════════════════════
# COMPETITIVE POSITIONING
# ════════════════════════════════════════════════════════════════
competition:
  unique_strength: "Only assistant with true multi-step autonomy + local files + browser automation + 11 plugins"
  vs_copilot: "Better autonomy + plugins, worse OCR accuracy"
  vs_gemini: "Better autonomy, comparable context (1M beta vs 1M+ native)"
  vs_chatgpt: "Better autonomy + plugins, macOS/Windows vs cross-platform"
  vs_apple_intelligence: "Better capabilities + plugins, cloud vs on-device"
  best_ocr: "Microsoft Copilot"
  best_context: "Gemini Advanced (1M+ native) or Cowork (1M beta with Opus 4.6)"
  best_privacy: "Apple Intelligence (on-device)"
  best_autonomy: "Cowork"

# ════════════════════════════════════════════════════════════════
# OPEN-SOURCE ALTERNATIVES
# ════════════════════════════════════════════════════════════════
open_source:
  warning: "Most have FULL filesystem access (can read/modify/delete any file). Only kuse_cowork is sandboxed."
  projects:
    different_ai_openwork:
      url: "https://github.com/different-ai/openwork"
      focus: "Desktop app with UI"
      ease_of_use: "User-friendly (GUI)"
      security: "Asks permission per action"
      best_for: "Non-technical users who need GUI"
    langchain_openwork:
      url: "https://github.com/langchain-ai/openwork"
      focus: "CLI tool"
      ease_of_use: "Requires terminal knowledge"
      security: "Full file access"
      best_for: "Developers wanting quick setup (npx openwork)"
    kuse_cowork:
      url: "https://github.com/kuse-ai/kuse_cowork"
      focus: "Offline/privacy"
      ease_of_use: "Requires Docker setup"
      security: "Sandboxed (Docker container)"
      best_for: "Developers prioritizing security/isolation"
  recommendations:
    non_technical: "Only different-ai/openwork (GUI interface)"
    developers: "langchain-ai/openwork (fastest) or kuse_cowork (most secure)"
    everyone_else: "Stick with official Cowork ($20/mo includes support, updates, reliability)"
  maturity: "All projects are alpha/beta quality (2026-01) - expect bugs and potential abandonment"

# ════════════════════════════════════════════════════════════════
# ENTERPRISE VALIDATION (Claude general, not Cowork-specific)
# ════════════════════════════════════════════════════════════════
enterprise:
  telus: "$90M value, 500K hours saved"
  rakuten: "87.5% reduction in processing time"
  zapier: "89% employee adoption"
  note: "Stats for Claude in general - validates underlying AI capabilities"

# ════════════════════════════════════════════════════════════════
# LIMITATIONS & CONSTRAINTS
# ════════════════════════════════════════════════════════════════
limitations:
  environment:
    - "VPN incompatible (VM routing conflict)"
    - "macOS and Windows only (Linux not announced)"
    - "Requires app foreground (no background operation)"
    - "Session persistence improved via context compaction (beta)"
  technical:
    - "No code execution"
    - "No API calls (except via plugins)"
    - "No cloud storage direct access (except Google Drive plugin)"
    - "No audio/video processing"
    - "1M context beta, effective limit depends on task complexity"
  workflow:
    - "Pro tier exhausts in ~1-1.5h intensive use"
    - "Usage resets every 5 hours (not daily)"
    - "No cross-session memory (Desktop Commander + memory-setup workflow solves this)"
    - "Connector reliability inconsistent"

# ════════════════════════════════════════════════════════════════
# DECISION FLOWCHART
# ════════════════════════════════════════════════════════════════
decide:
  use_cowork_when:
    - "Need to organize/rename files"
    - "Create Office documents (Word, Excel, PowerPoint)"
    - "Extract data from images/receipts"
    - "Compile research → documents"
    - "Batch file operations"
    - "Browser automation tasks"
    - "Recurring scheduled tasks"
  use_alternative_when:
    - "Need code execution → Claude Code"
    - "Need best OCR → Microsoft Copilot"
    - "Need 1M+ context native → Gemini Advanced"
    - "Privacy critical → Apple Intelligence"
    - "On Linux → Copilot or ChatGPT"
    - "VPN required → Claude Code"
    - "Budget critical but can handle setup → different-ai/openwork (open-source)"

# ════════════════════════════════════════════════════════════════
# QUICK START (5 steps)
# ════════════════════════════════════════════════════════════════
quick_start:
  1: "Enable Cowork in Claude Desktop → Settings → Features"
  2: "Create ~/Cowork-Workspace/{input,output}"
  3: "Grant folder access when prompted"
  4: "Use CTOC framework for prompts"
  5: "Review plan before approval"

# ════════════════════════════════════════════════════════════════
# GOLDEN RULES
# ════════════════════════════════════════════════════════════════
rules:
  1: "Always review plan before approval"
  2: "Dedicated workspace only (never Documents/Desktop)"
  3: "No credentials in workspace"
  4: "Verify file sources (prompt injection risk)"
  5: "Budget 30-50% time for OCR error correction"
  6: "Disconnect VPN before using"
  7: "Backup before destructive operations"

# ════════════════════════════════════════════════════════════════
# WHITEPAPERS (12 PDF livres blancs)
# ════════════════════════════════════════════════════════════════
whitepapers:
  base_url: "https://cowork.bruniaux.com/whitepapers/"
  available:
    wp00:
      title: "De Zéro à Productif"
      audience: "all"
      file: "whitepapers/fr/00-de-zero-a-productif.qmd"
    wp01:
      title: "Prompts Efficaces pour Non-Devs"
      audience: "all"
      file: "whitepapers/fr/01-prompts-efficaces-non-devs.qmd"
    wp02:
      title: "Automatisation Administrative"
      audience: "admin, dirigeant"
      file: "whitepapers/fr/02-automatisation-administrative.qmd"
    wp03:
      title: "IA pour Artisans et BTP"
      audience: "artisan, btp"
      file: "whitepapers/fr/03-ia-artisans-btp.qmd"
    wp04:
      title: "IA pour Commerçants et Retail"
      audience: "commercant, retail"
      file: "whitepapers/fr/04-ia-commercants-retail.qmd"
    wp05:
      title: "IA pour Consultants et Professions Libérales"
      audience: "consultant, freelance"
      file: "whitepapers/fr/05-ia-consultants-professions-liberales.qmd"
    wp06:
      title: "Prospection et Relation Client"
      audience: "commercial, dirigeant"
      file: "whitepapers/fr/06-prospection-relation-client.qmd"
    wp07:
      title: "Communication et Visibilité"
      audience: "all"
      file: "whitepapers/fr/07-communication-visibilite.qmd"
    wp08:
      title: "Organisation et Productivité"
      audience: "all"
      file: "whitepapers/fr/08-organisation-productivite.qmd"
    wp09:
      title: "Sécurité et Confidentialité pour TPE"
      audience: "all"
      file: "whitepapers/fr/09-securite-confidentialite-tpe.qmd"
    wp10:
      title: "Apprendre l'IA quand on n'est pas Dev"
      audience: "all"
      file: "whitepapers/fr/10-apprendre-ia-non-dev.qmd"
    wp11:
      title: "ROI et Déploiement pour Dirigeants"
      audience: "dirigeant"
      file: "whitepapers/fr/11-roi-deploiement-dirigeants.qmd"

# ════════════════════════════════════════════════════════════════
# RECAP CARDS (5 fiches A4 one-pager)
# ════════════════════════════════════════════════════════════════
recap_cards:
  base_url: "https://cowork.bruniaux.com/whitepapers/recap-cards/"
  available:
    P01:
      title: "Premiers Pas"
      topic: "workspace, ctoc, regles-or"
      file: "whitepapers/recap-cards/fr/P01-premiers-pas.qmd"
    C01:
      title: "Framework CTOC"
      topic: "ctoc, prompting, batch"
      file: "whitepapers/recap-cards/fr/C01-framework-ctoc.qmd"
    C04:
      title: "Sécurité et Confidentialité"
      topic: "securite, rgpd, donnees"
      file: "whitepapers/recap-cards/fr/C04-securite-confidentialite.qmd"
    M04:
      title: "Kit Dirigeant TPE"
      topic: "roi, deploiement, equipe"
      file: "whitepapers/recap-cards/fr/M04-dirigeant-tpe.qmd"
    C05:
      title: "Mesurer son ROI"
      topic: "roi, metriques, progression"
      file: "whitepapers/recap-cards/fr/C05-mesurer-roi.qmd"

# ════════════════════════════════════════════════════════════════
# LEARNING SECTION
# ════════════════════════════════════════════════════════════════
learning:
  index: "guide/learning/README.md"
  files:
    learning_with_ai_en: "guide/learning/learning-with-ai.md"
    learning_with_ai_fr: "guide/learning/learning-with-ai.fr.md"
    building_prompting_en: "guide/learning/building-prompting-skills.md"
    building_prompting_fr: "guide/learning/building-prompting-skills.fr.md"
    measuring_progress_en: "guide/learning/measuring-progress.md"
    measuring_progress_fr: "guide/learning/measuring-progress.fr.md"

# ════════════════════════════════════════════════════════════════
# DIAGRAMS (25 disponibles, 32 planifiés)
# ════════════════════════════════════════════════════════════════
diagrams:
  index: "guide/diagrams/README.md"
  files:
    getting_started: "guide/diagrams/01-getting-started.md"
    capabilities: "guide/diagrams/02-capabilities.md"
    security: "guide/diagrams/03-security.md"
    troubleshooting: "guide/diagrams/04-troubleshooting.md"
    workflows_admin: "guide/diagrams/05-workflows-admin.md"
    workflows_commercial: "guide/diagrams/06-workflows-commercial.md"
    workflows_production: "guide/diagrams/07-workflows-production.md"
    workflows_commu_orga: "guide/diagrams/08-workflows-commu-orga.md"

# ════════════════════════════════════════════════════════════════
# EXAMPLES
# ════════════════════════════════════════════════════════════════
examples:
  templates:
    artisan_btp: "examples/claude-md-templates/artisan-btp.md"
    commercant: "examples/claude-md-templates/commercant.md"
    consultant: "examples/claude-md-templates/consultant.md"
    dirigeant_tpe: "examples/claude-md-templates/dirigeant-tpe.md"
  workflows_before_after:
    admin_invoicing: "examples/workflows-before-after/admin-invoicing.md"
    commercial_prospecting: "examples/workflows-before-after/commercial-prospecting.md"
    content_creation: "examples/workflows-before-after/content-creation.md"
    file_organization: "examples/workflows-before-after/file-organization.md"