claudient 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "claudient",
+  "version": "0.1.0",
+  "description": "The definitive Claude Code knowledge system — skills, agents, hooks, rules, and workflows.",
+  "skills": [
+    { "id": "backend/python/fastapi", "name": "FastAPI", "file": "skills/backend/python/fastapi.md", "status": "active" },
+    { "id": "backend/python/django", "name": "Django", "file": "skills/backend/python/django.md", "status": "active" },
+    { "id": "backend/nodejs/nextjs", "name": "Next.js", "file": "skills/backend/nodejs/nextjs.md", "status": "active" },
+    { "id": "backend/nodejs/nestjs", "name": "NestJS", "file": "skills/backend/nodejs/nestjs.md", "status": "active" },
+    { "id": "backend/go/go", "name": "Go", "file": "skills/backend/go/go.md", "status": "active" },
+    { "id": "backend/dotnet/csharp", "name": "C#/.NET", "file": "skills/backend/dotnet/csharp.md", "status": "active" },
+    { "id": "ai-engineering/claude-api", "name": "Claude API", "file": "skills/ai-engineering/claude-api.md", "status": "active" },
+    { "id": "ai-engineering/agent-construction", "name": "Agent Construction", "file": "skills/ai-engineering/agent-construction.md", "status": "active" },
+    { "id": "devops-infra/kubernetes", "name": "Kubernetes", "file": "skills/devops-infra/kubernetes.md", "status": "active" },
+    { "id": "devops-infra/terraform", "name": "Terraform", "file": "skills/devops-infra/terraform.md", "status": "active" },
+    { "id": "devops-infra/docker", "name": "Docker", "file": "skills/devops-infra/docker.md", "status": "active" },
+    { "id": "devops-infra/github-actions", "name": "GitHub Actions", "file": "skills/devops-infra/github-actions.md", "status": "active" },
+    { "id": "data-ml/pandas-polars", "name": "Pandas & Polars", "file": "skills/data-ml/pandas-polars.md", "status": "active" },
+    { "id": "data-ml/pytorch-tensorflow", "name": "PyTorch & TensorFlow", "file": "skills/data-ml/pytorch-tensorflow.md", "status": "active" },
+    { "id": "data-ml/dbt-data-pipelines", "name": "dbt & Data Pipelines", "file": "skills/data-ml/dbt-data-pipelines.md", "status": "active" },
+    { "id": "database/graphql", "name": "GraphQL", "file": "skills/database/graphql.md", "status": "active" },
+    { "id": "finance-payments/stripe", "name": "Stripe", "file": "skills/finance-payments/stripe.md", "status": "active" }
+  ],
+  "agents": [
+    { "id": "core/planner", "name": "Planner", "file": "agents/core/planner.md", "status": "active" },
+    { "id": "core/architect", "name": "Architect", "file": "agents/core/architect.md", "status": "active" },
+    { "id": "core/code-reviewer", "name": "Code Reviewer", "file": "agents/core/code-reviewer.md", "status": "active" },
+    { "id": "core/security-reviewer", "name": "Security Reviewer", "file": "agents/core/security-reviewer.md", "status": "active" },
+    { "id": "build-resolvers/python-resolver", "name": "Python Build Resolver", "file": "agents/build-resolvers/python-resolver.md", "status": "active" },
+    { "id": "build-resolvers/typescript-resolver", "name": "TypeScript Build Resolver", "file": "agents/build-resolvers/typescript-resolver.md", "status": "active" }
+  ],
+  "rules": [
+    { "id": "common/coding-style", "name": "Coding Style", "file": "rules/common/coding-style.md", "status": "active" },
+    { "id": "common/git", "name": "Git", "file": "rules/common/git.md", "status": "active" },
+    { "id": "common/performance", "name": "Performance", "file": "rules/common/performance.md", "status": "active" },
+    { "id": "common/security", "name": "Security", "file": "rules/common/security.md", "status": "active" },
+    { "id": "common/testing", "name": "Testing", "file": "rules/common/testing.md", "status": "active" },
+    { "id": "language-specific/python", "name": "Python Rules", "file": "rules/language-specific/python.md", "status": "active" },
+    { "id": "language-specific/typescript", "name": "TypeScript Rules", "file": "rules/language-specific/typescript.md", "status": "active" },
+    { "id": "language-specific/go", "name": "Go Rules", "file": "rules/language-specific/go.md", "status": "active" }
+  ]
+}

