[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72Z5JVTGG37HN0DM3MZ7DC3":3,"skill-same:01M72Z5JVTGG37HN0DM3MZ7DC3":73},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M72Z5JVTGG37HN0DM3MZ7DC3","dev-workflow",null,"Правила производственного цикла разработки кода для всех проектов Jared.\nТирует задачу (XS \u002F M \u002F L), требует RFC перед кодом для M\u002FL, обязательный\nsmoke-тест даже на XS, мульти-агентное ревью для M\u002FL, `\u002Fsecurity-review` для\nL и любых фич с auth\u002Fданными, инцидент-лог в blameless-режиме, DOD-чеклист\nперед отчётом. Уровни безопасности S1→S3 подключаются инкрементально.\nПрименяется ТОЛЬКО к разработке кода — скрипты, приложения, MCP-серверы,\nSaaS. На продакт-задачи (Notion, Jira, Confluence, тексты, гипотезы) —\nне распространяется.\nTrigger when: новая задача на разработку кода, появляется \u002Fdev-workflow,\n\"начинаем фичу\", \"новая фича\", \"напиши скрипт\", \"подними MCP\", \"рефакторинг\",\n\"миграция\", \"архитектурное изменение\", \"новый подпроект\" — или когда\nпользователь спрашивает, какой тир у задачи.","enigmaicon-eng\u002FAI-Enterprise-OS","enigmaicon-eng","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F269773191?v=4","01M72YXXYN7Q7BYRHV8RAVYNWD","01M72YXXZPW35H56D6F1XSK84D",2,"MIT","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fclaude-dev-workflow\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fclaude-dev-workflow\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: dev-workflow\nversion: 0.1.0\ndescription: |\n  Правила производственного цикла разработки кода для всех проектов Jared.\n  Тирует задачу (XS \u002F M \u002F L), требует RFC перед кодом для M\u002FL, обязательный\n  smoke-тест даже на XS, мульти-агентное ревью для M\u002FL, `\u002Fsecurity-review` для\n  L и любых фич с auth\u002Fданными, инцидент-лог в blameless-режиме, DOD-чеклист\n  перед отчётом. Уровни безопасности S1→S3 подключаются инкрементально.\n  Применяется ТОЛЬКО к разработке кода — скрипты, приложения, MCP-серверы,\n  SaaS. На продакт-задачи (Notion, Jira, Confluence, тексты, гипотезы) —\n  не распространяется.\n  Trigger when: новая задача на разработку кода, появляется \u002Fdev-workflow,\n  \"начинаем фичу\", \"новая фича\", \"напиши скрипт\", \"подними MCP\", \"рефакторинг\",\n  \"миграция\", \"архитектурное изменение\", \"новый подпроект\" — или когда\n  пользователь спрашивает, какой тир у задачи.\nlicense: MIT\ncompatibility: claude-code\nallowed-tools:\n  - Read\n  - Write\n  - Edit\n  - Grep\n  - Glob\n  - Bash\n  - TodoWrite\n  - Agent\n---\n\n# dev-workflow — правила разработки кода\n\nСкилл применяется ко всем проектам Jared, где пишем код. Для продакт-задач\n(Notion, Jira, Confluence, тексты, оформление гипотез) не применяется — там\nработаем как раньше, без церемоний.\n\n## Шаг 0 — классификация\n\nВ начале задачи Claude определяет тир. Если неочевидно — называет предполагаемый\nтир и спрашивает пользователя, согласен ли он.\n\n| Тир | Триггер | Процесс |\n|---|---|---|\n| **XS** | \u003C 20 строк, багфикс, правка текста\u002Fконфига, однофайловое изменение | DOD → код → smoke-тест → self-review (`git diff`) → показать пользователю → commit |\n| **M** | новая фича, новый скрипт, 2+ файла, нетривиальная логика, новая интеграция | RFC → **approve пользователя** → код + тесты → линтер → code-review агент → показать diff + summary → commit |\n| **L** | архитектура, миграция, безопасность, ломающее изменение, новый подпроект, изменение public API | Полный RFC → **approve плана** → код по частям (feature flag если релевантно) → code-review + `\u002Fsecurity-review` → итог → **финальный approve** → merge |\n\n**Правило по умолчанию**: сомневаешься между тирами — выбирай выше.\n\n## Шаг 0.5 — образ результата (user-level, ДО кода)\n\nПеред RFC, перед кодом, перед техническими деталями — Claude формулирует\n**конкретизированный образ результата на user-level** и согласует его с\nпользователем. Это правило важнее RFC: RFC про архитектуру, образ\nрезультата — про UX. Оба нужны, но образ — первый.\n\n**Когда обязательно**: M \u002F L. Для XS — если задача неоднозначная или\nменяет user-visible поведение. Для тривиальных багфиксов \u002F опечаток \u002F \nправки конфига без UX-сдвига — пропускаем.\n\n**Шаблон**:\n\n```markdown\n## Что хочется получить\n\n[Как было] → [Как станет], глазами пользователя.\n\n- Какую команду \u002F действие даёт пользователь.\n- Что увидит на выходе (текст, файл, страницу, изменение в Notion \u002F Drive \u002F TSV).\n- Какие edge-cases обработаются («если X пустой — увидишь сообщение Y»).\n- Что **НЕ** входит в scope (что осталось ручным \u002F отложено \u002F отдельной задачей).\n\n## Куда это положить\n\n[Если правило \u002F процесс — в какой файл; если код — в какой модуль \u002F \nкоманду; если артефакт — в какой каталог.]\n```\n\n**Где живёт образ результата**:\n\n- Если у задачи есть BL-файл — в секции `## Plan` или отдельной секции\n  `## Что хочется получить`.\n- Если BL нет — отдельным сообщением в чате с явным «ОК» от пользователя.\n- Если нет ни BL, ни approval — Claude предлагает завести BL и записать\n  туда образ, ИЛИ зафиксировать образ в чате перед стартом.\n\n**Правило**: если что-то не в BL и не в чате с approval — этого не\nсуществует. Continuation-инструкции после `\u002Fcompact`, неявные «Step-N»,\n«я подумал, нам ещё нужно X» — не источник плана. План — то, что\nзафиксировано и одобрено.\n\n## Шаг 1 — RFC (только M\u002FL)\n\nКороткий дизайн-док в `PROJECT\u002Frfc\u002FNNN-title.md` ДО кода.\n\n```markdown\n## Проблема\nЧто не работает \u002F чего не хватает. 1–2 предложения.\n\n## Варианты\n- A: ...\n- B: ...\n\n## Выбрано + почему\nВариант X, потому что ...\n\n## Риски \u002F что может сломаться\n- ...\n\n## План проверки\nКак поймём, что работает (тесты, ручной сценарий, метрика).\n```\n\nClaude пишет RFC и ЖДЁТ явного approve от пользователя перед кодом.\nДля XS — RFC не нужен.\n\n## Шаг 2 — код + тесты\n\n**Стек тестов**:\n\n| Язык | Фреймворк | Запуск |\n|---|---|---|\n| JavaScript \u002F Node | `node --test` (встроено в Node 20+) | `node --test` в корне проекта |\n| Python | `pytest` | `pip install pytest && pytest` |\n\nФайлы тестов лежат рядом с кодом: `parser.js` → `parser.test.js`,\n`loader.py` → `test_loader.py`.\n\n**Testing pyramid**:\n- **Юнит** — чистая логика без сети\u002Fдиска. Пишем много.\n- **Интеграционные** — внешние API (MCP, Superset, Jira, Notion). **Моки сети, не реальные запросы** — иначе флак и квоты.\n- **E2E \u002F ручная** — только для критичных прод-сценариев. Описываем чеклистом в RFC, не автоматизируем преждевременно.\n\n**Smoke-тест обязателен даже для XS** — один простейший тест, доказывающий,\nчто основная функция вызывается, не падает, возвращает ожидаемый тип.\nЛовит 80% поломок рефакторинга за 2 минуты работы.\n\n## Шаг 3 — линтеры (только где есть нетривиальный код)\n\nСтавим по мере необходимости, локально в подпроект.\n\n| Язык | Инструмент | Конфиг |\n|---|---|---|\n| JavaScript | `prettier` + `eslint` (`@eslint\u002Fjs recommended`) | минимальный, zero-config |\n| Python | `ruff` (lint + format в одном) | zero-config |\n\nДля bash-скриптов и одноразовых утилит — проверяем глазами, линтер не нужен.\n\n## Шаг 4 — pre-commit hook\n\nПоявляется только когда в подпроекте есть тесты или линтеры. До этого —\nживём без хука.\n\nКогда будет что гонять:\n1. Скрипт в `.githooks\u002Fpre-commit` (коммитим в репо, чтобы пережил сессии).\n2. `git config core.hooksPath .githooks` локально.\n3. Первая версия — **warning-only**: прогоняет тесты + линтер для изменённых\n   файлов, печатает результат, НЕ блокирует коммит. Когда привыкнем —\n   переключаем в блокирующий режим.\n\nОтдельно: **секрет-guard pre-commit hook** добавляем при подготовке к\nпубликации в паблик-репо — блокирует Notion tokens, Google OAuth secrets,\nprivate keys, AWS keys, имя\u002Femail автора.\n\n## Шаг 5 — мульти-агентное ревью\n\n### Тир M\nПосле кода — субагент (`general-purpose` с фокус-промптом) получает diff.\nФокус:\n- Читаемость и именование.\n- Edge cases, которые могли забыть.\n- Простота — нет over-engineering, абстракций «на вырост».\n- Соответствие DOD.\n- Secrets \u002F hardcoded credentials.\n\nКритичные findings Claude исправляет сам. Остальное — summary пользователю.\n\n### Тир L\nДополнительно:\n- **`\u002Fsecurity-review`** — уязвимости (injection, XSS, утечки, auth),\n  секреты, небезопасные дефолты.\n- **`\u002Freview`** — общий PR-review с точки зрения качества изменений.\n- Для публичных фич — UX edge cases (пустые состояния, ошибки, обрывы сети).\n\n### Финальный approve — всегда у пользователя\nClaude **не коммитит код без ok** (для M\u002FL). Для XS — показывает diff и\nкоммитит, если пользователь заранее дал зелёный свет.\n\n## Шаг 6 — уровни безопасности (S1\u002FS2\u002FS3)\n\nБезопасность масштабируется инкрементально.\n\n| Уровень | Триггер | Что подключаем |\n|---|---|---|\n| **S1 — базовый** | локальные скрипты, MCP, личные тулы | `\u002Fsecurity-review` для L-тира, secret-detection в code-review, `npm audit` \u002F `pip-audit` перед коммитом новых зависимостей, «секреты не в репо» |\n| **S2 — pre-prod** | SaaS готов к внешнему доступу, появился auth \u002F БД с данными | threat modeling в RFC для фич с auth + данными, SAST (`semgrep`), OWASP Top 10 чеклист, проверка secrets в CI, auto dependency scanning |\n| **S3 — prod с пользователями** | публичный SaaS, реальные пользователи | **pentest-агент** против staging, регулярные прогоны перед релизом, внешний аудит перед платными клиентами \u002F чужими данными \u002F платежами |\n\n**Дефолт по репо — S1.** Переход на S2 — когда появляется первый подпроект\nс auth или публичным URL.\n\n### Pentest-агент (S3, план на будущее)\nЗапускается против staging-инстанса (не против кода, не против prod).\nПроцесс: subagent получает URL + тестовые креды + HTTP\u002Fbrowser тулы → идёт\nпо OWASP Top 10 чеклисту (auth bypass, injection, XSS, IDOR, CSRF, SSRF,\nrate limiting, secrets exposure, broken access control) → каждую попытку\nлогирует `payload → response → classification` → возвращает отчёт по severity.\n**Critical\u002Fhigh — блокеры релиза. Medium\u002Flow — в бэклог с дедлайном.**\n\nНЕ заменяет: внешний профпентест перед платным продуктом, bug bounty при\nмасштабе, compliance-аудиты (SOC2, GDPR) если станут требованием.\nРеализуем только при переходе на S3, не заранее.\n\n## Шаг 7 — инцидент-лог\n\nКогда в прод-приложении что-то сломалось или не заработало с первого раза —\nфиксируем в `PROJECT\u002Fincidents.md`:\n\n```markdown\n## YYYY-MM-DD — короткий заголовок\n**Что произошло**: ...\n**Почему (root cause)**: ...\n**Что изменили, чтобы не повторилось**: правило \u002F тест \u002F конфиг \u002F refactor.\n```\n\n**Blameless** — фиксируем причину, не виноватых. Каждый инцидент делает\nсистему устойчивее: добавленный тест, правило в CLAUDE.md, защита в коде.\n\n## Шаг 8 — CI (GitHub Actions)\n\nДобавляется когда первый подпроект выходит в прод (пользователи снаружи).\nДо этого — overkill.\n\nМинимум на старте:\n- Прогон тестов на PR.\n- Прогон линтера на PR.\n- Блок merge при красном CI.\n\nДальше — инкрементально по мере роста.\n\n## Шаг 9 — документация\n\nДокументация = живой контракт поведения системы. Если она не обновляется в\nтом же коммите, что и код, — она быстро расходится с реальностью, и любой\naudit «как должно работать vs как работает» становится бессмысленным.\n\n**Базовое правило**: код и документация поведения, которое он реализует,\nлежат в одном коммите. «Сделаю доку потом» = потом не будет.\n\n### Таблица триггеров\n\n| Триггер изменения | Что обновляется |\n|---|---|\n| Меняется поведение команды \u002F публичной функции \u002F внешнего API | Соответствующий behavioural-контракт в `PROJECT\u002Fdocs\u002FSPEC.md` (или эквиваленте per-команду) |\n| Меняется data flow \u002F структура подпроекта \u002F появляется новый модуль | `PROJECT\u002FARCHITECTURE.md` |\n| Продуктовая развилка с trade-off'ом (выбран один вариант из нескольких) | Новый ADR в `PROJECT\u002Fdocs\u002Fdecisions\u002FNNN-title.md` (короткий: контекст \u002F решение \u002F последствия) |\n| User-visible изменение (фича \u002F breaking change \u002F deprecation \u002F удаление) | Запись в `PROJECT\u002FCHANGELOG.md` (формат Keep a Changelog) |\n| Меняется data schema (TSV \u002F JSON config \u002F БД \u002F внешняя property schema) | Секция в SPEC + миграционная запись в `incidents.md` если миграция нетривиальна |\n| Меняется setup \u002F onboarding \u002F запуск | `PROJECT\u002FREADME.md` |\n| Меняется правило, которое Claude должен помнить между сессиями | `PROJECT\u002FCLAUDE.md` |\n\n### Когда документации ещё НЕТ в подпроекте\n\nЕсли SPEC \u002F ARCHITECTURE \u002F CHANGELOG \u002F ADR-папки в подпроекте ещё не созданы\n— сначала **спросить пользователя**, нужно ли их завести под текущее\nизменение. Не создавать молча: пользователь решает, готов ли подпроект к\nформальной документационной дисциплине, или это пока ad-hoc разработка.\n\nПосле создания первого артефакта — он живой, обновляется по триггерам выше\nбез переспросов.\n\n### Что НЕ требует документации\n\n- XS-багфиксы, не меняющие поведение (опечатки, рефакторинг без изменений\n  семантики, тесты, форматирование).\n- Внутренние имена \u002F приватные хелперы, не вынесенные в публичный контракт.\n- Эксперименты под feature-флагом до раскатки.\n\n## Definition of Done — чеклист перед «готово»\n\nПеред тем как отчитаться, Claude проходит:\n\n- [ ] Образ результата (Шаг 0.5) был согласован ДО кода — для M\u002FL обязательно, для XS если меняет UX.\n- [ ] Код делает то, что просили (по DOD из TodoWrite).\n- [ ] Smoke-тест (минимум) или юнит\u002Fинтеграционные тесты (M\u002FL) проходят.\n- [ ] Линтер без ошибок (если настроен).\n- [ ] Diff перечитан (`git diff`).\n- [ ] Изменения консистентны между файлами.\n- [ ] Для M\u002FL — code-review агент прошёл, критичные findings исправлены.\n- [ ] Секретов в коде нет.\n- [ ] Документация (SPEC \u002F ARCHITECTURE \u002F CHANGELOG \u002F ADR \u002F README \u002F CLAUDE.md)\n      обновлена под изменение поведения, если оно было — по таблице из Шага 9.\n\nЕсли что-то не ок — исправляем, не спрашивая.\n\n## Тон коммуникации с пользователем\n\nПользователь — продакт, не тех-лид. Это значит:\n\n- **Объяснения багов и инцидентов:** на языке бизнес-логики и продуктовых\n  side-effects, не на языке implementation. Что сломалось с точки зрения\n  пользователя продукта, какие видимые последствия (дубли комментариев,\n  пропущенные письма, неправильный статус), что сделано и какой риск\n  на будущее. Без stack traces, uid\u002Fgid, имён файлов с путями, syscalls,\n  внутренних модулей. Технические термины уровня \"cron\", \"logs\",\n  \"env vars\", \"OAuth\", \"permissions\", \"Docker\" — окей, можно. Уровня\n  `EACCES`, `writeFileSync`, `atomic-rename`, `chown -R`, `uid 1000`,\n  `Module._load` — нет.\n\n- **Развилки и решения:** формулировать в терминах продуктового impact'а,\n  не реализации. \"Если выберем (A) — фикс никогда не вернётся, но\n  редеплой 5 минут. Если (B) — переживём пока, починим если опять\n  всплывёт\" — да. \"Если (A) — добавим entrypoint script, ENTRYPOINT\n  вызовет gosu, exec opt-in\" — нет.\n\n- **Не сюсюкать.** Пользователь знает, что такое cron, лог, переменная\n  окружения, OAuth. Метафоры с \"роботами\", \"дневниками\", \"папками-как-\n  для-ребёнка\" — оскорбительны и теряют сигнал.\n\n- **Уровень детализации:** достаточный, чтобы пользователь понимал\n  ЧТО произошло и ПОЧЕМУ это важно, но не настолько, чтобы он начал\n  читать стек. Если просит детали — даю детали; по умолчанию — нет.\n\n- **Ошибки и стек-трейсы внутри своего workflow:** Claude использует их\n  для диагностики, но в ответе пользователю — пересказывает на\n  продуктовом языке. Сырой стек показываем, только если пользователь\n  сам спрашивает про конкретный класс ошибки.\n\n## Когда этот скилл НЕ применяется\n\n- Продакт-задачи: оформление гипотез, Notion \u002F Jira \u002F Confluence-страницы,\n  тексты, posts, intake-формы.\n- Ad-hoc research \u002F exploration без артефакта.\n- Однострочные правки на маке (опечатки, alias, env-var).\n\nДля таких задач — работаем без тиринга и без DOD-церемонии.\n","# dev-workflow — правила разработки кода\n\nСкилл применяется ко всем проектам Jared, где пишем код. Для продакт-задач\n(Notion, Jira, Confluence, тексты, оформление гипотез) не применяется — там\nработаем как раньше, без церемоний.\n\n## Шаг 0 — классификация\n\nВ начале задачи Claude определяет тир. Если неочевидно — называет предполагаемый\nтир и спрашивает пользователя, согласен ли он.\n\n| Тир | Триггер | Процесс |\n|---|---|---|\n| **XS** | \u003C 20 строк, багфикс, правка текста\u002Fконфига, однофайловое изменение | DOD → код → smoke-тест → self-review (`git diff`) → показать пользователю → commit |\n| **M** | новая фича, новый скрипт, 2+ файла, нетривиальная логика, новая интеграция | RFC → **approve пользователя** → код + тесты → линтер → code-review агент → показать diff + summary → commit |\n| **L** | архитектура, миграция, безопасность, ломающее изменение, новый подпроект, изменение public API | Полный RFC → **approve плана** → код по частям (feature flag если релевантно) → code-review + `\u002Fsecurity-review` → итог → **финальный approve** → merge |\n\n**Правило по умолчанию**: сомневаешься между тирами — выбирай выше.\n\n## Шаг 0.5 — образ результата (user-level, ДО кода)\n\nПеред RFC, перед кодом, перед техническими деталями — Claude формулирует\n**конкретизированный образ результата на user-level** и согласует его с\nпользователем. Это правило важнее RFC: RFC про архитектуру, образ\nрезультата — про UX. Оба нужны, но образ — первый.\n\n**Когда обязательно**: M \u002F L. Для XS — если задача неоднозначная или\nменяет user-visible поведение. Для тривиальных багфиксов \u002F опечаток \u002F \nправки конфига без UX-сдвига — пропускаем.\n\n**Шаблон**:\n\n```markdown\n## Что хочется получить\n\n[Как было] → [Как станет], глазами пользователя.\n\n- Какую команду \u002F действие даёт пользователь.\n- Что увидит на выходе (текст, файл, страницу, изменение в Notion \u002F Drive \u002F TSV).\n- Какие edge-cases обработаются («если X пустой — увидишь сообщение Y»).\n- Что **НЕ** входит в scope (что осталось ручным \u002F отложено \u002F отдельной задачей).\n\n## Куда это положить\n\n[Если правило \u002F процесс — в какой файл; если код — в какой модуль \u002F \nкоманду; если артефакт — в какой каталог.]\n```\n\n**Где живёт образ результата**:\n\n- Если у задачи есть BL-файл — в секции `## Plan` или отдельной секции\n  `## Что хочется получить`.\n- Если BL нет — отдельным сообщением в чате с явным «ОК» от пользователя.\n- Если нет ни BL, ни approval — Claude предлагает завести BL и записать\n  туда образ, ИЛИ зафиксировать образ в чате перед стартом.\n\n**Правило**: если что-то не в BL и не в чате с approval — этого не\nсуществует. Continuation-инструкции после `\u002Fcompact`, неявные «Step-N»,\n«я подумал, нам ещё нужно X» — не источник плана. План — то, что\nзафиксировано и одобрено.\n\n## Шаг 1 — RFC (только M\u002FL)\n\nКороткий дизайн-док в `PROJECT\u002Frfc\u002FNNN-title.md` ДО кода.\n\n```markdown\n## Проблема\nЧто не работает \u002F чего не хватает. 1–2 предложения.\n\n## Варианты\n- A: ...\n- B: ...\n\n## Выбрано + почему\nВариант X, потому что ...\n\n## Риски \u002F что может сломаться\n- ...\n\n## План проверки\nКак поймём, что работает (тесты, ручной сценарий, метрика).\n```\n\nClaude пишет RFC и ЖДЁТ явного approve от пользователя перед кодом.\nДля XS — RFC не нужен.\n\n## Шаг 2 — код + тесты\n\n**Стек тестов**:\n\n| Язык | Фреймворк | Запуск |\n|---|---|---|\n| JavaScript \u002F Node | `node --test` (встроено в Node 20+) | `node --test` в корне проекта |\n| Python | `pytest` | `pip install pytest && pytest` |\n\nФайлы тестов лежат рядом с кодом: `parser.js` → `parser.test.js`,\n`loader.py` → `test_loader.py`.\n\n**Testing pyramid**:\n- **Юнит** — чистая логика без сети\u002Fдиска. Пишем много.\n- **Интеграционные** — внешние API (MCP, Superset, Jira, Notion). **Моки сети, не реальные запросы** — иначе флак и квоты.\n- **E2E \u002F ручная** — только для критичных прод-сценариев. Описываем чеклистом в RFC, не автоматизируем преждевременно.\n\n**Smoke-тест обязателен даже для XS** — один простейший тест, доказывающий,\nчто основная функция вызывается, не падает, возвращает ожидаемый тип.\nЛовит 80% поломок рефакторинга за 2 минуты работы.\n\n## Шаг 3 — линтеры (только где есть нетривиальный код)\n\nСтавим по мере необходимости, локально в подпроект.\n\n| Язык | Инструмент | Конфиг |\n|---|---|---|\n| JavaScript | `prettier` + `eslint` (`@eslint\u002Fjs recommended`) | минимальный, zero-config |\n| Python | `ruff` (lint + format в одном) | zero-config |\n\nДля bash-скриптов и одноразовых утилит — проверяем глазами, линтер не нужен.\n\n## Шаг 4 — pre-commit hook\n\nПоявляется только когда в подпроекте есть тесты или линтеры. До этого —\nживём без хука.\n\nКогда будет что гонять:\n1. Скрипт в `.githooks\u002Fpre-commit` (коммитим в репо, чтобы пережил сессии).\n2. `git config core.hooksPath .githooks` локально.\n3. Первая версия — **warning-only**: прогоняет тесты + линтер для изменённых\n   файлов, печатает результат, НЕ блокирует коммит. Когда привыкнем —\n   переключаем в блокирующий режим.\n\nОтдельно: **секрет-guard pre-commit hook** добавляем при подготовке к\nпубликации в паблик-репо — блокирует Notion tokens, Google OAuth secrets,\nprivate keys, AWS keys, имя\u002Femail автора.\n\n## Шаг 5 — мульти-агентное ревью\n\n### Тир M\nПосле кода — субагент (`general-purpose` с фокус-промптом) получает diff.\nФокус:\n- Читаемость и именование.\n- Edge cases, которые могли забыть.\n- Простота — нет over-engineering, абстракций «на вырост».\n- Соответствие DOD.\n- Secrets \u002F hardcoded credentials.\n\nКритичные findings Claude исправляет сам. Остальное — summary пользователю.\n\n### Тир L\nДополнительно:\n- **`\u002Fsecurity-review`** — уязвимости (injection, XSS, утечки, auth),\n  секреты, небезопасные дефолты.\n- **`\u002Freview`** — общий PR-review с точки зрения качества изменений.\n- Для публичных фич — UX edge cases (пустые состояния, ошибки, обрывы сети).\n\n### Финальный approve — всегда у пользователя\nClaude **не коммитит код без ok** (для M\u002FL). Для XS — показывает diff и\nкоммитит, если пользователь заранее дал зелёный свет.\n\n## Шаг 6 — уровни безопасности (S1\u002FS2\u002FS3)\n\nБезопасность масштабируется инкрементально.\n\n| Уровень | Триггер | Что подключаем |\n|---|---|---|\n| **S1 — базовый** | локальные скрипты, MCP, личные тулы | `\u002Fsecurity-review` для L-тира, secret-detection в code-review, `npm audit` \u002F `pip-audit` перед коммитом новых зависимостей, «секреты не в репо» |\n| **S2 — pre-prod** | SaaS готов к внешнему доступу, появился auth \u002F БД с данными | threat modeling в RFC для фич с auth + данными, SAST (`semgrep`), OWASP Top 10 чеклист, проверка secrets в CI, auto dependency scanning |\n| **S3 — prod с пользователями** | публичный SaaS, реальные пользователи | **pentest-агент** против staging, регулярные прогоны перед релизом, внешний аудит перед платными клиентами \u002F чужими данными \u002F платежами |\n\n**Дефолт по репо — S1.** Переход на S2 — когда появляется первый подпроект\nс auth или публичным URL.\n\n### Pentest-агент (S3, план на будущее)\nЗапускается против staging-инстанса (не против кода, не против prod).\nПроцесс: subagent получает URL + тестовые креды + HTTP\u002Fbrowser тулы → идёт\nпо OWASP Top 10 чеклисту (auth bypass, injection, XSS, IDOR, CSRF, SSRF,\nrate limiting, secrets exposure, broken access control) → каждую попытку\nлогирует `payload → response → classification` → возвращает отчёт по severity.\n**Critical\u002Fhigh — блокеры релиза. Medium\u002Flow — в бэклог с дедлайном.**\n\nНЕ заменяет: внешний профпентест перед платным продуктом, bug bounty при\nмасштабе, compliance-аудиты (SOC2, GDPR) если станут требованием.\nРеализуем только при переходе на S3, не заранее.\n\n## Шаг 7 — инцидент-лог\n\nКогда в прод-приложении что-то сломалось или не заработало с первого раза —\nфиксируем в `PROJECT\u002Fincidents.md`:\n\n```markdown\n## YYYY-MM-DD — короткий заголовок\n**Что произошло**: ...\n**Почему (root cause)**: ...\n**Что изменили, чтобы не повторилось**: правило \u002F тест \u002F конфиг \u002F refactor.\n```\n\n**Blameless** — фиксируем причину, не виноватых. Каждый инцидент делает\nсистему устойчивее: добавленный тест, правило в CLAUDE.md, защита в коде.\n\n## Шаг 8 — CI (GitHub Actions)\n\nДобавляется когда первый подпроект выходит в прод (пользователи снаружи).\nДо этого — overkill.\n\nМинимум на старте:\n- Прогон тестов на PR.\n- Прогон линтера на PR.\n- Блок merge при красном CI.\n\nДальше — инкрементально по мере роста.\n\n## Шаг 9 — документация\n\nДокументация = живой контракт поведения системы. Если она не обновляется в\nтом же коммите, что и код, — она быстро расходится с реальностью, и любой\naudit «как должно работать vs как работает» становится бессмысленным.\n\n**Базовое правило**: код и документация поведения, которое он реализует,\nлежат в одном коммите. «Сделаю доку потом» = потом не будет.\n\n### Таблица триггеров\n\n| Триггер изменения | Что обновляется |\n|---|---|\n| Меняется поведение команды \u002F публичной функции \u002F внешнего API | Соответствующий behavioural-контракт в `PROJECT\u002Fdocs\u002FSPEC.md` (или эквиваленте per-команду) |\n| Меняется data flow \u002F структура подпроекта \u002F появляется новый модуль | `PROJECT\u002FARCHITECTURE.md` |\n| Продуктовая развилка с trade-off'ом (выбран один вариант из нескольких) | Новый ADR в `PROJECT\u002Fdocs\u002Fdecisions\u002FNNN-title.md` (короткий: контекст \u002F решение \u002F последствия) |\n| User-visible изменение (фича \u002F breaking change \u002F deprecation \u002F удаление) | Запись в `PROJECT\u002FCHANGELOG.md` (формат Keep a Changelog) |\n| Меняется data schema (TSV \u002F JSON config \u002F БД \u002F внешняя property schema) | Секция в SPEC + миграционная запись в `incidents.md` если миграция нетривиальна |\n| Меняется setup \u002F onboarding \u002F запуск | `PROJECT\u002FREADME.md` |\n| Меняется правило, которое Claude должен помнить между сессиями | `PROJECT\u002FCLAUDE.md` |\n\n### Когда документации ещё НЕТ в подпроекте\n\nЕсли SPEC \u002F ARCHITECTURE \u002F CHANGELOG \u002F ADR-папки в подпроекте ещё не созданы\n— сначала **спросить пользователя**, нужно ли их завести под текущее\nизменение. Не создавать молча: пользователь решает, готов ли подпроект к\nформальной документационной дисциплине, или это пока ad-hoc разработка.\n\nПосле создания первого артефакта — он живой, обновляется по триггерам выше\nбез переспросов.\n\n### Что НЕ требует документации\n\n- XS-багфиксы, не меняющие поведение (опечатки, рефакторинг без изменений\n  семантики, тесты, форматирование).\n- Внутренние имена \u002F приватные хелперы, не вынесенные в публичный контракт.\n- Эксперименты под feature-флагом до раскатки.\n\n## Definition of Done — чеклист перед «готово»\n\nПеред тем как отчитаться, Claude проходит:\n\n- [ ] Образ результата (Шаг 0.5) был согласован ДО кода — для M\u002FL обязательно, для XS если меняет UX.\n- [ ] Код делает то, что просили (по DOD из TodoWrite).\n- [ ] Smoke-тест (минимум) или юнит\u002Fинтеграционные тесты (M\u002FL) проходят.\n- [ ] Линтер без ошибок (если настроен).\n- [ ] Diff перечитан (`git diff`).\n- [ ] Изменения консистентны между файлами.\n- [ ] Для M\u002FL — code-review агент прошёл, критичные findings исправлены.\n- [ ] Секретов в коде нет.\n- [ ] Документация (SPEC \u002F ARCHITECTURE \u002F CHANGELOG \u002F ADR \u002F README \u002F CLAUDE.md)\n      обновлена под изменение поведения, если оно было — по таблице из Шага 9.\n\nЕсли что-то не ок — исправляем, не спрашивая.\n\n## Тон коммуникации с пользователем\n\nПользователь — продакт, не тех-лид. Это значит:\n\n- **Объяснения багов и инцидентов:** на языке бизнес-логики и продуктовых\n  side-effects, не на языке implementation. Что сломалось с точки зрения\n  пользователя продукта, какие видимые последствия (дубли комментариев,\n  пропущенные письма, неправильный статус), что сделано и какой риск\n  на будущее. Без stack traces, uid\u002Fgid, имён файлов с путями, syscalls,\n  внутренних модулей. Технические термины уровня \"cron\", \"logs\",\n  \"env vars\", \"OAuth\", \"permissions\", \"Docker\" — окей, можно. Уровня\n  `EACCES`, `writeFileSync`, `atomic-rename`, `chown -R`, `uid 1000`,\n  `Module._load` — нет.\n\n- **Развилки и решения:** формулировать в терминах продуктового impact'а,\n  не реализации. \"Если выберем (A) — фикс никогда не вернётся, но\n  редеплой 5 минут. Если (B) — переживём пока, починим если опять\n  всплывёт\" — да. \"Если (A) — добавим entrypoint script, ENTRYPOINT\n  вызовет gosu, exec opt-in\" — нет.\n\n- **Не сюсюкать.** Пользователь знает, что такое cron, лог, переменная\n  окружения, OAuth. Метафоры с \"роботами\", \"дневниками\", \"папками-как-\n  для-ребёнка\" — оскорбительны и теряют сигнал.\n\n- **Уровень детализации:** достаточный, чтобы пользователь понимал\n  ЧТО произошло и ПОЧЕМУ это важно, но не настолько, чтобы он начал\n  читать стек. Если просит детали — даю детали; по умолчанию — нет.\n\n- **Ошибки и стек-трейсы внутри своего workflow:** Claude использует их\n  для диагностики, но в ответе пользователю — пересказывает на\n  продуктовом языке. Сырой стек показываем, только если пользователь\n  сам спрашивает про конкретный класс ошибки.\n\n## Когда этот скилл НЕ применяется\n\n- Продакт-задачи: оформление гипотез, Notion \u002F Jira \u002F Confluence-страницы,\n  тексты, posts, intake-формы.\n- Ad-hoc research \u002F exploration без артефакта.\n- Однострочные правки на маке (опечатки, alias, env-var).\n\nДля таких задач — работаем без тиринга и без DOD-церемонии.\n",{"name":5,"license":14,"version":24,"description":25,"allowed-tools":26,"compatibility":35},"0.1.0","Правила производственного цикла разработки кода для всех проектов Jared.\nТирует задачу (XS \u002F M \u002F L), требует RFC перед кодом для M\u002FL, обязательный\nsmoke-тест даже на XS, мульти-агентное ревью для M\u002FL, `\u002Fsecurity-review` для\nL и любых фич с auth\u002Fданными, инцидент-лог в blameless-режиме, DOD-чеклист\nперед отчётом. Уровни безопасности S1→S3 подключаются инкрементально.\nПрименяется ТОЛЬКО к разработке кода — скрипты, приложения, MCP-серверы,\nSaaS. На продакт-задачи (Notion, Jira, Confluence, тексты, гипотезы) —\nне распространяется.\nTrigger when: новая задача на разработку кода, появляется \u002Fdev-workflow,\n\"начинаем фичу\", \"новая фича\", \"напиши скрипт\", \"подними MCP\", \"рефакторинг\",\n\"миграция\", \"архитектурное изменение\", \"новый подпроект\" — или когда\nпользователь спрашивает, какой тир у задачи.\n",[27,28,29,30,31,32,33,34],"Read","Write","Edit","Grep","Glob","Bash","TodoWrite","Agent","claude-code","main","a4b48842f3e48549adf3dc335a8837c66da99497","examples\u002Fclaude-dev-workflow",0,"https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng","2026-05-17 16:00:01",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add enigmaicon-eng\u002FAI-Enterprise-OS --skill dev-workflow",{"tool":49,"command":50},"bunx","bunx skills add enigmaicon-eng\u002FAI-Enterprise-OS --skill dev-workflow",{"tool":52,"command":53},"pnpm","pnpm dlx skills add enigmaicon-eng\u002FAI-Enterprise-OS --skill dev-workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fclaude-dev-workflow\u002FSKILL.md",true,[57,63,67],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},".gitignore","OTHER","其他",58,"https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fclaude-dev-workflow\u002F.gitignore",{"path":64,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":15},"LICENSE","许可证",1062,{"path":68,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":72},"README.md","REFERENCE","参考文档",5954,"https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fclaude-dev-workflow\u002FREADME.md",[74,81,88,95,102,109],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M72ZGWW03JSE1T3TKK5NZ11Y","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fsuperpowers\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M72ZGT3FJT7QRM1VNQRKR0XD","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fsuperpowers\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M72ZGQ69DCF0SBP9JXFPWKJS","verification-before-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fsuperpowers\u002Fskills\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M72ZGNF126QT0MQ2D3DNGZRN","using-superpowers","Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fsuperpowers\u002Fskills\u002Fusing-superpowers\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M72ZGHVJ9S0YXMNBHQGQ95BY","using-git-worktrees","Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fsuperpowers\u002Fskills\u002Fusing-git-worktrees\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M72ZGFNZCHFY2FS3ZD9MCYV9","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002Fenigmaicon-eng\u002FAI-Enterprise-OS\u002Fblob\u002Fmain\u002Fexamples\u002Fsuperpowers\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[]]