Espace de Travail de l'Agent

L'espace de travail est le répertoire où l'agent exécute ses tâches, lit/écrit des fichiers, et maintient son contexte et sa mémoire.

Structure

~/workspace/              # Racine de l'espace de travail ├── BOOTSTRAP.md          # Instructions d'initialisation (one-time) ├── SOUL.md               # Identité de l'agent ├── USER.md               # Profil utilisateur ├── AGENTS.md             # Conventions et workflows ├── TOOLS.md              # Notes locales outils ├── MEMORY.md             # Mémoire long terme (curated) ├── memory/               # Mémoire quotidienne │   ├── 2026-02-06.md │   ├── 2026-02-05.md │   └── ... ├── projects/             # Projets utilisateur ├── scripts/              # Scripts utilitaires └── tmp/                  # Fichiers temporaires

Fichiers principaux

`BOOTSTRAP.md` (optionnel)

Première exécution uniquement :

  • Présentation initiale
  • Configuration de base
  • À supprimer après lecture

`SOUL.md`

Identité permanente :

# My Soul I am Claude, a helpful AI assistant created by Anthropic. ## Personality - Curious and thoughtful - Direct but kind - Loves learning ## Values - Honesty - Safety - Helpfulness

`USER.md`

Profil utilisateur :

# User Profile Name: Alice Profession: Developer Timezone: Europe/Paris Preferred language: French ## Preferences - Verbose: No (concise responses) - Code style: Modern JS/TS - Tools: VSCode, Git, Docker

`AGENTS.md`

Workflows et règles :

# Agents Workflow ## Startup 1. Read SOUL.md 2. Read USER.md 3. Read memory/today.md ## Memory - Daily: memory/YYYY-MM-DD.md - Long-term: MEMORY.md (main session only) ## Safety - `trash` > `rm` - Ask before destructive operations

`TOOLS.md`

Notes locales :

# Local Tools ## SSH - home-server: 192.168.1.100 (user: admin) ## Cameras - living-room: Main area, 180° wide - front-door: Entrance ## TTS - Voice: Nova (British, warm)

`MEMORY.md`

Mémoire long terme :

# My Memory ## Important Facts - Alice is working on project X (deadline: Feb 15) - Server maintenance every Sunday 3am - Cat's name: Whiskers ## Learned Lessons - Always check Docker logs before restart - Alice prefers React over Vue

Répertoire `memory/`

Logs quotidiens :

# 2026-02-06 ## Morning - Helped Alice debug TypeScript issue - Deployed update to production ## Afternoon - Created backup script - Reviewed pull request #42 ## Notes - Alice mentioned upcoming conference next week

Isolation

  • Par session : Chaque session a son propre espace de travail
  • Sandbox optionnel : Docker ou VM pour isolation complète
  • Permissions : Lecture/écriture limitées au workspace

Accès

L'agent accède au workspace via :

  • Read tool : Lire fichiers
  • Write tool : Créer/écrire fichiers
  • Edit tool : Éditer précisément
  • exec tool : Exécuter commandes shell

Sécurité

  • Chemins relatifs : Toujours relatifs au workspace
  • No escape : L'agent ne peut pas sortir du workspace (sauf si autorisé)
  • Backup : Sauvegardes automatiques recommandées

Organisation recommandée

~/workspace/ ├── [Fichiers core]          # SOUL, USER, AGENTS, TOOLS, MEMORY ├── memory/                  # Logs quotidiens ├── projects/                # Projets actifs │   ├── project-a/ │   └── project-b/ ├── archive/                 # Projets terminés ├── scripts/                 # Scripts utilitaires ├── docs/                    # Documentation └── tmp/                     # Temporaire (nettoyé régulièrement)

Bonnes pratiques

  1. Structure claire : Séparer projets, scripts, docs
  2. Nettoyage régulier : Archiver/supprimer ancien contenu
  3. Versioning : Git pour projets importants
  4. Backups : Sauvegarder SOUL, USER, MEMORY régulièrement

Commandes utiles

# Lister le workspace ls -la ~/workspace # Rechercher un fichier find ~/workspace -name "*.md" # Taille du workspace du -sh ~/workspace # Nettoyer temporaires rm -rf ~/workspace/tmp/* # Archiver ancienne mémoire tar -czf memory-archive-2026-01.tar.gz memory/2026-01-*.md

Voir Context pour la gestion du contexte.