package/CONTEXT.md

@@ -0,0 +1,58 @@
+# Claudient — Context Map
+
+This file defines shared terminology for the Claudient repository. When Claude Code works inside this repo, it uses these definitions as ground truth.
+
+---
+
+## Language
+
+**skill** — A Markdown file in `skills/` that defines a slash command for Claude Code. Activated by the user via `/skill-name`. Contains when to activate, when not to, instructions, and an example. Skills are scoped to a domain (backend, devops, data, etc.).
+
+**agent** — A Markdown file in `agents/` that defines a subagent: a separate Claude instance spawned by the orchestrator to handle a bounded task. Agents have a specific tool subset and model recommendation.
+
+**hook** — A shell script or Python script in `hooks/` that Claude Code executes automatically in response to events: `PreToolUse`, `PostToolUse`, `PreCompact`, `Notification`. Hooks are configured in `settings.json`.
+
+**rule** — A Markdown file in `rules/` that describes always-on behavioral guidelines. Rules are included in CLAUDE.md and apply to all sessions in the project.
+
+**workflow** — A Markdown file in `workflows/` that documents a multi-step end-to-end process (e.g., feature development, debugging session). Workflows are reference documents, not slash commands.
+
+**prompt** — A Markdown file in `prompts/` containing a reusable prompt template. Includes system prompts, project starters, and task-specific prompts.
+
+**guide** — A Markdown file in `guides/` that documents a Claude Code concept in depth. Guides are human-readable documentation translated into all 5 languages.
+
+**MCP (Model Context Protocol)** — A protocol that allows Claude Code to connect to external servers, exposing additional tools (database access, web search, browser automation). Each MCP server adds tools and consumes context window tokens.
+
+**slash command** — A `/command-name` invocation in Claude Code that activates a skill. The skill file is loaded from `.claude/commands/` or `~/.claude/commands/`.
+
+**Claude Code** — Anthropic's CLI and IDE extension for using Claude as an interactive coding assistant. Not to be confused with the Claude API or Claude.ai chat interface.
+
+**subagent** — A Claude instance spawned by the parent session via the `Agent` tool. Gets a fresh context window, specific tool subset, and model selection. Returns one result to the parent.
+
+**tool** — A function Claude can call during a session (Read, Write, Bash, Agent, WebFetch, etc.). In MCP contexts, also refers to functions exposed by MCP servers.
+
+**context window** — The total token limit for a Claude session: ~200k tokens for Sonnet/Opus. Includes system prompt, conversation history, tool descriptions, and MCP tool schemas.
+
+**CLAUDE.md** — The project instructions file read by Claude Code at session start. Can exist at project, user, or workspace level. Governs Claude's behavior for that context.
+
+---
+
+## Relationships
+
+- A **skill** is to Claude Code what a VS Code extension command is to VS Code — a named, activatable behavior
+- A **rule** is always applied; a **skill** is explicitly invoked
+- An **agent** is a subagent spawned by the parent; a **skill** is activated within the current session
+- A **hook** is automatic (event-driven); a **skill** is manual (slash command)
+- A **workflow** describes what to do step by step; a **skill** tells Claude how to do one specific thing
+- A **prompt** is a reusable template; a **guide** is explanatory documentation
+
+---
+
+## Flagged Ambiguities
+
+**"skill" vs "command"** — In Claude Code, the underlying files are called "slash commands" or "commands". Claudient uses "skill" to describe the same files when they encode reusable domain expertise. Functionally identical.
+
+**"agent" vs "subagent"** — In Claudient's `agents/` directory, files define subagent specifications. In general Claude Code usage, "agent" often means the primary session. Here, "agent" always means a subagent spawned via the `Agent` tool.
+
+**"hook" vs "rule"** — Hooks run code; rules set behavioral guidelines. A hook is executable; a rule is instructional.
+
+**"workflow" vs "skill"** — A workflow is a multi-step reference document you read before starting a task. A skill is invoked mid-task via slash command to get domain-specific guidance.

package/README.md

