Definiowanie subagenta w pliku

Subagenta projektowego definiujesz jako plik Markdown z nagłówkiem YAML, zapisany w katalogu .claude/agents/ projektu. Wartości w nagłówku opisują konfigurację, a treść pliku staje się promptem systemowym kierującym zachowaniem subagenta. Definicja projektowa nadaje się do pracy specyficznej dla danego codebase’u i może być współdzielona przez zespół po dodaniu jej do kontroli wersji.

Utwórz plik w .claude/agents/ ręcznie albo poproś Claude’a o jego utworzenie; użyj rozszerzenia Markdown i umieść konfigurację w YAML frontmatter. W frontmatter określ name i description, a zależnie od potrzeb także tools oraz model; dokumentowany przykład zawiera te pola przed treścią promptu. Napisz prompt w treści Markdown, pamiętając, że subagent otrzymuje właśnie ten prompt oraz podstawowe informacje o środowisku, a nie prompt systemowy Claude Code.

Claude Code skanuje katalogi .claude/agents/ rekurencyjnie, więc definicje możesz porządkować w podfolderach, takich jak agents/review/ lub agents/research/. Ścieżka podfolderu nie zmienia identyfikacji ani sposobu wywołania subagenta, ponieważ jego tożsamość wynika wyłącznie z pola name. Pilnuj unikalności nazw w całym drzewie jednego .claude/agents/: przy duplikacie Claude Code ładuje tylko jedną definicję, wybieraną według kolejności odczytu systemu plików.

Po dodaniu lub edycji pliku na dysku Claude Code wykrywa zmianę w ciągu kilku sekund, a następna delegacja korzysta ze zaktualizowanej definicji bez restartu. Restart jest jednak potrzebny po utworzeniu pierwszego pliku w nowym katalogu agents, ponieważ obserwowane są tylko katalogi istniejące przy starcie sesji. Jeśli frontmatter projektu zawiera hooki, zaakceptuj dialog zaufania dla folderu zawierającego plik; bez tego subagent nadal działa, ale jego hooki są pomijane.

.claude/agents/code-reviewer.md
```markdown
---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.
```

.claude/agents/code-improver.md
```markdown
---
name: code-improver
description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code.
tools: Read, Grep, Glob
model: sonnet
---

You are a code improvement specialist. For each issue you find, explain
the problem, show the current code, and provide an improved version.
```