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

save-session-learnings — команда для Claude Code

Команда save-session-learnings переносит важные выводы из сессии в CLAUDE.md и AGENTS.md. Запускайте её после отладки или крупной задачи, чтобы сохранить контекст для следующих сессий.

MIT ★ 1 424 обновлён 2026-10-06

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

Что делает save-session-learnings

Команда собирает сведения о работе: смотрит историю и изменения Git, а также учитывает решения, найденные причины ошибок, рабочие команды и особенности проекта из переписки. Затем сверяет выводы с CLAUDE.md и AGENTS.md, чтобы не добавлять уже записанное.

Новые заметки команда добавляет в оба файла в корне проекта. Она может создать раздел Session Log или дополнить разделы вроде Gotchas, Patterns и Commands; записи должны быть краткими и помогать действовать. Файлы остаются синхронизированными. Для команд Git используется история с HEAD~5, поэтому в репозитории без такой истории этот сбор контекста может не сработать.

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

  • сохранить причину исправленной ошибки и её решение
  • перенести архитектурные решения в документацию проекта
  • зафиксировать рабочие команды сборки и тестирования
  • найти и обновить устаревшие заметки без дублирования

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

  • /save-session-learnings — сохрани выводы из этой отладки в CLAUDE.md и AGENTS.md.
  • /save-session-learnings — запиши архитектурные решения и рабочие команды из текущей сессии.
  • /save-session-learnings — проверь существующую документацию и добавь новые особенности проекта.

Как установить save-session-learnings

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

.claude/commands/save-session-learnings.md

Вызов — /save-session-learnings. Для всех проектов — ~/.claude/commands/

Вопросы о save-session-learnings

Как установить save-session-learnings в Claude Code?

Поместите файл команды по пути .claude/commands/save-session-learnings.md.

Что делает save-session-learnings?

Команда выделяет важные находки из сессии, сверяет их с документацией проекта и записывает новые или обновлённые заметки в CLAUDE.md и AGENTS.md.

Какие файлы обновляет команда?

Она обновляет CLAUDE.md и AGENTS.md в корне проекта и сохраняет в них одинаковые выводы.

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

save-session-learnings.md · MIT
---
allowed-tools: Read, Write, Edit, Glob, Grep, Bash(git:*)
description: Document session learnings to CLAUDE.md and AGENTS.md. Use after completing significant tasks, debugging sessions, or discovering project patterns.
---

# Save Session Learnings

Capture and persist significant discoveries from this session into project documentation so knowledge survives across sessions and agents.

## Phase 1: Gather Session Context

Collect evidence of what was learned during this session:

```bash
git diff HEAD~5 --stat
git log --oneline -10
git diff --name-only HEAD~5
```

Also review the conversation history for:

- Bugs that were debugged (root cause + fix)
- Architecture decisions made
- Configuration or environment discoveries
- Patterns established or followed
- Commands that worked (or failed)
- Gotchas and edge cases encountered

## Phase 2: Categorize Learnings

Sort each finding into one of these categories:

### Architecture

- Key files, folders, data flow, component relationships
- Service boundaries, module dependencies

### Patterns

- Naming conventions, code style, recurring design patterns
- File structure conventions, import ordering

### Gotchas

- Things that break, common errors, non-obvious behavior
- Workarounds for known issues

### Commands

- Build, test, deploy, dev server commands that work
- Tool-specific invocations with correct flags

### Decisions

- Why something was done a certain way
- Trade-offs considered, alternatives rejected

## Phase 3: Check Existing Documentation

Before writing, read both files to avoid duplicating entries:

1. Use Glob to check if `CLAUDE.md` and `AGENTS.md` exist in the project root
2. If they exist, Read them fully
3. Compare gathered learnings against existing entries
4. Skip anything already documented
5. If existing entries are outdated, update them instead of adding duplicates

## Phase 4: Write Learnings

Update both `CLAUDE.md` and `AGENTS.md` in the project root (create if missing).

### Format for New Entries

Append to the `## Session Log` section (create it if absent). Use this format:

```markdown
## Session Log

- YYYY-MM-DD: [Category] Brief, actionable description of what was learned
```

For structured learnings, append to the relevant section (`### Gotchas`, `### Patterns`, etc.) or create the section if it does not exist:

```markdown
### Gotchas

- `short description` -- explanation of the issue and the workaround

### Patterns

- Pattern name -- where it applies and why

### Commands

- `command here` -- what it does, when to use it
```

### Rules

- **Concise**: Each entry should be 1-2 lines max. Favor telegraphic style.
- **Actionable**: Write entries that help a future developer take action, not just understand history.
- **No duplicates**: If the learning is already documented, skip it or update the existing entry.
- **Date stamp**: Always include today's date in Session Log entries.
- **Both files**: CLAUDE.md and AGENTS.md must contain the same learnings. Keep them in sync.
- **Preserve existing content**: Never overwrite or remove existing entries. Only append or update.

## Phase 5: Confirm

After writing, summarize what was added:

```
## Learnings Saved

- **New entries added**: X
- **Existing entries updated**: Y
- **Skipped (already documented)**: Z

### Added
1. [Category] Description
2. [Category] Description

### Updated
1. [What changed and why]
```

## When to Use

- After completing a significant feature or bug fix
- After a long debugging session
- After discovering non-obvious project behavior
- After setting up a new tool or integration
- Before ending a session where important context was built up
- When you realize "a future me would want to know this"

© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
session-learnings sentimony Скилл session-learnings для Claude Code сохраняет повторно полезные выводы из сессии в заметках проекта. По отдельному запросу он сортирует их для переноса в инструкции или проверку. CX Codex +1 115установок question disler Команда question для Claude Code отвечает на вопросы о структуре и документации проекта, читая репозиторий без изменений. CX Codex +1 ★ 3 990звёзд репо session-handoff softaworks Скилл session-handoff создаёт документы передачи контекста между сессиями агента. Помогает при переполнении окна контекста и долгих проектах. CX Codex +1 4 300установок session-wrap ai-native-camp Скилл session-wrap разбирает завершённую работу перед закрытием сессии: что закоммитить, какие знания записать, какие задачи остались. CX Codex +1 1 300установок project-session-manager Yeachan-Heo Скилл project-session-manager автоматизирует создание отдельных git-воркtræев для каждой задачи, PR или фичи, с опциональной оркестровкой tmux-сессий. Позволяет параллельно работать над несколькими ветками без конфликтов. CX Codex +1 937установок session-to-skill entireio Скилл session-to-skill для Claude Code превращает историю сессий Entire в черновик повторяемого рабочего процесса. Он собирает правила, команды и проверки для будущих запусков. CX Codex +1 504установок

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

Весь набор →
parallel-review Команда parallel-review запускает проверку кода в нескольких папках или файлах одновременно — по субагенту на каждую цель. CX Codex +1 ★ 1 424звёзд репо code-simplifier Команда code-simplifier разбирает недавние изменения и предлагает упростить код без смены поведения. Пригодится после реализации новой функции или рефакторинга. CX Codex +1 ★ 1 424звёзд репо security-scan Команда security-scan прогоняет репозиторий на захардкоженные секреты, уязвимые зависимости, инъекции и слабые настройки конфигурации. Удобно запускать перед коммитом или пул-реквестом. CX Codex +1 ★ 1 424звёзд репо verify-changes Команда verify-changes запускает параллельную проверку свежих правок через субагентов и состязательный фильтр ложных срабатываний. CX Codex +1 ★ 1 424звёзд репо analyzing-projects Скилл analyzing-projects разбирает незнакомый репозиторий по шагам: стек, структура, паттерны, команды разработки — пригодится при входе в новый проект. CX Codex +1 ★ 1 424звёзд репо plan Создаёт и ведёт файл PLAN.md в корне проекта для фиксации этапов разработки, зависимостей между задачами и лога прогресса. CX Codex +1 ★ 1 424звёзд репо refactor-guided Команда refactor-guided проводит структурный рефакторинг по шагам и проверяет тесты после каждого изменения. Подходит для безопасной перестройки кода без добавления функций. CX Codex +1 ★ 1 424звёзд репо convex-backend Скилл convex-backend загружает guidelines для работы с Convex: функции, схемы, валидаторы, queries, mutations, actions, подписки и хранилище файлов. Помогает писать типобезопасный бэкенд на TypeScript. CX Codex +1 ★ 1 424звёзд репо

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

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