@@ -0,0 +1,165 @@
+# Claudient
+
+> The definitive knowledge base for Claude Code — skills, agents, hooks, workflows, prompts, and patterns that multiply what you can build.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![Languages](https://img.shields.io/badge/languages-EN%20%7C%20FR%20%7C%20DE%20%7C%20NL%20%7C%20ES-blue)](#translations)
+
+**Claudient** is not a tool. It is a *knowledge system* — a community-maintained collection of everything you can drop into your Claude Code environment to immediately work faster, smarter, and with less friction.
+
+---
+
+## Why Claudient?
+
+Claude Code is powerful out of the box. But the gap between "it works" and "it works at 10x" is filled with patterns most developers never discover on their own: the right skill for a task, a hook that enforces quality automatically, an agent that handles an entire domain, a workflow that turns a vague goal into shipped code.
+
+Claudient collects all of that in one place — organized, searchable, and ready to use.
+
+| | Everything-claude-code | **Claudient** |
+|---|---|---|
+| C#/.NET coverage | None | Full |
+| Kubernetes / Terraform | Sparse | Dedicated skill sets |
+| GraphQL / Prisma | None | Full |
+| ML / Data Engineering | Limited | dbt, Spark, MLflow, PyTorch |
+| Fintech / Payments | None | Stripe, payment flows |
+| End-to-end workflows | None | 5 complete workflows |
+| Skill authoring guide | None | First-class guide |
+| Prompt templates | None | Full library |
+| Token optimization | Scattered across 3 docs | Single authoritative guide |
+| Languages | 8 (inconsistent) | EN · FR · DE · NL · ES |
+
+---
+
+## What's Inside
+
+```
+Claudient/
+│
+├── guides/              Deep-dive documentation
+│   ├── getting-started.md
+│   ├── skill-authoring.md
+│   ├── token-optimization.md
+│   ├── memory-management.md
+│   ├── security.md
+│   ├── agent-orchestration.md
+│   └── hooks-cookbook.md
+│
+├── skills/              Slash command skill definitions
+│   ├── ai-engineering/
+│   ├── backend/         python · nodejs · go · rust · java · dotnet · php
+│   ├── frontend/        react · vue · mobile
+│   ├── data-ml/         pandas · pytorch · mlflow · dbt · spark
+│   ├── devops-infra/    kubernetes · terraform · docker · github-actions · cloud
+│   ├── database/        postgresql · mongodb · redis · graphql
+│   ├── security/        appsec · devsecops · compliance
+│   ├── finance-payments/
+│   └── content-docs/
+│
+├── agents/              Specialized subagent definitions
+│   ├── core/            planner · architect · reviewer · security
+│   ├── build-resolvers/ language-specific error resolvers
+│   └── domain/          database · devops · ml specialists
+│
+├── hooks/               Event-triggered automations
+│   ├── pre-tool-use/
+│   ├── post-tool-use/
+│   └── lifecycle/
+│
+├── rules/               Always-follow guidelines
+│   ├── common/
+│   └── language-specific/
+│
+├── workflows/           End-to-end multi-skill workflows
+│   ├── feature-development.md
+│   ├── debugging-session.md
+│   ├── code-review.md
+│   ├── refactor-safely.md
+│   └── new-project-bootstrap.md
+│
+├── prompts/             High-value prompt templates
+│   ├── system-prompts/
+│   ├── project-starters/
+│   └── task-specific/
+│
+├── mcp/                 MCP configs and recommended servers
+└── examples/            Complete working project references
+```
+
+---
+
+## Quick Start
+
+**No installation required.** Clone the repo and copy what you need into your project.
+
+```bash
+git clone https://github.com/Claudient/Claudient.git
+```
+
+**To use a skill** — copy the `.md` file into `.claude/commands/` in your project:
+
+```bash
+cp Claudient/skills/backend/python/fastapi.md your-project/.claude/commands/
+```
+
+Then trigger it in Claude Code with `/fastapi`.
+
+**To use an agent** — reference it in your Claude session using the `subagent_type` parameter in your Agent tool calls.
+
+**To use a hook** — add the hook JSON to the `hooks` array in your `.claude/settings.json`.
+
+**To use a rule** — copy the content into your `CLAUDE.md`.
+
+See [guides/getting-started.md](guides/getting-started.md) for a 5-minute setup walkthrough.
+
+---
+
+## Guides
+
+| Guide | What it covers |
+|---|---|
+| [Getting Started](guides/getting-started.md) | Setup, first skill, first hook — 5 minutes |
+| [Skill Authoring](guides/skill-authoring.md) | How to write a skill that actually works |
+| [Token Optimization](guides/token-optimization.md) | Model selection, context math, cost reduction |
+| [Memory Management](guides/memory-management.md) | Session persistence, compaction strategies |
+| [Security](guides/security.md) | Isolation, approval boundaries, sanitization |
+| [Agent Orchestration](guides/agent-orchestration.md) | Sub-agent patterns, parallelization |
+| [Hooks Cookbook](guides/hooks-cookbook.md) | Hook patterns with real examples |
+
+---
+
+## Translations
+
+All guides and documentation are available in:
+
+- [English](guides/) (primary)
+- [Français](guides/fr/)
+- [Deutsch](guides/de/)
+- [Nederlands](guides/nl/)
+- [Español](guides/es/)
+
+Skills, agents, and hooks remain in English — they are code-adjacent and translation adds noise without value.
+
+---
+
+## Contributing
+
+Claudient grows through community contributions. Every skill, agent, hook, and workflow in this repo was written by someone who solved a real problem.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for how to add your own — including the skill template, quality checklist, and review process.
+
+---
+
+## Work With Us
+
+Claudient is backed by [Uitbreiden](https://uitbreiden.com/) — we build AI products with developer communities and deliver B2B AI solutions.
+
+If you're a developer, startup, or enterprise team looking to build with Claude Code at scale, integrate AI into your product, or need a technical partner who lives and breathes this stack — come talk to us.
+
+**[uitbreiden.com](https://uitbreiden.com/)**
+
+---
+
+## License
+
+MIT — use freely, attribution appreciated.

package/agents/build-resolvers/de/python-resolver.md

@@ -0,0 +1,64 @@
+> 🇩🇪 Dies ist die deutsche Übersetzung. [Englische Version](../python-resolver.md).
+
+# Python Build Resolver Agent
+
+## Zweck
+Diagnostiziert und behebt Python-Import-Fehler, Laufzeit-Ausnahmen, Type-Annotation-Konflikte (mypy) und Abhängigkeitskonflikte — und gibt korrigierten Code mit einer Erklärung zurück.
+
+## Modellempfehlung
+**Haiku 4.5** für Einzeldatei-Fehler (ImportError, AttributeError, NameError, einfache Type-Annotation-Probleme).
+
+**Sonnet 4.6** für Fehler, die mehrere Module umspannen, zirkuläre Imports, mypy-Strict-Mode-Fehler oder Abhängigkeitsversions-Konflikte.
+
+## Tools
+- `Read` — die fehlerhaften Datei und verwandte Module lesen
+- `Edit` — gezielte Korrekturen anwenden
+- `Bash` — `python -m mypy file.py 2>&1`, `python -c "import module"`, `pip show package` zur Diagnose ausführen
+
+## Wann hierher delegieren
+- `ImportError` oder `ModuleNotFoundError` beim Start oder beim Test-Run
+- `mypy`-Typprüfungsfehler in einer streng typisierten Codebase
+- `AttributeError: module 'x' has no attribute 'y'` (API in Paket-Upgrade geändert)
+- Zirkuläre Import-Fehler
+- Abhängigkeitsversions-Konflikte (`pip install` schlägt fehl oder erzeugt inkompatible Versionen)
+
+## Wann NICHT hierher delegieren
+- Logikfehler, die keine Import-/Typfehler sind
+- Performance-Probleme
+- Laufzeitfehler, die durch falsche Geschäftslogik verursacht werden (keine strukturellen Python-Fehler)
+
+## Prompt-Vorlage
+```
+You are a Python error resolver. Fix the error — minimal changes only. Do not refactor.
+
+Error:
+[paste full traceback or mypy output]
+
+Relevant files:
+[paste file contents where errors occur]
+
+Python version: [e.g., 3.12]
+Package versions: [paste pip freeze output if relevant]
+
+For each error:
+1. Explain why the error occurs in one sentence
+2. Apply the minimal fix
+3. If a dependency version conflict: specify the exact version constraint to add/change
+
+Do not change logic. Do not refactor. Fix the error only.
+```
+
+## Beispiel-Anwendungsfall
+**Fehler:**
+```
+ImportError: cannot import name 'AsyncClient' from 'httpx' (0.23.0)
+```
+
+**Was Resolver zurückgibt:**
+- Ursache: `AsyncClient` wurde in `httpx 0.18.0` hinzugefügt, aber die Verwendung erfordert `httpx>=0.23.0` für die verwendete spezifische API
+- Lösung: `requirements.txt` auf `httpx>=0.23.0,<1.0.0` aktualisieren und `pip install -r requirements.txt` ausführen
+- Falls kein Upgrade möglich: äquivalenten Code für die installierte Version zeigen
+
+---
+
+> **Mit uns arbeiten:** Claudient wird von [Uitbreiden](https://uitbreiden.com/) unterstützt — wir bauen KI-Produkte und B2B-Lösungen mit Entwickler-Communities. [uitbreiden.com](https://uitbreiden.com/)

package/agents/build-resolvers/de/typescript-resolver.md

@@ -0,0 +1,65 @@
+> 🇩🇪 Dies ist die deutsche Übersetzung. [Englische Version](../typescript-resolver.md).
+
+# TypeScript Build Resolver Agent
+
+## Zweck
+Diagnostiziert und behebt TypeScript-Kompilierungsfehler, Typ-Konflikte und `tsc`-Fehler — und gibt korrigierten Code mit einer Erklärung zurück, was falsch war.
+
+## Modellempfehlung
+**Haiku 4.5** für unkomplizierte Typfehler (fehlende Eigenschaft, falscher Argumenttyp, `any`-Leckage).
+
+**Sonnet 4.6** wenn Fehler mehrere Dateien umspannen, generische Typ-Einschränkungen, bedingte Typen oder komplexe Typ-Inferenz-Ketten beinhalten.
+
+## Tools
+- `Read` — die fehlerhafte Datei und relevante Typdefinitionen lesen
+- `Edit` — gezielte Korrekturen anwenden (nur minimale Änderungen)
+- `Bash` — `npx tsc --noEmit 2>&1` ausführen, um Korrektur zu bestätigen, `grep` für verwandte Typdefinitionen
+
+## Wann hierher delegieren
+- `tsc --noEmit` schlägt mit Typfehlern fehl, die diagnostiziert und behoben werden sollen
+- `Type 'X' is not assignable to type 'Y'`-Fehler, die nicht sofort offensichtlich sind
+- Generische Typ-Inferenz-Fehler
+- Drittanbieter-Typdefinitions-Konflikte (z.B. nach einem Paket-Upgrade)
+- Beheben von `any`-Typen, die in die Codebase geleckt sind
+
+## Wann NICHT hierher delegieren
+- Laufzeitfehler, die keine Typfehler sind
+- ESLint-Regelverletzungen (keine TypeScript-Kompilierung)
+- Logikfehler, die die Typprüfung passieren
+
+## Prompt-Vorlage
+```
+You are a TypeScript error resolver. Fix the type errors — minimal changes only. Do not refactor.
+
+Error output from tsc:
+[paste full tsc error output]
+
+Relevant files:
+[paste file contents where errors occur]
+
+Type definitions context (if relevant):
+[paste relevant .d.ts or interface definitions]
+
+For each error:
+1. Explain why the error occurs in one sentence
+2. Apply the minimal fix
+3. Confirm the fix is correct by reasoning through the types
+
+Do not change logic. Do not refactor. Fix types only.
+```
+
+## Beispiel-Anwendungsfall
+**Fehler:**
+```
+src/api/orders.ts:45:18 - error TS2345:
+Argument of type 'string | undefined' is not assignable to parameter of type 'string'.
+```
+
+**Was Resolver zurückgibt:**
+- Ursache: `req.params.id` ist `string | undefined`, aber `getOrder()` erwartet `string`
+- Lösung: Guard `if (!req.params.id) return res.status(400).json({ error: 'id required' })` vor dem Aufruf hinzufügen — TypeScript schränkt den Typ nach dem Guard ein
+- Minimal: 2-Zeilen-Ergänzung, keine Logikänderung
+
+---
+
+> **Mit uns arbeiten:** Claudient wird von [Uitbreiden](https://uitbreiden.com/) unterstützt — wir bauen KI-Produkte und B2B-Lösungen mit Entwickler-Communities. [uitbreiden.com](https://uitbreiden.com/)

package/agents/build-resolvers/es/python-resolver.md

@@ -0,0 +1,64 @@
+> 🇪🇸 Esta es la traducción en español. [Versión en inglés](../python-resolver.md).
+
+# Agente Resolvedor de Builds Python
+
+## Propósito
+Diagnostica y corrige errores de importación de Python, excepciones en tiempo de ejecución, incompatibilidades de anotaciones de tipos (mypy) y conflictos de dependencias — devolviendo código corregido con una explicación.
+
+## Orientación sobre el modelo
+**Haiku 4.5** para errores de un solo archivo (ImportError, AttributeError, NameError, problemas simples de anotaciones de tipos).
+
+**Sonnet 4.6** para errores que abarcan múltiples módulos, importaciones circulares, fallos en modo estricto de mypy o conflictos de versión de dependencias.
+
+## Herramientas
+- `Read` — leer el archivo fallido y los módulos relacionados
+- `Edit` — aplicar correcciones específicas
+- `Bash` — ejecutar `python -m mypy file.py 2>&1`, `python -c "import module"`, `pip show package` para diagnosticar
+
+## Cuándo delegar aquí
+- `ImportError` o `ModuleNotFoundError` al inicio o en la ejecución de pruebas
+- Fallos de verificación de tipos `mypy` en un codebase estrictamente tipado
+- `AttributeError: module 'x' has no attribute 'y'` (API cambió al actualizar un paquete)
+- Errores de importación circular
+- Conflictos de versión de dependencias (`pip install` falla o produce versiones incompatibles)
+
+## Cuándo NO delegar aquí
+- Bugs lógicos que no son errores de importación/tipo
+- Problemas de rendimiento
+- Errores en tiempo de ejecución causados por lógica de negocio incorrecta (no errores estructurales de Python)
+
+## Plantilla de prompt
+```
+You are a Python error resolver. Fix the error — minimal changes only. Do not refactor.
+
+Error:
+[paste full traceback or mypy output]
+
+Relevant files:
+[paste file contents where errors occur]
+
+Python version: [e.g., 3.12]
+Package versions: [paste pip freeze output if relevant]
+
+For each error:
+1. Explain why the error occurs in one sentence
+2. Apply the minimal fix
+3. If a dependency version conflict: specify the exact version constraint to add/change
+
+Do not change logic. Do not refactor. Fix the error only.
+```
+
+## Caso de uso de ejemplo
+**Error:**
+```
+ImportError: cannot import name 'AsyncClient' from 'httpx' (0.23.0)
+```
+
+**Lo que devuelve el Resolvedor:**
+- Causa: `AsyncClient` fue agregado en `httpx 0.18.0` pero el uso requiere `httpx>=0.23.0` para la API específica usada
+- Corrección: actualizar `requirements.txt` a `httpx>=0.23.0,<1.0.0` y ejecutar `pip install -r requirements.txt`
+- Si no se puede actualizar: mostrar el código equivalente para la versión instalada
+
+---
+
+> **Trabaja con nosotros:** Claudient está respaldado por [Uitbreiden](https://uitbreiden.com/) — construimos productos de IA y soluciones B2B con comunidades de desarrolladores. [uitbreiden.com](https://uitbreiden.com/)

package/agents/build-resolvers/es/typescript-resolver.md

@@ -0,0 +1,65 @@
+> 🇪🇸 Esta es la traducción en español. [Versión en inglés](../typescript-resolver.md).
+
+# Agente Resolvedor de Builds TypeScript
+
+## Propósito
+Diagnostica y corrige errores de compilación de TypeScript, incompatibilidades de tipos y fallos de `tsc` — devolviendo código corregido con una explicación de lo que estaba mal.
+
+## Orientación sobre el modelo
+**Haiku 4.5** para errores de tipos simples (propiedad faltante, tipo de argumento incorrecto, `any` que se filtra).
+
+**Sonnet 4.6** cuando los errores abarcan múltiples archivos, involucran restricciones de tipos genéricos, tipos condicionales o cadenas complejas de inferencia de tipos.
+
+## Herramientas
+- `Read` — leer el archivo fallido y las definiciones de tipos relevantes
+- `Edit` — aplicar correcciones específicas (solo cambios mínimos)
+- `Bash` — ejecutar `npx tsc --noEmit 2>&1` para confirmar la corrección, `grep` para definiciones de tipos relacionadas
+
+## Cuándo delegar aquí
+- `tsc --noEmit` falla con errores de tipos que quieres diagnosticar y corregir
+- Errores `Type 'X' is not assignable to type 'Y'` que no son inmediatamente obvios
+- Fallos de inferencia de tipos genéricos
+- Incompatibilidades de definiciones de tipos de terceros (p.ej., tras actualizar un paquete)
+- Corrección de tipos `any` que se han filtrado al codebase
+
+## Cuándo NO delegar aquí
+- Errores en tiempo de ejecución que no son errores de tipos
+- Violaciones de reglas de ESLint (no compilación de TypeScript)
+- Bugs lógicos que pasan la verificación de tipos
+
+## Plantilla de prompt
+```
+You are a TypeScript error resolver. Fix the type errors — minimal changes only. Do not refactor.
+
+Error output from tsc:
+[paste full tsc error output]
+
+Relevant files:
+[paste file contents where errors occur]
+
+Type definitions context (if relevant):
+[paste relevant .d.ts or interface definitions]
+
+For each error:
+1. Explain why the error occurs in one sentence
+2. Apply the minimal fix
+3. Confirm the fix is correct by reasoning through the types
+
+Do not change logic. Do not refactor. Fix types only.
+```
+
+## Caso de uso de ejemplo
+**Error:**
+```
+src/api/orders.ts:45:18 - error TS2345:
+Argument of type 'string | undefined' is not assignable to parameter of type 'string'.
+```
+
+**Lo que devuelve el Resolvedor:**
+- Causa: `req.params.id` es `string | undefined` pero `getOrder()` espera `string`
+- Corrección: agregar una guarda `if (!req.params.id) return res.status(400).json({ error: 'id required' })` antes de la llamada — TypeScript reduce el tipo después de la guarda
+- Mínimo: adición de 2 líneas, sin cambio de lógica
+
+---
+
+> **Trabaja con nosotros:** Claudient está respaldado por [Uitbreiden](https://uitbreiden.com/) — construimos productos de IA y soluciones B2B con comunidades de desarrolladores. [uitbreiden.com](https://uitbreiden.com/)

package/agents/build-resolvers/fr/python-resolver.md

@@ -0,0 +1,64 @@
+> 🇫🇷 This is the French translation. [English version](../python-resolver.md).
+
+# Agent Résolveur de Build Python
+
+## Objectif
+Diagnostique et corrige les erreurs d'import Python, les exceptions runtime, les incompatibilités d'annotations de type (mypy) et les conflits de dépendances — en retournant le code corrigé avec une explication.
+
+## Conseil sur le modèle
+**Haiku 4.5** pour les erreurs dans un seul fichier (ImportError, AttributeError, NameError, problèmes simples d'annotations de type).
+
+**Sonnet 4.6** pour les erreurs couvrant plusieurs modules, les imports circulaires, les échecs mypy en mode strict, ou les conflits de versions de dépendances.
+
+## Outils
+- `Read` — lire le fichier en échec et les modules liés
+- `Edit` — appliquer des corrections ciblées
+- `Bash` — exécuter `python -m mypy file.py 2>&1`, `python -c "import module"`, `pip show package` pour diagnostiquer
+
+## Quand déléguer ici
+- `ImportError` ou `ModuleNotFoundError` au démarrage ou à l'exécution des tests
+- Échecs de vérification de type `mypy` dans une base de code strictement typée
+- `AttributeError: module 'x' has no attribute 'y'` (API changée lors d'une mise à niveau de package)
+- Erreurs d'import circulaire
+- Conflits de versions de dépendances (`pip install` échoue ou produit des versions incompatibles)
+
+## Quand NE PAS déléguer ici
+- Bugs de logique qui ne sont pas des erreurs d'import/type
+- Problèmes de performance
+- Erreurs runtime causées par une logique métier incorrecte (pas des erreurs Python structurelles)
+
+## Template de prompt
+```
+You are a Python error resolver. Fix the error — minimal changes only. Do not refactor.
+
+Error:
+[paste full traceback or mypy output]
+
+Relevant files:
+[paste file contents where errors occur]
+
+Python version: [e.g., 3.12]
+Package versions: [paste pip freeze output if relevant]
+
+For each error:
+1. Explain why the error occurs in one sentence
+2. Apply the minimal fix
+3. If a dependency version conflict: specify the exact version constraint to add/change
+
+Do not change logic. Do not refactor. Fix the error only.
+```
+
+## Exemple de cas d'utilisation
+**Erreur :**
+```
+ImportError: cannot import name 'AsyncClient' from 'httpx' (0.23.0)
+```
+
+**Ce que retourne le Résolveur :**
+- Cause : `AsyncClient` a été ajouté dans `httpx 0.18.0` mais l'utilisation nécessite `httpx>=0.23.0` pour l'API spécifique utilisée
+- Correction : mettre à jour `requirements.txt` vers `httpx>=0.23.0,<1.0.0` et exécuter `pip install -r requirements.txt`
+- Si impossible de mettre à niveau : montrer le code équivalent pour la version installée
+
+---
+
+> **Travaillez avec nous :** Claudient est soutenu par [Uitbreiden](https://uitbreiden.com/) — nous construisons des produits IA et des solutions B2B avec des communautés de développeurs. [uitbreiden.com](https://uitbreiden.com/)

package/agents/build-resolvers/fr/typescript-resolver.md

@@ -0,0 +1,65 @@
+> 🇫🇷 This is the French translation. [English version](../typescript-resolver.md).
+
+# Agent Résolveur de Build TypeScript
+
+## Objectif
+Diagnostique et corrige les erreurs de compilation TypeScript, les incompatibilités de types et les échecs `tsc` — en retournant le code corrigé avec une explication de ce qui était incorrect.
+
+## Conseil sur le modèle
+**Haiku 4.5** pour les erreurs de type simples (propriété manquante, mauvais type d'argument, fuite de `any`).
+
+**Sonnet 4.6** quand les erreurs couvrent plusieurs fichiers, impliquent des contraintes de types génériques, des types conditionnels, ou des chaînes d'inférence de type complexes.
+
+## Outils
+- `Read` — lire le fichier en échec et les définitions de type pertinentes
+- `Edit` — appliquer des corrections ciblées (changements minimaux uniquement)
+- `Bash` — exécuter `npx tsc --noEmit 2>&1` pour confirmer la correction, `grep` pour les définitions de type liées
+
+## Quand déléguer ici
+- `tsc --noEmit` échoue avec des erreurs de type que vous voulez diagnostiquer et corriger
+- Erreurs `Type 'X' is not assignable to type 'Y'` qui ne sont pas immédiatement évidentes
+- Échecs d'inférence de type générique
+- Incompatibilités de définitions de type tierces (ex: après mise à niveau d'un package)
+- Correction de types `any` qui ont fui dans la base de code
+
+## Quand NE PAS déléguer ici
+- Erreurs runtime qui ne sont pas des erreurs de type
+- Violations de règles ESLint (pas de compilation TypeScript)
+- Bugs de logique qui passent la vérification de type
+
+## Template de prompt
+```
+You are a TypeScript error resolver. Fix the type errors — minimal changes only. Do not refactor.
+
+Error output from tsc:
+[paste full tsc error output]
+
+Relevant files:
+[paste file contents where errors occur]
+
+Type definitions context (if relevant):
+[paste relevant .d.ts or interface definitions]
+
+For each error:
+1. Explain why the error occurs in one sentence
+2. Apply the minimal fix
+3. Confirm the fix is correct by reasoning through the types
+
+Do not change logic. Do not refactor. Fix types only.
+```
+
+## Exemple de cas d'utilisation
+**Erreur :**
+```
+src/api/orders.ts:45:18 - error TS2345:
+Argument of type 'string | undefined' is not assignable to parameter of type 'string'.
+```
+
+**Ce que retourne le Résolveur :**
+- Cause : `req.params.id` est `string | undefined` mais `getOrder()` attend `string`
+- Correction : ajouter une garde `if (!req.params.id) return res.status(400).json({ error: 'id required' })` avant l'appel — TypeScript restreint le type après la garde
+- Minimal : ajout de 2 lignes, pas de changement de logique
+
+---
+
+> **Travaillez avec nous :** Claudient est soutenu par [Uitbreiden](https://uitbreiden.com/) — nous construisons des produits IA et des solutions B2B avec des communautés de développeurs. [uitbreiden.com](https://uitbreiden.com/)