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

dx-harness — скилл для Claude Code: аудит трения в разработке

Скилл dx-harness для Claude Code, Cursor и других IDE, который находит и устраняет трение в dev-loop — медленную подготовку, повторяющиеся ручные шаги, отсутствующие скрипты bootstrap и reset.

MIT 141 установок ★ 227 обновлён 2026-08-15

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

Что делает dx-harness

dx-harness сканирует репозиторий, выявляет узкие места в разработке и генерирует канонические скрипты: bootstrap.sh, reset.sh, seed.sh, файл AGENTS.md с точками входа для агентов и записи в таск-раннер. Работает на Claude Code, Cursor, GitHub Copilot, Codex, Gemini CLI и OpenCode.

Процесс состоит из семи шагов: обнаружение инструментов в репозитории, аудит с оценкой проблем, определение приоритетов, генерация fixes в изолированную директорию, показ дифф пользователю, проверка harness'а в отдельном git worktree и сохранение истории трения. Все изменения сначала попадают в песочницу — пользователь сам решает, что применить.

Требует bash, git, node и jq. Автоматически определяет npm, yarn, pnpm, bun, cargo, go modules, Python (uv, poetry, pip), just, make, docker compose и Postgres. Цель по умолчанию — запуск проекта за 60 секунд. Не удаляет данные и не пускает force-push.

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

  • ускорить подготовку нового разработчика к первому commit
  • устранить повторяющиеся ручные шаги перед началом работы
  • добавить недостающие скрипты bootstrap, reset и seed
  • обнаружить и зафиксировать дрейф в dev-practices с течением времени
  • сделать точки входа для агентов явными в AGENTS.md

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

  • Аудит трения в dev-loop: «Люди приходят на проект, и им три часа на настройку. Проверь, где узкие места»
  • Побитовое улучшение: «Я всегда запускаю эти три команды перед началом. Напиши мне скрипт»
  • Проверка time-to-first-commit: «Сколько времени нужно, чтобы новичок дошёл до первого PR? Проверь за 60 секунд»

Как установить dx-harness

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill dx-harness -a claude-code

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

~/.claude/skills/dx-harness/SKILL.md

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

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

Вопросы о dx-harness

Как установить dx-harness в Claude Code?

Запустите npx skills add pproenca/dot-skills --skill dx-harness -a claude-code, затем откройте ~/.claude/skills/dx-harness/SKILL.md. Для других IDE используйте соответствующий флаг: -a cursor для Cursor, -a codex для Codex, -a gemini-cli для Gemini CLI.

Что делает dx-harness?

Сканирует репозиторий, находит помехи в разработке (медленная подготовка, ручные шаги), генерирует скрипты bootstrap.sh, reset.sh, seed.sh и AGENTS.md, проверяет всё в изолированной директории. Не трогает код — всё появляется в песочнице, пользователь сам выбирает, что применить.

Какие инструменты должны быть установлены?

Обязательны bash, git, node и jq. Скилл сам определит npm, yarn, pnpm, bun, cargo, go modules, Python, just, make, docker compose и Postgres — адаптируется под то, что найдёт в репозитории.

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

SKILL.md · MIT
---
name: dx-harness
description: Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions. Audits the repo, scores findings, scaffolds canonical fixes (bootstrap.sh, reset.sh, seed.sh, AGENTS.md, task-runner entries), then verifies the harness end-to-end in a scratch worktree against a 60-second time-to-first-commit target. Triggers on phrases like "audit dx", "fix dev friction", "time to first commit", "set up the harness", "I keep doing X manually", "every time I reset the db I have to...", and on new-repo bootstrapping. Even if the user doesn't say "DX" — if they describe a repeated manual chore in their dev loop, this skill applies.
---
# DX Harness

Audits, scaffolds, and maintains the developer-experience harness of a repository. The harness is the meta-tooling that makes a dev loop fast: one-command bootstrap, one-command reset, one-command seed, discoverable conventions, agent-friendly entry points.

This skill exists because dev-experience attrition is real: harnesses rot, manual steps creep back in, conventions drift, and the cost is paid in micro-friction every day. The skill detects attrition systematically and applies canonical fixes.

