Мечтай по-крупному. Реализуй по плану.
Арман по-казахски означает «мечта». Именно поэтому свой новый инструмент я назвал Armanda.
Работая с AI-разработкой, я заметил простую проблему: чем больше проект, тем выше шанс через час работы получить совсем не тот результат, который задумывался. Не потому что ИИ ошибается. А потому что без системы любая большая идея постепенно уходит в сторону.
Поэтому я создал
/armanda— простой процесс из четырёх шагов:
- Понять мечту и зафиксировать цель.
- Построить план без написания кода.
- Реализовать строго по плану.
- Проверить результат независимым взглядом.
За годы бизнеса я понял одну вещь: проблема не в том, что люди мечтают слишком масштабно. Проблема в том, что они пытаются реализовать большие идеи без структуры.
Мечтайте смело. Но двигайтесь по плану.
EN (short):
armandais a Claude Code skill that turns "just start coding" into a disciplined 4-gate pipeline: context → plan → code → review. Each gate has a hard stop that requires your explicit approval before moving on. Ships with two read-only sub-agents —reviewerandtester. Russian docs below. Invoke with/armanda.
armanda — скилл для Claude Code, который превращает «сел и начал кодить» в нормальный дев-процесс. Сначала понять, потом спроектировать, и только затем писать. Цель — убрать неоднозначность до кода: без плана агент угадывает правильно лишь часть времени, и цепочка неоднозначных решений быстро уводит результат в мусор.
Запускается командой /armanda.
Конвейер из 4 гейтов со стоп-кранами между ними. Гейт не проходится без явного «ок» от тебя — это и есть главное свойство: без стоп-кранов процесс скатывается обратно в «prompt and pray».
| Гейт | Этап | Артефакт | Стоп-кран |
|---|---|---|---|
| 1 | Контекст и ТЗ | docs/specs/<дата>-<тема>.md |
Показать ТЗ, дождаться подтверждения |
| 2 | План (без кода) | plan.md в репозитории |
План утверждён до строчки кода |
| 3 | Кодинг строго по плану | код + чек-лист в plan.md |
— |
| 4 | Ревью и тесты | список правок, прогон сценариев | Передача на ручной клик-тест |
В Гейте 4 подключаются два изолированных read-only субагента:
reviewer— ищет баги, отклонения от ТЗ, дублирование, переусложнение, проблемы безопасности. Не он писал код → не выгораживает себя.tester— прогоняет ключевые сценарии из ТЗ, докладывает «ожидаемое vs фактическое». Продакшен-код не правит.
- Новая фича или модуль
- Изменения, затрагивающие БД / API / несколько слоёв
- Заметный рефакторинг
- Любая задача дольше ~15 минут работы
Однострочные правки, опечатки, тривиальные багфиксы, разовые вопросы. Гонять 4 гейта ради padding: 8px — это трение, а не польза.
# 1. Сам скилл
mkdir -p ~/.claude/skills/armanda
cp SKILL.md ~/.claude/skills/armanda/SKILL.md
# 2. Субагенты (живут отдельно, в ~/.claude/agents/)
mkdir -p ~/.claude/agents
cp agents/reviewer.md ~/.claude/agents/reviewer.md
cp agents/tester.md ~/.claude/agents/tester.mdИли одной командой через git:
git clone https://github.com/bronxtc52/armanda.git
cd armanda
mkdir -p ~/.claude/skills/armanda ~/.claude/agents
cp SKILL.md ~/.claude/skills/armanda/SKILL.md
cp agents/*.md ~/.claude/agents/В любом проекте внутри Claude Code:
/armanda хочу добавить экспорт отчётов в CSV
Дальше скилл сам проведёт через гейты: задаст уточняющие вопросы (по одному), зафиксирует ТЗ, войдёт в Plan Mode, и только после твоего «ок» начнёт писать код.
Повторный вызов /armanda с фидбеком заходит сразу в Гейт 2 — ТЗ и план уже есть, обновляем их, а не собираем с нуля.
- Один фокус на сессию. Свежий контекст лучше деградировавшего. Новая фича → новая сессия.
- Простейший подход. Не переусложнять. Техлид (ты) режет «умничанье».
- Артефакты в репо. ТЗ и план — файлы в git, не в голове. Переживают compaction, дают историю.
- Привязка к сценариям. Каждая строка кода отвечает на «какой сценарий из ТЗ это закрывает».
armanda/
├── SKILL.md # сам скилл (в ~/.claude/skills/armanda/)
└── agents/
├── reviewer.md # субагент ревью (в ~/.claude/agents/)
└── tester.md # субагент тестов (в ~/.claude/agents/)