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

ns-harness — скилл для Claude Code: bootstrap и подготовка brownfield-проектов

Скилл для Claude Code, Cursor и других платформ: разбирает существующий код и создаёт для агента правила работы с проектом. Запускается по /ns-harness prepare this repo или architecture-rules.md.

Apache-2.0 249 установок обновлён 2026-10-24

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

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

Анализирует структуру репозитория, извлекает архитектурные паттерны и генерирует architecture-rules.md — документ, который объясняет агенту, как устроен проект. Создаёт AGENTS.md с точками входа для задач, запускает обратную инженерию бизнес-логики из кода и строит карту brownfield-системы.

Внутри — четыре модуля: подготовка репозитория, генератор правил архитектуры, writer для AGENTS.md и reverse-инженер спецификаций. Скилл читает ссылки из references/ и следует им без импровизации. Требует чтения references/session-boot.md перед любым шагом.

Для brownfield-проектов со сложной историей это способ дать агенту контекст без ручного пересказа. Скилл не пишет код — только собирает карту для того, кто будет писать.

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

  • разобрать структуру brownfield-проекта без документации
  • сгенерировать правила архитектуры для AI-агента
  • создать AGENTS.md с описанием задач и точек входа
  • извлечь бизнес-логику из legacy-кода
  • подготовить контекст после рефакторинга

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

  • Подготовь этот репозиторий для работы агента
  • Сгенерируй architecture-rules.md для проекта
  • Создай AGENTS.md с описанием задач

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

1Через Skills CLI (Vercel)

npx skills add nextstage-brasil/skills --skill ns-harness -a claude-code

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

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

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

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

Вопросы о ns-harness

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

Выполни npx skills add nextstage-brasil/skills --skill ns-harness -a claude-code, затем открой ~/.claude/skills/ns-harness/SKILL.md.

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

Анализирует существующий код, строит карту архитектуры и генерирует правила для AI-агента: architecture-rules.md, AGENTS.md и спецификации бизнес-логики.

Зачем нужен ns-harness для brownfield-проектов?

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

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

SKILL.md · Apache-2.0
---
name: ns-harness
description: "(NS) Harness boot + brownfield prepare. Triggers: /ns-harness, prepare this repo, harness prepare, generate architecture rules, architecture-rules.md, write AGENTS.md, reverse-engineer codebase, engenharia reversa, brownfield map, bootstrap brownfield, ns-harness-prepare, ns-architecture-rules, ns-agent-generator, ns-codebase-reverse-spec, ns-bootstrap-brownfield. Do NOT: coding, SDD, GitLab."
license: Apache-2.0
metadata:
  author: nextstage-brasil
  version: "1.5.3"
---

# NextStage Harness

Project harness face. Other catalog skills point here for **session boot** + artifact paths. Also runs brownfield onboarding via local references — no separate prepare/architecture/agents/reverse/brownfield skills.

**Consumer skill convention:** point to `references/session-boot.md`; require **Session boot (blocking)** before other steps. Do not duplicate boot sequence in skill bodies or frontmatter `description`.

## Dispatch (this skill as face)

**Session boot** (`references/session-boot.md`) first — pick **one** row. First matching signal wins.

| Signal | Reference |
| ------ | --------- |
| Prepare this repo / harness prepare / onboard brownfield / full prepare / stale context after refactor | `references/prepare.md` (four workers in order) |
| Architecture rules / constitution / "how this repo works for the AI" / `.nextstage-harness/rules/architecture-rules.md` | `references/architecture-rules-generator.md` |
| Write/refresh `AGENTS.md` / `CLAUDE.md` / agent entry | `references/agents-md.md` |
| Reverse-engineer / engenharia reversa / business rules from code | `references/codebase-reverse-spec.md` |
| Brownfield map / analyze existing project (map only) | `references/bootstrap-brownfield.md` |
| `/ns-harness` with no qualifier | Show this table; ask once if intent unclear |

Bare `/ns-harness prepare this repo` **is** full `prepare.md`. Do **not** send user to retired slash names.

Read chosen reference **in full**; follow it. Do not improvise parallel workflow.

## Shared references (other skills)