## When to Apply

Trigger this skill when:

- A user describes a **repeated manual chore** ("every time I reset the db I have to re-register", "I always run these three commands before working")
- A user mentions **slow onboarding** or asks "how do I get this running"
- A new repo is being **bootstrapped** and needs a harness from day one
- A user explicitly asks to **audit DX** or **measure time-to-first-commit (TTFC)**
- A user asks to **fix** missing bootstrap/reset/seed scripts or AGENTS.md
- A periodic **maintenance pass** is needed (e.g., after a release, after onboarding a new engineer)

## Workflow Overview

```
┌────────────────────────────────────────────────────────────┐
│  1. DISCOVER     scripts/discover.sh → repo-fingerprint    │
│  2. AUDIT        scripts/audit.sh    → dx-audit.json       │
│  3. PRIORITIZE   scripts/prioritize.sh → ranked findings   │
│  4. SCAFFOLD     scripts/scaffold-*.sh → scratch dir       │
│  5. CONFIRM      show diff to user; user picks what to apply│
│  6. VERIFY       scripts/verify.sh → assertions + timing   │
│  7. TRACK        scripts/track-attrition.sh → audit log    │
└────────────────────────────────────────────────────────────┘
```

All scaffolded edits land in a scratch directory first (`${TMPDIR}/dx-harness-<timestamp>/`). The user reviews the diff and chooses what to copy back into the repo. No surprise writes to the working tree.

## Tool Requirements

Required: `bash`, `git`, `node`, `jq`.

Detected at runtime (the skill adapts — it never forces a migration):

| Toolchain | Detection signal |
|-----------|------------------|
| npm/pnpm/yarn/bun | `package.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lockb` |
| cargo | `Cargo.toml` |
| go modules | `go.mod` |
| Python (uv/poetry/pip) | `pyproject.toml`, `uv.lock`, `poetry.lock`, `requirements.txt` |
| just | `Justfile` or `justfile` |
| make | `Makefile` |
| docker compose | `docker-compose.yml`, `compose.yaml` |
| database (postgres) | `docker-compose.yml` services, `DATABASE_URL` env reference |

## Risk Level

**Write.** The skill writes files but does not delete user data, force-push, or run destructive ops. Default mode stages everything in a scratch directory; the user explicitly approves each application. Verification runs in a separate git worktree so timing measurements never touch the working tree.

## Setup

On first invocation, the skill checks `config.json` and prompts via `AskUserQuestion` for any empty required fields. See [config.json](config.json) for fields and defaults.

Key defaults:
- `ttfc_target_seconds: 60` — the time-to-first-commit goal in seconds
- `apply_mode: "scratch"` — scaffolded edits go to scratch dir first; user copies in
- `audit_log_path: "${CLAUDE_PLUGIN_DATA}/dx-harness/audits.log"` — persistent attrition history

## Quick Reference

### Run a full audit + scaffold pass
```bash
bash scripts/discover.sh > /tmp/fingerprint.json
bash scripts/audit.sh /tmp/fingerprint.json > /tmp/audit.json
bash scripts/prioritize.sh /tmp/audit.json
```

### Scaffold one specific harness piece
```bash
bash scripts/scaffold-bootstrap.sh   /tmp/fingerprint.json
bash scripts/scaffold-reset.sh       /tmp/fingerprint.json
bash scripts/scaffold-seed.sh        /tmp/fingerprint.json
bash scripts/scaffold-agents-md.sh   /tmp/fingerprint.json
bash scripts/scaffold-justfile.sh    /tmp/fingerprint.json
```

### Verify the harness works end-to-end
```bash
bash scripts/verify.sh
# runs bootstrap in a scratch worktree, times it, asserts TTFC < target
```

### Track attrition over time
```bash
bash scripts/track-attrition.sh /tmp/audit.json
# appends to audits.log, prints diff vs previous run
```

## How to Use

The workflow scripts produce JSON between steps so they compose. The agent should read [references/workflow.md](references/workflow.md) for full step-by-step orchestration, including error handling and when to stop and ask the user.

For deeper context:

