Claude Interactive Documentation Workflow — скилл
Методика «сначала документация, потом код» для Claude Code: скилл /interview, шаблоны документов и планов, передача работы.
- 105 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл только ведет диалог и пишет файлы документации в репозитории; внешних сервисов нет.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/claude-interactive-documentation-workflowОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл только ведет диалог и пишет файлы документации в репозитории; внешних сервисов нет.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий описывает порядок работы над фичей: интервью или расследование, затем документация, затем план и только после этого реализация. Для каждого этапа есть руководство с проверочными точками. Установленный в проекте скилл `/interview` ведет четыре прохода опроса и собирает основу для документа. Остальное лежит в `documentation/`: правила составления планов, передачи работы, ревью расследований и тестирования на живой системе, готовый шаблон правил пользовательского уровня и рецепт внедрения методики в чужой репозиторий.
Для кого. Разработчикам, которые ведут проекты с Claude Code и хотят иметь документы и планы, понятные модели и людям через полгода.
Подходит, если
- Перед большой фичей нужно выяснить требования опросом.
- Сырые заметки расследования переводят в документ и план.
- Работу передают другой сессии, и нужен структурированный файл передачи.
- Методику хотят перенести в свой репозиторий по готовому рецепту.
Не подходит, если
- Нужна быстрая правка в одну строку без документов.
- Команда не готова вести отдельные файлы документации и планов.
- Нужен скилл без примеров из чужого проекта.
Пример запроса к агенту
Проведи интервью по фиче «вход по почте» и собери из ответов документ по правилам из `documentation/`.Ограничения
Примеры взяты из реального проекта (компьютерное зрение, отслеживание судов), и автор оставил их намеренно: термины и префиксы придется заменить своими. Лицензия определяется автоматически как NOASSERTION, поэтому условия повторного использования проверяйте в файле `LICENSE`. Последний коммит сделан в июле 2026. Цифры из кейса автор считал сам. Методика требует дисциплины: без регулярного обновления документов и планов они расходятся с кодом.
Как отключить. Удалите `.claude/skills/interview` из проекта или из `~/.claude/skills`, а добавленные в `.claude/CLAUDE.md` строки методики уберите вручную.
Частые вопросы
Как запустить интервью?
В Claude Code вызовите `/interview` с темой, например `/interview user authentication system`. Скилл уже лежит в проекте.
Как поставить скилл в свой проект?
Создайте `.claude/skills/interview` и скопируйте туда `documentation/general_interview_methodology_skill.md` как `SKILL.md`. Для всех проектов копируйте в `~/.claude/skills`.
Что такое расследование в этой методике?
Это свободный сбор сведений о существующем или сломанном. Когда материал созрел, он идет в те же документ и план, что и интервью.
Работает ли методика с другими моделями?
Автор пишет, что подход годится для любой модели, но скилл `/interview` рассчитан на Claude Code.
Откуда начать внедрение?
С файла `documentation/general_methodology_adoption_recipe.md`. Это единый справочник: что копировать, куда класть и что вставить в `.claude/CLAUDE.md`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыРепозиторий курса Claude Code для продакт-менеджеров: 55 скиллов, слеш-команды, субагенты и демо-приложения с заданиями по модулям
Claude Code Toolkit (robertguss)
Claude Code Toolkit
Набор скиллов и хуков для Claude Code: брейншторм, ведение проекта воркерами, вики, конвейер книги.
100 рецептов Claude Code для офисной работы и шесть готовых скиллов: протоколы встреч, отчеты, сводки, чистка данных
Скилл ведет память проекта в обычных Markdown-файлах: журнал сессий, вики, правила, список дел и заметка о том, откуда продолжить
Плагин Claude Code, который ловит ваши поправки в диалоге и после проверки записывает их в CLAUDE.md и AGENTS.md
Файл CLAUDE.md и AGENTS.md с семью принципами: агент сначала формулирует проблему и объем, потом пишет код
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Interactive Documentation Workflow (эта карточка) | нет | 105 | |
| Spec-Driven Development | нет | 158 | предлагает подход к спецификациям; здесь добавлены интервью, расследование и правила передачи работы |
| Interview Skills | нет | 402 | учит проводить интервью с другой целью; здесь опрос готовит документацию и план фичи |
Коротко о README
Методика применялась в трех и более проектах, по словам автора, и вынесена вместе с кейсом на основе истории git. Рецепт внедрения рассчитан на агента.