kbrdn1/dotfiles/agent-template

Template: Sous-Agent Claude Code

Les sous-agents sont des fichiers markdown avec frontmatter YAML dans .claude/agents/ (projet) ou ~/.claude/agents/ (global). Chaque sous-agent s'execute dans sa propre fenetre de contexte avec une invite systeme personnalisee, des outils specifiques et des permissions independantes.

Format du Fichier Agent

---
name: {{AGENT_NAME}}
description: {{DESCRIPTION}}
tools: {{TOOLS}}
model: {{MODEL}}
permissionMode: {{PERMISSION_MODE}}
skills:
  -{{SKILL_TO_PRELOAD}}
hooks:
  PreToolUse:
    -matcher: "{{TOOL_NAME}}"
      hooks:
        -type: command
          command: "{{VALIDATION_SCRIPT}}"
---
 
{{SYSTEM_PROMPT}}
 
Tu es {{AGENT_NAME}}, {{ROLE_DESCRIPTION}}.
 
## Expertise
-{{EXPERTISE_1}}
-{{EXPERTISE_2}}
-{{EXPERTISE_3}}
 
## Quand invoque:
1.{{STEP_1}}
2.{{STEP_2}}
3.{{STEP_3}}
 
## Regles
-Ne JAMAIS: {{NEVER_DO}}
-TOUJOURS: {{ALWAYS_DO}}
-Demander confirmation avant: {{CONFIRM_BEFORE}}
 
## Format de sortie
{{OUTPUT_FORMAT}}

Reference des Champs Frontmatter

Modes de Permission

Agents Built-in

Integration avec les Skills

Precharger des skills dans un agent

---
name: api-developer
description: Implement API endpoints following team conventions
skills:
  - api-conventions
  - error-handling-patterns
---

Le contenu complet des skills est injecte au demarrage. Les sous-agents n'heritent PAS des skills de la conversation parent.

Referencer un agent depuis une skill

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: {{AGENT_NAME}}
---
 
Instructions pour le sous-agent...

Avec context: fork, le contenu de la skill devient le prompt du sous-agent.

Hooks dans les Agents

PreToolUse (valider avant execution)

hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-command.sh"

PostToolUse (action apres execution)

hooks:
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/run-linter.sh"

Stop (nettoyage a la fin)

hooks:
  Stop:
    - hooks:
        - type: command
          command: "./scripts/cleanup.sh"

Variables:

• {{AGENT_NAME}}: Nom (kebab-case, lettres minuscules, tirets)
• {{DESCRIPTION}}: Quand Claude doit deleguer a cet agent
• {{TOOLS}}: Outils autorises. Ex: Read, Grep, Glob, Bash
• {{MODEL}}: sonnet (defaut), opus, haiku, inherit
• {{PERMISSION_MODE}}: default, acceptEdits, dontAsk, bypassPermissions, plan
• {{SKILL_TO_PRELOAD}}: Nom de skill a precharger
• {{SYSTEM_PROMPT}}: Invite systeme complete en markdown