| File | Read When |
|------|-----------|
| [references/workflow.md](references/workflow.md) | Executing the workflow (always start here) |
| [references/audit-checklist.md](references/audit-checklist.md) | Understanding what `audit.sh` checks and why |
| [references/fix-recipes.md](references/fix-recipes.md) | Choosing which scaffold script applies for a finding |
| [references/attrition-patterns.md](references/attrition-patterns.md) | Reading git history for DX-rot signals |

## Gotchas

See [gotchas.md](gotchas.md) — accumulated failure points discovered over time. Always append new ones rather than rewriting.

## Related Skills

- `dev-skill:*` — for creating new agent-friendly skills (often the *output* of an AGENTS.md scaffolding pass references skills)
- `bug-review` — pairs naturally: bad DX often surfaces as repeat bug categories

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
agent-rules Netresearch DTT GmbH Скилл agent-rules для Claude Code создаёт и обновляет файлы правил AGENTS.md по стандартам репозитория. Запускается при онбординге ИИ-агентов или настройке инструкций в новом проекте. CX Codex +1 850установок harness-init Gizele1 Плагин harness-init для Claude Code, который за один прогон превращает репозиторий в среду для агентной разработки. Создаёт AGENTS.md, архитектурные тесты, CI-пайплайн и скрипты сборки мусора. ★ 56звёзд репо ns-harness nextstage-brasil Разбирает существующий код и создаёт для агента правила работы с проектом. Запускается по /ns-harness prepare this repo или architecture-rules.md. CX Codex +1 249установок bootstrap-agent-config dshakes Скилл bootstrap-agent-config обходит проект, находит стек и команды сборки, а потом пишет CLAUDE.md и AGENTS.md с правилами, взятыми из кода. CX Codex +1 ★ 23звёзд репо debugging-toolkit-dx-optimizer Seth Hobson Субагент debugging-toolkit-dx-optimizer находит узкие места в процессах разработки и ускоряет онбординг до пяти минут. Помогает при старте новых репозиториев и автоматизации рутины. CX Codex ★ 42 780звёзд репо harness stellarlinkco Скилл harness для Claude Code, Codex, Cursor и других платформ, который ведёт долгосрочные агентные задачи через несколько сессий с чекпоинтами и откатом при сбоях. CX Codex +1 158установок

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

Весь набор →
implementation-design-patterns-python Скилл implementation-design-patterns-python для Claude Code помогает выбирать и применять паттерны проектирования в современном Python. Он помогает разбираться с разрастающимися ветвлениями, наследованием и связями между объектами. CX Codex +1 143установок better-auth-scaffold Скилл better-auth-scaffold раскладывает Better Auth по файлам в проекте Next.js с App Router и Drizzle: шаблоны, три набора плагинов, генерация схемы и миграции. CX Codex +1 143установок expo-ui Скилл помогает писать и проверять React Native-интерфейсы на @expo/ui для iOS. Пригодится при переносе экранов на SwiftUI и работе с компонентами iOS 26. CX Codex +1 142установок design-to-react-algorithms Скилл design-to-react-algorithms задаёт алгоритмический пайплайн переноса макетов Sketch и Figma в чистый React с CSS без регрессий вёрстки. CX Codex +1 142установок acceptance-pipeline-catalog Скилл acceptance-pipeline-catalog направляет агента при сборке и отладке пайплайна приёмочных тестов на базе Gherkin и мутационного тестирования по спецификации Роберта Мартина. CX Codex +1 142установок nuqs-codemod-runner Скилл nuqs-codemod-runner находит устаревшие паттерны nuqs версий до 2.5, показывает сухой отчёт изменений и безопасно переписывает код с проверкой типов и линтером. CX Codex +1 142установок inngest-nextjs-patterns Скилл inngest-nextjs-patterns для Claude Code собирает шаблоны Inngest для фоновых задач в Next.js App Router: клиент, обработчик, типизированные события, cron и функции с шагами. CX Codex +1 141установок acceptance-pipeline-feature-design Скилл acceptance-pipeline-feature-design помогает спроектировать расширения Acceptance Pipeline: от синтаксиса Gherkin и полей JSON IR до новых стадий и форматов отчётов. CX Codex +1 141установок

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

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