| File | When to read |
| ---- | ------------ |
| `references/session-boot.md` | Session boot (blocking), rules paths, MCP GitLab pointers |
| `references/rules-sync.md` | Canonical rules layout, manifest schema, `harness sync` |
| `references/artifact-layout.md` | SDD artifact paths under `docs/versions/`, living specs, handoff rules |
| `references/code-skill-routing.md` | Entry priority + handoffs between implementation skills |
| `references/subagent-dispatch.md` | Spawn gate: cheap vs heavy execute; **MUST** exact `{name}` when gate requires. **FORBIDDEN** child Task `inherit` / platform `coder` / `reviewer` |
| `references/agent-artifact-compress.md` | **Pre-save** on agent-facing drafts only (caveman ultra; never chat) |
| `references/project-skill-authoring.md` | Author project-local skills — requires Anthropics `skill-creator` + `harness sync` |

Read only file(s) the active workflow names. Do not assume stack unless detected in rules or context.

© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
harness-init Gizele1 Плагин harness-init для Claude Code, который за один прогон превращает репозиторий в среду для агентной разработки. Создаёт AGENTS.md, архитектурные тесты, CI-пайплайн и скрипты сборки мусора. ★ 56звёзд репо bmad-document-project aj-geddes Скилл bmad-document-project для Claude Code сканирует готовый репозиторий в режиме чтения и сохраняет файл project-documentation.md. Документ фиксирует стек и архитектуру перед планированием дальнейших задач. CX Codex +1 104установок harness-engineering pproenca Скилл harness-engineering для Claude Code, настройки и обновления инфраструктуры репозитория под агентское кодирование. Создаёт AGENTS.md как карту кодовой базы, архитектурные границы и правила в .harness/ для эффективной работы AI-агентов. CX Codex +1 312установок spec-miner https://github.com/Jeffallan Скилл spec-miner для Claude Code, Codex, Cursor и других агентов, который читает незадокументированный код и выдаёт спецификацию. Анализирует зависимости, маршруты, бизнес-логику и сохраняет результат в specs/{project_name}_reverse_spec.md. CX Codex +1 4 900установок dx-harness pproenca Скилл dx-harness для Claude Code, Cursor и других IDE, который находит и устраняет трение в dev-loop — медленную подготовку, повторяющиеся ручные шаги, отсутствующие скрипты bootstrap и reset. CX Codex +1 141установок harness-kit romabeckman Плагин harness-kit для Claude Code, который строит цикл разработки на трёх навыках: долгая память проекта с ADR и графом зависимостей, Domain-Driven Design с четырьмя фазами спецификаций и TDD-оркестратор, который пишет тесты до кода. ★ 30звёзд репо

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

Весь набор →
ns-gitlab-board-sync Скилл ns-gitlab-board-sync для Claude Code синхронизирует существующие задачи GitLab с локальным планом и ходом работ. Запускается при реализации задач, связанных с issue, или после синхронизации плана из GitLab. CX Codex +1 899установок ns-spec-driven Скилл ns-spec-driven для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который ведёт доставку фичи по формальной спецификации. CX Codex +1 208установок ns-gitlab-ci-generator Скилл ns-gitlab-ci-generator генерирует и настраивает пайплайн .gitlab-ci.yml для SaaS-монорепозиториев со структурой бэкенда и фронтенда. CX Codex +1 200установок ns-project-manager Скилл ns-project-manager для Claude Code превращает заметки и PRD в проектные артефакты, оценки сроков и отчёты. CX Codex +1 185установок ns-langgraph-agents Скилл ns-langgraph-agents для Claude Code, Codex, Cursor и других платформ, который ведёт разработку LangGraph.js agent-api от начального развёртывания до синхронизации graph-spec. CX Codex +1 171установок ns-execution-gitlab-issue Скилл ns-execution-gitlab-issue автоматизирует закрытие задач GitLab: изолирует работу в Git worktree, переключает статусы, запускает кодинг и создаёт Merge Request. CX Codex +1 165установок ns-requirements-enricher Скилл ns-requirements-enricher собирает бриф по реализации для одной задачи GitLab или вставленного описания: сначала смотрит код проекта, потом задаёт блокирующие вопросы в чате. CX Codex +1 163установок ns-best-practices Скилл ns-best-practices проверяет заголовки безопасности, базовую доступность интерфейса и правила Web Interface Guidelines. Находит уязвимости и готовит отчёт. CX Codex +1 154установок

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

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