claude-code-harness

Use this skill when introducing, auditing, refactoring, or extending the Claude Code harness of a project — i.e. its `.claude/` directory (CLAUDE.md, settings.json, hooks/, agents/, skills/, commands/) and root CLAUDE.md. Activates on phrases like 'set up Claude Code in this project', 'design my .claude/', 'audit my Claude Code harness', 'add a hook/skill/subagent', 'how should I organize CLAUDE.md', 'what built-ins does Claude Code already have', 'should I write a custom orchestrator subagent', 'when should I use a dynamic workflow', 'why is my harness slow / brittle / token-heavy', 'extend Claude Code with X', 'set up the long-running build kit (Phase 5)', 'refresh my practice baseline'. Claude Code 2.x / Opus-class-specific — does NOT teach harness design for other agent frameworks (building agents in OpenAI/Codex/LangChain-style stacks); an external CLI wired into *this* harness as an MCP server is in scope. Skip when the project's `.claude/` already encodes this discipline.

Зафиксировать значимое изменение в .claude/devlog/ после завершения фичи, багфикса, рефакторинга, изменения конфига/CLI/API, добавления тестов или принятия архитектурного решения. Создаёт entries/NNNN-slug.md с YAML frontmatter и регенерирует index.json. Trigger on: '/devlog', 'запиши в devlog', 'обнови changelog', 'зафиксируй изменения', а также автоматически после значимых правок кода.

Провести изменение репозитория claude-code-harness от правки до origin/main — надёжно, одним ритуалом. Сначала решает развилку: правка задевает shipped-поверхность (plugins/**, README, CHANGELOG, marketplace.json) → нужен version bump + тег; или это dev-harness-фикс (.claude/**, .gitignore) → обычный commit+push без тега. Затем выполняет выбранный путь целиком: bump обоих plugin.json в локстепе, CHANGELOG-запись, devlog+reindex, staging через release.sh, commit/tag/push, верификация синка с origin. Используй ВСЕГДА, когда просят зарелизить/выкатить/обновить плагин, поднять/сменить версию, поставить тег, закоммитить и запушить изменение в этом репо, или спрашивают «нужен ли тег для этой правки». Триггеры: «зарелизь», «выкати обновление», «подними версию до X», «закоммить и запушь», «обнови плагин», «release», «ship it», «bump version». Скипай только для правок, которые заведомо не идут в git (черновики в scratchpad, чисто аналитические ответы).