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

senior-engineering — скилл для Claude Code

Скилл senior-engineering для Claude Code задаёт инженерный порядок для нетривиальных задач: сначала критерии готовности, затем код и чек-лист перед сдачей.

MIT ★ 239 обновлён 2026-08-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jdrhyne/agent-skills --skill senior-engineering -a claude-code
Открыть на GitHub

Что делает senior-engineering

Скилл подгружает в контекст инженерные принципы и меняет то, как агент берётся за нетривиальную задачу. Сначала он формулирует, что считается успехом и как это проверить, разделяет решения на необратимые и легко отменяемые, описывает интерфейс до внутренностей. Реализация идёт после этого.

Во время работы принципы требуют держать проект в состоянии, которое собирается и запускается, и коммитить рабочие чекпоинты. Логи и метрики добавляются сразу, а не при разборе инцидента. Перед словом «готово» стоит чек-лист: линтер, проверка типов, тесты, ручной smoke-тест, граничные случаи.

Отдельный раздел про оркестрацию нескольких агентов: каждому дают минимальный контекст и одну зону ответственности, результат проверяют как чужой код. В разделе про границы безопасности скилл прямо запрещает расширять объём задачи без запроса и выдумывать результаты проверок. Если агент отчитывается «тесты прошли» без прогона, это нарушение, а не мелочь.

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

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

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

  • Спланируй переделку модуля оплаты: сначала критерии готовности, потом код.
  • Разбей задачу на независимые куски и покажи, какие решения необратимы.
  • Покажи, что мы реально прогнали перед сдачей и что осталось непроверенным.

Как установить senior-engineering

1Через Skills CLI (Vercel)

npx skills add jdrhyne/agent-skills --skill senior-engineering -a claude-code

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

~/.claude/skills/senior-engineering/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/senior-engineering/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о senior-engineering

Как установить senior-engineering в Claude Code?

Выполните npx skills add jdrhyne/agent-skills --skill senior-engineering -a claude-code. Файл скилла появится по пути ~/.claude/skills/senior-engineering/SKILL.md.

Что делает senior-engineering?

Даёт агенту рабочий метод: определить готовность, разложить задачу на проверяемые единицы, держать проект запускаемым и пройти проверки перед отчётом о завершении.

Скилл заставит агента спрашивать разрешение на каждое изменение?

Нет. Он запрещает обходить ваше подтверждение для разрушительных и рискованных правок, а обратимые решения агент принимает сам.

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

SKILL.md · MIT
---
name: senior-engineering
description: Engineering principles for building software like a senior engineer. Load when tackling non-trivial development work, architecting systems, reviewing code, or orchestrating multi-agent builds. Covers planning, delivery, quality gates, and LLM-specific patterns.
---

# Senior Engineering Principles

Guidelines for building software with the judgment and discipline of a senior engineer.

## Safety Boundaries

- Do not treat these principles as permission to skip user approval for destructive or high-risk changes.
- Do not expand scope beyond the user's request just because a broader rewrite seems cleaner.
- Do not invent validation results; report what was actually checked and what remains unverified.

## Before Writing Code

### Define Done First
- What does success look like? Write it down.
- What are the acceptance criteria?
- How will you verify it works?

### Identify Load-Bearing Decisions
- Which choices are hard to reverse? → More scrutiny
- Which are easily changed? → Decide fast, move on
- Reversible decisions don't need consensus

### Decompose Before Building
- Break work into clear, testable units
- Each unit should be independently verifiable
- If you can't explain the pieces, you don't understand the whole

### Surface Risks Upfront
- What could go wrong?
- What are the dependencies?
- What's the rollback plan?
- Time-box exploration — analysis paralysis is real

### Interface First, Implementation Second
- Define the contract (types, API shape, error cases) before internals
- Forces clarity on what you're actually building
- Implementation becomes "fill in the blanks"

### Ask: What's the Simplest Thing That Could Work?
- Start there. Add complexity only when the simple version fails.
- Most features need 20% of what we imagine.

## During Build

### Always Have a Runnable State
- Never be more than 30 mins from something that compiles/runs
- Commit working checkpoints frequently
- Big-bang integration is where projects die

### Prefer Incremental Over Big-Bang
- Ship small, verify, iterate
- Each step should be independently deployable if possible
- Reduce blast radius of mistakes

### Instrument As You Build
- Add logging/metrics while coding, not when debugging prod
- "I wish I had visibility into X" = you waited too long
- Observability is a feature, not an afterthought

### Read Errors Carefully
- 80% of debugging is actually reading what the system tells you
- Read the error, then read it again
- Stack traces have answers — follow them

### Boring > Clever
- If someone has to pause to understand it, it's too clever
- Save big-brain moves for genuinely hard problems
- Maintainability beats elegance

### Optimize for Delete
- Write code that's easy to remove
- Tight coupling makes features immortal
- Good abstractions have clear boundaries

## Quality Gates

