К основному содержанию
субагент CX Codex

observer — субагент для Claude Code: что делает и как установить

observer — фоновый субагент Claude Code, который разбирает журнал наблюдений и превращает повторяющиеся эпизоды в правила-инстинкты с оценкой уверенности.

MIT ★ 880 обновлён 2026-09-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/observer.md
Открыть на GitHub

Что делает observer

observer работает в фоне: читает журнал наблюдений из ~/.claude/homunculus/observations.jsonl и складывает найденные закономерности в ~/.claude/homunculus/instincts/personal/ — по одному YAML-файлу на инстинкт, с полями trigger, confidence, domain и списком доказательств.

Ловит четыре вещи: правки пользователя после ответа Claude, ошибки с последующим исправлением, повторяющиеся цепочки инструментов и устойчивые привычки вроде Grep перед Edit. Запускается после 20+ вызовов инструментов, по команде /analyze-patterns, по таймеру (по умолчанию 5 минут) или по сигналу SIGUSR1 от хука наблюдения. Модель — Haiku, из инструментов доступны Read, Write, Glob, Grep.

Уверенность растёт с частотой: 1–2 наблюдения дают 0.3, 11 и больше — 0.85, дальше +0.05 за подтверждение и −0.02 в неделю без повторов. Инстинкт пишется только после 3 наблюдений одного паттерна, а вместо фрагментов кода в файл попадает описание привычки. Если хук не наполняет журнал, анализировать нечего, и правила не появятся.

Какие задачи решает

  • вытащить из сессии повторяющуюся цепочку Grep → Read → Edit
  • зафиксировать правку пользователя как правило на будущий раз
  • взвесить, сколько раз паттерн подтверждался, прежде чем ему доверять
  • свести похожий инстинкт к существующему вместо дубля
  • держать отдельно личные наблюдения и конвенции, пришедшие из анализа репозитория

Примеры запросов агенту

  • Запусти /analyze-patterns и покажи, какие паттерны нашёл observer.
  • Просмотри ~/.claude/homunculus/observations.jsonl и обнови инстинкты в instincts/personal/.
  • Снизь уверенность инстинкта про Grep перед Edit: в прошлый раз он не сработал.

Как установить observer

Вручную: положить файлы

.claude/agents/observer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об observer

Как установить observer в Claude Code?

Файл субагента кладут в проект по пути .claude/agents/observer.md.

Что делает observer?

В фоне читает наблюдения сессии, ищет в них повторы и ошибки с исправлениями, а результат сохраняет как инстинкты с триггером, уверенностью и доказательствами.

Что нужно, чтобы инстинкты появились?

Журнал ~/.claude/homunculus/observations.jsonl, который наполняет хук наблюдения, и хотя бы 3 наблюдения одного паттерна: раньше этого порога агент правило не создаёт.

Исходный текст

observer.md · MIT
---
name: observer
description: Background agent that analyzes session observations to detect patterns and create instincts. Uses Haiku for cost-efficiency.
tools: ["Read", "Write", "Glob", "Grep"]
model: haiku
run_mode: background
---

# Observer Agent

A background agent that analyzes observations from Claude Code sessions to detect patterns and create instincts.

## When to Run

- After significant session activity (20+ tool calls)
- When user runs `/analyze-patterns`
- On a scheduled interval (configurable, default 5 minutes)
- When triggered by observation hook (SIGUSR1)

## Input

Reads observations from `~/.claude/homunculus/observations.jsonl`:

```jsonl
{"timestamp":"2025-01-22T10:30:00Z","event":"tool_start","session":"abc123","tool":"Edit","input":"..."}
{"timestamp":"2025-01-22T10:30:01Z","event":"tool_complete","session":"abc123","tool":"Edit","output":"..."}
{"timestamp":"2025-01-22T10:30:05Z","event":"tool_start","session":"abc123","tool":"Bash","input":"npm test"}
{"timestamp":"2025-01-22T10:30:10Z","event":"tool_complete","session":"abc123","tool":"Bash","output":"All tests pass"}
```

## Pattern Detection

Look for these patterns in observations:

### 1. User Corrections
When a user's follow-up message corrects Claude's previous action:
- "No, use X instead of Y"
- "Actually, I meant..."
- Immediate undo/redo patterns

→ Create instinct: "When doing X, prefer Y"

### 2. Error Resolutions
When an error is followed by a fix:
- Tool output contains error
- Next few tool calls fix it
- Same error type resolved similarly multiple times

→ Create instinct: "When encountering error X, try Y"

### 3. Repeated Workflows
When the same sequence of tools is used multiple times:
- Same tool sequence with similar inputs
- File patterns that change together
- Time-clustered operations

→ Create workflow instinct: "When doing X, follow steps Y, Z, W"

### 4. Tool Preferences
When certain tools are consistently preferred:
- Always uses Grep before Edit
- Prefers Read over Bash cat
- Uses specific Bash commands for certain tasks

→ Create instinct: "When needing X, use tool Y"

## Output

Creates/updates instincts in `~/.claude/homunculus/instincts/personal/`:

```yaml
---
id: prefer-grep-before-edit
trigger: "when searching for code to modify"
confidence: 0.65
domain: "workflow"
source: "session-observation"
---

# Prefer Grep Before Edit

## Action
Always use Grep to find the exact location before using Edit.

## Evidence
- Observed 8 times in session abc123
- Pattern: Grep → Read → Edit sequence
- Last observed: 2025-01-22
```

## Confidence Calculation

Initial confidence based on observation frequency:
- 1-2 observations: 0.3 (tentative)
- 3-5 observations: 0.5 (moderate)
- 6-10 observations: 0.7 (strong)
- 11+ observations: 0.85 (very strong)

Confidence adjusts over time:
- +0.05 for each confirming observation
- -0.1 for each contradicting observation
- -0.02 per week without observation (decay)

## Important Guidelines

1. **Be Conservative**: Only create instincts for clear patterns (3+ observations)
2. **Be Specific**: Narrow triggers are better than broad ones
3. **Track Evidence**: Always include what observations led to the instinct
4. **Respect Privacy**: Never include actual code snippets, only patterns
5. **Merge Similar**: If a new instinct is similar to existing, update rather than duplicate

## Example Analysis Session

Given observations:
```jsonl
{"event":"tool_start","tool":"Grep","input":"pattern: useState"}
{"event":"tool_complete","tool":"Grep","output":"Found in 3 files"}
{"event":"tool_start","tool":"Read","input":"src/hooks/useAuth.ts"}
{"event":"tool_complete","tool":"Read","output":"[file content]"}
{"event":"tool_start","tool":"Edit","input":"src/hooks/useAuth.ts..."}
```

Analysis:
- Detected workflow: Grep → Read → Edit
- Frequency: Seen 5 times this session
- Create instinct:
  - trigger: "when modifying code"
  - action: "Search with Grep, confirm with Read, then Edit"
  - confidence: 0.6
  - domain: "workflow"

## Integration with Skill Creator

When instincts are imported from Skill Creator (repo analysis), they have:
- `source: "repo-analysis"`
- `source_repo: "https://github.com/..."`

These should be treated as team/project conventions with higher initial confidence (0.7+).

© sangrokjung · MIT · sangrokjung/claude-forge

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
task-observer Eoghan Henn and contributors Скилл task-observer для Claude Code собирает исправления, рабочие процессы и решения из сессий в обновления навыков. Запускается перед первым вызовом инструментов в сеансе. CX Codex +1 19 300установок munger-observer jdrhyne Скилл munger-observer для Claude Code разбирает решение, план или документ, отделяет факты от выводов и предлагает проверку. Помогает проводить премортем и искать слабые места. CX Codex +1 ★ 239звёзд репо observer-pattern patterns.dev Скилл observer-pattern объясняет паттерн наблюдателя и подсказывает агенту, как строить слабосвязанную подписку на события в JS и TS. CX Codex +1 661установок machine-learning Mindrally Скилл machine-learning для Claude Code и Codex: настраивает агента на ML-разработку с JAX и функциональным программированием. Включается при автодифференцировании, JIT-компиляции и векторизации через jax.grad, jax.jit, jax.vmap. CX Codex +1 2 200установок help Donchitos Скилл help определяет текущий этап разработки игры по артефактам и подсказывает следующий шаг. Помогает сориентироваться, когда непонятно, за какую задачу браться. CX Codex +1 633установок codebase-pattern-finder davila7 Субагент codebase-pattern-finder находит примеры готовых реализаций в проекте, чтобы использовать их как образцы для нового кода. CX Codex 300установок

Из того же набора44

Весь набор →
task-grade-routing Правило task-grade-routing определяет объём документации и число независимых проверок под размеры задач S, M, L и XL при работе с классификатором воркфлоу. CX Codex +1 ★ 880звёзд репо frontend-code-review Скилл frontend-code-review проверяет фронтенд-код по чек-листу и оформляет замечания по заданному шаблону. Запускайте его для изменений перед коммитом или ревью конкретных файлов. CX Codex +1 ★ 880звёзд репо instinct-import Команда instinct-import забирает инстинкты из файла или по URL, сверяет их с уже накопленными и раскладывает по хранилищу с пометкой об источнике. CX Codex +1 ★ 880звёзд репо database-reviewer Субагент database-reviewer для Claude Code, который проверяет SQL-миграции, индексы и политики RLS в проектах на PostgreSQL и Supabase. Помогает находить N+1 и оценивать планы через EXPLAIN ANALYZE. CX Codex ★ 880звёзд репо verify-agent Субагент verify-agent свежего контекста для Claude Code. Запускает проверку типов, линтеры, сборку и тесты, автоматически исправляя простые ошибки импортов и синтаксиса. CX Codex ★ 880звёзд репо evolve Команда evolve для Claude Code группирует связанные инстинкты в команды, скиллы и субагентов. Собирает накопленные правила в рабочие структуры. CX Codex +1 ★ 880звёзд репо systematic-debugger Субагент systematic-debugger для Claude Code разбирает воспроизводимые баги: проверяет падающий тест, ищет сломавший коммит, тестирует гипотезы и фикс. CX Codex ★ 880звёзд репо humanize-korean Скилл humanize-korean правит переводные обороты и шаблонные фразы ИИ в готовом корейском тексте, сохраняя факты, числа, имена и цитаты. Работает за один проход. CX Codex +1 ★ 880звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой