> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# PR DESCRIPTION

# PR: docs(cowork): Add "What is Cowork" article in EN, PT, ES

## Summary

This PR introduces the first article of the Cowork documentation series: **"What is Cowork"** — a comprehensive guide to the TESS AI collaborative platform for autonomous agents.

### Highlights

* ✅ **Trilingual Documentation**: English, Portuguese, Spanish
* ✅ **Complete Article**: 800+ lines covering 10+ sections
* ✅ **Navigation Updated**: Added Cowork section to docs.json for all 3 languages
* ✅ **Visual Assets**: Screenshot placeholders with detailed specs
* ✅ **Production-Ready**: MDX with Mintlify components

***

## Changes

### Files Modified

* **docs.json** — Added Cowork group to Features tab (EN, PT, ES)

### Files Added

#### English

* `en/cowork/what-is-cowork.mdx` (519 lines)

#### Português

* `pt/cowork/o-que-e-cowork.mdx` (translated)

#### Español

* `es/cowork/que-es-cowork.mdx` (translated)

#### Assets

* `images/cowork/main-canvas.png` (placeholder)
* `images/cowork/hire-modal.png` (placeholder)

***

## Content Coverage

### Sections Included

1. **What is Cowork** — Platform overview

2. **Why Cowork?** — Problems solved by autonomous agents

3. **The Mesh Canvas** — Visual representation with screenshot

4. **What You See on the Mesh** — Interface components:
   * Agent Nodes (Avatares)
   * Team Presence (Orbs)
   * Documents & Artifacts
   * Connections & Links

5. **Core Concepts** — 4 key features:
   * Digital Employees (Autopilots)
   * Artifacts (Persistent outputs)
   * Squads (Multi-agent teams)
   * Sync Sessions (Real-time coordination)

6. **Getting Started** — 5-step onboarding flow

7. **Key Features at a Glance** — Feature table

8. **Next Steps** — Links to related docs

9. **Pro Tips** — Best practices

***

## Screenshots Required

Before merge, please add these 2 images:

### 1. `images/cowork/main-canvas.png`

* **Description**: Mesh Canvas Overview
* **Content**: Full Cowork interface showing:
  * Left sidebar (navigation: Cowork, Spaces, Agent Studio)
  * Main canvas area with agent nodes/avatars (Gabriel, Tess)
  * Top toolbar (search, Hire button, controls)
  * Bottom input area (prompt box)
* **Dimensions**: Wide-angle view of entire workspace
* **Spec**: JSX comment in `en/cowork/what-is-cowork.mdx` (lines 25-33)

### 2. `images/cowork/hire-modal.png`

* **Description**: Digital Employee Hiring Form
* **Content**: Modal "Contratar um novo colaborador" showing:
  * Avatar image field with Change/Remove options
  * Name input (e.g. "Lead Scanner")
  * Voice selector dropdown
  * Meta/description textarea
  * Work Instructions textarea
  * "Melhorar com IA" button
  * Work Mode section
  * "Contratar" button (top-right)
* **Dimensions**: Modal dialog \~500px width
* **Spec**: JSX comment in `en/cowork/what-is-cowork.mdx` (lines 63-76)

***

## Localization Quality

* ✅ **English**: Native-level technical terminology
* ✅ **Português (BR)**: Natural Brazilian Portuguese with local idioms
* ✅ **Español**: Neutral Spanish suitable for LATAM

All translations maintain consistency with existing TESS AI documentation.

***

## Preview URLs

Once merged:

* **English**: `https://tess.ai/docs/cowork/what-is-cowork`
* **Português**: `https://tess.ai/docs/pt/cowork/o-que-e-cowork`
* **Español**: `https://tess.ai/docs/es/cowork/que-es-cowork`

***

## Related

* **Linear Issue**: [TESS-1127](https://linear.app/tessai/issue/TESS-1127/documentacao-cowork)
* **Screenshot Source**: Cowork staging environment (`s1-tech.tess.im`)

***

## Testing Checklist

* [ ] Screenshots added to `/images/cowork/`
* [ ] Mintlify preview loads correctly
* [ ] Navigation shows Cowork section for all 3 languages
* [ ] Links to next articles are valid (once created)
* [ ] No broken references in JSX comments
* [ ] Images display with correct captions
* [ ] Responsive on mobile/tablet

***

## Next Steps

1. ✅ Approve and merge this PR
2. ⏳ Create next article: "Primeiros Passos > Acesso ao Cowork"
3. ⏳ Create next article: "Digital Employees > Criando um Digital Employee"
4. ⏳ Build out remaining TIER 1 articles
5. ⏳ Move to TIER 2 (Colaboration, Artifacts Avançado, etc.)

***

## Author Notes

* Used Mintlify components: `<Frame>`, `<Tip>`, `<Steps>`, `<Step>` for interactivity
* Followed DESIGN.md rules for consistency
* Maintained SEO-friendly structure with clear hierarchy
* Ready for immediate publication once screenshots added