# gsd-pattern-mapper

Субагент gsd-pattern-mapper ищет в кодовой базе аналоги для новых файлов и собирает PATTERNS.md с примерами импортов, авторизации, обработки ошибок. Запускается оркестратором /gsd:plan-phase перед планированием.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 3785 у репозитория
- Автор: davepoon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-pattern-mapper.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/gsd-pattern-mapper

## Что делает

Субагент читает `CONTEXT.md` и `RESEARCH.md`, извлекает список файлов, которые нужно создать или изменить, и классифицирует их по роли (контроллер, сервис, модель, middleware) и потоку данных (CRUD, streaming, event-driven). Для каждого файла ищет ближайший аналог в проекте через `Glob` и `Grep`, читает его и вытягивает конкретные фрагменты: блок импортов, паттерн авторизации, основную логику, обработку ошибок, валидацию. Результат — файл `PATTERNS.md`, который показывает планировщику `gsd-planner`, из какого файла и каких строк копировать код.

Субагент работает в режиме только для чтения: он не правит исходники, только анализирует их и пишет один файл — `PATTERNS.md` в директорию фазы. Инструменты: Read, Bash, Glob, Grep, Write. Для больших файлов (свыше 2 000 строк) сначала локализует нужные участки через `Grep`, потом читает их точечно с `offset` и `limit`, не перечитывая одни и те же диапазоны. Если в проекте есть `CLAUDE.md` или директория `.claude/skills/`, субагент читает их, чтобы извлечение паттернов совпадало с проектными соглашениями.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/gsd-pattern-mapper.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/gsd-pattern-mapper.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/gsd-pattern-mapper.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-pattern-mapper.md

## Когда брать
- найти существующий файл, с которого копировать структуру нового контроллера или компонента
- извлечь паттерн авторизации и обработки ошибок из аналогичного файла
- составить карту файлов-аналогов для планировщика перед генерацией кода
- классифицировать новые файлы по роли и потоку данных
- выгрузить конкретные фрагменты кода (импорты, middleware, валидация) с указанием строк

## Примеры запросов агенту
- Запусти `/gsd:plan-phase` — субагент сработает автоматически между этапами исследования и планирования
- Прочитай `PATTERNS.md` в директории фазы, чтобы увидеть, какие аналоги нашлись
- Добавь в `CLAUDE.md` соглашения по импортам — субагент учтёт их при извлечении паттернов

## Похожие
- [pattern-detection](https://affpapa.org/nevibecode/skills/pattern-detection.md) — скилл · 362 установки
- [agent-codebase-pattern-finder](https://affpapa.org/nevibecode/plugins/agent-codebase-pattern-finder.md) — плагин · ★ 2707 у репозитория
- [presentational-container-pattern](https://affpapa.org/nevibecode/skills/presentational-container-pattern.md) — скилл · 1200 установок
- [codebase-pattern-finder](https://affpapa.org/nevibecode/agents/codebase-pattern-finder.md) — субагент · 300 установок
- [improve](https://affpapa.org/nevibecode/skills/improve.md) — скилл · 42400 установок
- [module-pattern](https://affpapa.org/nevibecode/skills/module-pattern.md) — скилл · 655 установок

Из того же набора: [davepoon/buildwithclaude](https://affpapa.org/nevibecode/by/davepoon/buildwithclaude.md) — 235 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