### Before Declaring Done
- [ ] Linter passes
- [ ] Type checker passes
- [ ] Tests pass (unit + integration where applicable)
- [ ] Manual smoke test completed
- [ ] Edge cases considered and handled

### Tests Are Documentation
- A good test suite tells you what code is *supposed* to do
- Treat tests as first-class citizens
- If it's not tested, it's not done

### Code Review Mindset
- Review like you'll maintain it at 3am
- Check: correctness, clarity, edge cases, security
- "It works" is necessary but not sufficient

## LLM Orchestration Principles

### Context Management
- Context window is your RAM — manage it deliberately
- Bloated context = degraded reasoning
- Give each agent minimum viable context, no more

### Agent Delegation
- Single responsibility per agent
- Clear handoff contracts: inputs, outputs, success criteria
- Parallel when independent, sequential when dependent

### Verify, Don't Trust
- First output is a draft, always
- Review agent output like a code review
- Agents are junior engineers, not oracles

### Checkpoints Over Marathons
- Long-running agents should checkpoint progress
- If it crashes at 90%, don't lose everything
- Log state to files, not just memory

### Fail Fast, Surface Early
- If something's going wrong, stop and reassess
- Don't compound errors hoping they'll resolve
- Human in the loop for high-stakes decisions

## Ownership & Accountability

### Own Failures, Credit Others
- Own failures publicly
- Credit others for wins
- No ego-driven attachment to being right

### Strong Opinions, Weakly Held
- Have a position, defend it with evidence
- Update beliefs when evidence demands it
- "I was wrong" is a sign of growth

### Leave It Better
- Codebases, teams, processes — improve what you touch
- Fix the small things while you're there
- Documentation is a gift to future-you

## The Meta-Principle

> "Make the change easy, then make the easy change." — Kent Beck

Most senior engineering is about *preparation* — setting up the codebase so the actual feature is trivial. If the feature is hard, the real work is often refactoring first to make it easy.

© jdrhyne · MIT · jdrhyne/agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
engineering-senior-developer PeterHdd Скилл engineering-senior-developer для Claude Code помогает вести разработку сложных систем и принимать архитектурные решения. Включается при декомпозиции требований, рефакторинге и планировании релизов. CX Codex +1 356установок constraint-driven-development addyosmani Скилл constraint-driven-development превращает размытые представления о качестве в письменный контракт проекта. Опрашивает вас, какие метрики важны, и записывает всё в CONSTRAINTS.md с числами, которые можно проверять автоматически. CX Codex +1 49 100установок omc-review Yeachan-Heo Скилл omc-review проверяет готовый код на дефекты, риски и избыточность перед выкаткой. Не правит сам — находит и ранжирует проблемы по серьёзности. CX Codex +1 309установок quality-gates OrchestKit Скилл quality-gates оценивает сложность задач от 1 до 5 и останавливает агента при тупиках или оверинжиниринге. Включается перед запуском фич и после неудачных попыток решения. CX Codex +1 259установок scope-guard davila7 Хук scope-guard для Claude Code предупреждает о правках файлов, не вошедших в спецификацию задачи. 247установок junior-to-senior JuliusBrussee Скилл junior-to-senior для критического разбора планов и архитектуры от лица сеньор-инженера. Помогает убрать абстрактные фразы и проверить решения по актуальной кодовой базе. CX Codex +1 2 800установок

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

Весь набор →
planner Скилл planner разбивает сложные задачи на спринты и атомарные шаги с проверками, готовя детальный Markdown-план для параллельного выполнения субагентами. CX Codex +1 ★ 239звёзд репо parallel-task Разбирает markdown-план по спринтам и задачам, затем раздаёт незаблокированные задачи параллельным субагентам. Запускается командой /parallel-task. CX Codex +1 ★ 239звёзд репо elegant-reports Скилл elegant-reports собирает PDF из markdown в сдержанной скандинавской вёрстке: брифинги для руководства, аналитические разборы, презентационные страницы. CX Codex +1 ★ 239звёзд репо gsc Скилл gsc подключает Claude Code к Google Search Console в режиме чтения для проверки аналитики поиска, индексации страниц и карт сайта. CX Codex +1 ★ 239звёзд репо ga4 Запрашивает отчёты и метаданные Google Analytics 4 через GA4 Data API без ручной выгрузки из браузера. CX Codex +1 ★ 239звёзд репо todo-tracker Скилл todo-tracker ведёт список задач в локальном Markdown-файле и сохраняет стабильные ID между сессиями. Попросите добавить, найти, завершить или удалить задачу. CX Codex +1 ★ 239звёзд репо frontend-design Скилл frontend-design для Claude Code задаёт порядок работы над интерфейсом: сначала схема и тема, затем анимация и код. Создаёт лендинги, дашборды и отдельные компоненты. CX Codex +1 ★ 239звёзд репо nudocs Связывает агента с сервисом Nudocs.ai для выгрузки файлов, получения ссылок на совместное редактирование и скачивания готового контента. CX Codex +1 ★ 239звёзд репо

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

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