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

upfront-design — скилл для Claude Code и Cursor

Скилл upfront-design для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode ведёт структурированное проектирование до написания кода.

MIT 321 установок ★ 6 обновлён 2026-11-10

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

Что делает upfront-design

Скилл работает на шести платформах: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. При каждом вызове он определяет маршрут: новый запрос, черновик или проверка открытого milestone. Маленькие задачи — один модуль без контрактных изменений с однострочным результатом — получают ответ DIRECT без файла и ledger. Всё остальное идёт по пяти фазам.

Фазы: Product, System, Program, Slices, Finalize. Каждая завершается AWAITING_USER и сохраняет одобренный контент до перехода к следующей. Файл дизайна хранится вне репозиториев по пути <anchor>/designs/<basename>-<slug>-<YYYY-MM-DD-HHmmss>.md; ledger пишется атомарным переименованием через временный файл-сосед. Скилл ищет ADR-деревья по путям docs/adr/, adr/, doc/adr/, docs/decisions/ и молча пропускает их отсутствие.

Фаза Check запускается на одобренном дизайне: скилл показывает точные команды для первого незакрытого milestone и ждёт разрешения перед выполнением. Галочка ставится только при наличии доказательства результата, совпадающего с символами дизайна — успешный exit-code без этого не считается. Создать файл references/design.md нужно до первого использования скилла, иначе фазы не заполнятся.

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

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

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

  • Запусти upfront-design для новой фичи авторизации
  • Продолжи черновик дизайна auth-service
  • Проверь следующий открытый milestone по дизайну payment-flow

Как установить upfront-design

1Через Skills CLI (Vercel)

npx skills add prathamdby/skills --skill upfront-design -a claude-code

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

~/.claude/skills/upfront-design/SKILL.md

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

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

Вопросы об upfront-design

Как установить upfront-design в Claude Code?

Выполните npx skills add prathamdby/skills --skill upfront-design -a claude-code. Скилл появится по пути ~/.claude/skills/upfront-design/SKILL.md.

Что делает скилл upfront-design?

Он ведёт проектирование через пять фаз — Product, System, Program, Slices, Finalize — и паузирует после каждой, сохраняя одобренный контент перед переходом к следующей. Маленькие задачи обрабатываются напрямую без создания файла.

Нужен ли файл references/design.md для работы скилла?

Да, скилл использует references/design.md как шаблон при создании документа дизайна. Без него фазы не заполнятся.

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

SKILL.md · MIT
---
name: upfront-design
description: >
  When the user wants a design agreed before coding, a draft resumed, or an approved milestone checked.
---

# Upfront design

## Route and persistence

A design has request/status frontmatter and a `# Design:` title.
New request → design; draft → first missing section; approved → check next
open milestone; another status → `BLOCKED`. A named revision phase removes
later sections only after the user authorizes that revision.

Resolve this skill's absolute anchor. Store new designs at
`<anchor>/designs/<basename>-<slug>-<YYYY-MM-DD-HHmmss>.md`, outside repos.
`<basename>` is the first repo's root directory name.
After a path exists, persist approved phases and the ledger through sibling
temporary files and atomic rename before advancing. Record
`request | size | design | phase | approvals | ADR offers | terminal`.
Keep the ledger at `<design>.ledger` on `AWAITING_USER`; remove on other terminals.

Small means one module, no contract/data/public-signature change, and a
one-sentence outcome. Return `DIRECT` plus that sentence without a file/ledger.
Otherwise find ADR trees (`docs/adr/`, `adr/`, `doc/adr/`, `docs/decisions/`);
absence is silent. Create the document using `references/design.md`.
Done when route, size, path/frontmatter, and relevant ADRs are fixed.

## Design phases

Each phase pauses with `AWAITING_USER`; write its approved content before
the next starts. Resume at the first missing or explicitly revised phase.

1. **Product:** concrete pain, measurable Success, bold one-line solution,
   supplied mockup or draft text wireframe/state table for user-facing work,
   delivery paragraph. Ask the entire question frontier in one numbered round,
   recommending an answer per question. Done when approved content is persisted.
2. **System:** bold shape + cited pattern, NEW/CHANGED layer roles, sources
   and constraints with cost reasons, phase-banded sequence. Name ADR conflicts,
   not overrides. Done when approved content is persisted.
