upfront-design — скилл для Claude Code и Cursor
Скилл upfront-design для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode ведёт структурированное проектирование до написания кода.
MIT 321 установок ★ 6 обновлён 2026-11-10
npx skills add prathamdby/skills --skill upfront-design -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/upfront-design/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/upfront-design/
1Через Skills CLI (Vercel)
npx skills add prathamdby/skills --skill upfront-design -a codex2Вручную: положить файлы
.agents/skills/upfront-design/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add prathamdby/skills --skill upfront-design -a cursor2Вручную: положить файлы
.cursor/skills/upfront-design/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install prathamdby/skills skills/engineering/upfront-design2Вручную: положить файлы
.github/skills/upfront-design/SKILL.md1Через Skills CLI (Vercel)
npx skills add prathamdby/skills --skill upfront-design -a gemini-cli2Командой платформы
gemini skills install https://github.com/prathamdby/skills --path skills/engineering/upfront-designВручную: положить файлы
.devin/skills/upfront-design/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add prathamdby/skills --skill upfront-design -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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