3. **Program:** changed boundary contracts, constraints, real signatures,
   usage, and roles, not bodies. Cite patterns or assumptions; compare two
   uncertain layouts, choose one, and record why the other lost.
   For multiple boundaries, changed dispatch, or unclear async order,
   apply Wiring views in `references/design.md`.
   Done when each Success maps to symbols/results and approval is persisted.
4. **Slices:** after prefactoring, start with a thin end-to-end contract/check.
   One reviewable vertical PR per milestone; name symbols, expected success
   and relevant failures, assertions/manual proof, repo order, and one open
   checkbox. Only the user defers/skips; wide refactors expand then contract.
   Done when every symbol is assigned and approved milestones are persisted.
5. **Finalize:** set approved. Offer ADRs only for decisions hard to reverse,
   surprising without context, and chosen over a real alternative. On approval
   use `references/decisions.md`. Done with `DESIGNED` when all five document
   sections exist and each ADR offer is written or declined. Report design/ADR
   paths, peer-review, and milestone check route.

## Check

For an approved design, follow `references/check.md` for the first open,
non-deferred/non-skipped milestone. Show exact commands and obtain approval
before running them. Tick only with outcome proof and matching symbols,
not a successful exit. Open manual boxes or ambiguous legacy outcomes pause.
Never edit product files to make a check pass. Done with `CHECKED` if ticked
or all complete, otherwise `AWAITING_USER`.

Terminals: `DIRECT` (router no-op success), `AWAITING_USER`, `DESIGNED`,
`CHECKED`, `BLOCKED`. Revise via draft status and a named phase.

© prathamdby · MIT · prathamdby/skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
recipe-design shinpr Скилл recipe-design для Claude Code координирует проектирование архитектуры от анализа кодовой базы до утверждения Design Doc. Процесс включает промежуточные остановки для подтверждения решений человеком. CX Codex +1 ★ 720звёзд репо grill-with-docs akillness Скилл grill-with-docs для Claude Code проводит разбор плана или дизайна и создаёт ADR с записями глоссария. Запускается фразами про разбор и документирование. CX Codex +1 366установок absolute-spec dhruvjainin Скилл absolute-spec для Claude Code превращает запрос на функцию в проектную спецификацию после изучения кодовой базы. Агент задаёт несколько уточняющих вопросов, записывает документ в docs/plans/ и передаёт его на отдельную оценку. CX Codex +1 176установок review-a-design Inkeep Скилл review-a-design проверяет архитектурные предложения, спецификации и ADR на логическую состоятельность. Выявляет слабые места в аргументах и не переписывает текст за автора. CX Codex +1 252установок w-architecture blockmatic-icebox Скилл w-architecture для Claude Code помогает спланировать структуру реализации. Он сверяет изменения с архитектурными документами и ADR проекта. CX Codex +1 647установок upfront ThinkUpfront Плагин upfront заставляет сначала спроектировать логику задачи через диалог и проверить граничные условия, а уже потом генерировать рабочий код. ★ 6звёзд репо

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

Весь набор →
gh Скилл gh помогает агенту читать состояние PR, обсуждения и CI, отвечать в тредах и выполнять сложные команды GitHub. CX Codex +1 420установок cursor-agent Управляет локальным CLI cursor-agent: запускает агента в выбранном режиме и проверяет результат. Подключается к задачам сессий, рабочих деревьев и настроек CLI. CX Codex +1 347установок codex Запускает локальный Codex CLI по запросу агента. Включается в задачах, где требуется вызвать Codex CLI с конкретными флагами и без ручных подтверждений. CX Codex +1 331установок claude-code Запускает локальный CLI с заданным режимом и проверяет результат. Он также помогает изменить установку, вход или подключённые инструменты. CX Codex +1 329установок todoist-task Скилл todoist-task для Claude Code, Cursor и других IDE помогает создавать задачи в Todoist прямо из редактора. CX Codex +1 315установок use-skill Скилл use-skill тянет скилл по ссылке на GitHub, проверяет структуру и выполняет шаги во временном каталоге — в проект ничего не ставится. CX Codex +1 294установок autoplan Скилл autoplan для Claude Code составляет план реализации без уточняющих вопросов. Он изучает репозиторий, фиксирует риски и разбивает крупную работу на этапы. CX Codex +1 287установок restate Скилл restate для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — повторяет последний ответ агента простыми словами. Запускается, когда нужно догнать контекст или понять, что именно требует решения. CX Codex +1 256установок

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

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