Розробка за специфікаціями з Claude Code і Cursor

Claude Code — агентний інструмент програмування, який читає кодову базу, редагує файли і запускає команди. Cursor — редактор, чиї правила проєкту лежать у .cursor/rules як файли .mdc. Розробка за специфікаціями (SDD, spec-driven development) — практика писати специфікацію до коду і вважати специфікацію джерелом правди. Документ вимог до продукту (PRD, product requirements document) — проза, яка називає проблему і межі до того, як роботу ділять на завдання. У SpecScore специфікація функції — файл однієї можливості продукту, вимога (REQ) — іменоване правило всередині цієї функції, а критерій приймання (AC, acceptance criterion) — необов’язкова абстрактна умова, яка вказує на одне або кілька таких правил. Безперервна інтеграція (CI, continuous integration) — автоматична перевірка кожної запропонованої зміни. Перевірка — команда інтерфейсу командного рядка (CLI, command-line interface), specscore spec lint, з CLI в specscore/specscore-cli. Специфікації Cursor на цій сторінці — цей файл функції разом із правилом проєкту Cursor, яке велить агенту лінтувати його.

Востаннє оновлено: 6 листопада 2026

Що лежить у функції, а що — у файлі агента

Файл функції зберігає зобов’язання. README функції під spec/features/ несе правила #### REQ: і критерії ### AC:. Заповнена форма, план і завдання — це шаблон PRD у Markdown. specscore spec lint перевіряє цю форму: заголовки, обов’язкові розділи, рядки індексу і посилання. Він не вирішує, чи ідея продукту добра. Лінтувати специфікації в CI — докладніша розповідь про цю команду.

Файл агента зберігає інструкції для одного інструмента. Огляд Anthropic каже, що CLAUDE.md — це файл Markdown у корені проєкту, який Claude Code читає на початку кожної сесії. Документація правил Cursor каже, що правило проєкту — це файл .mdc у .cursor/rules, а звичайний файл .md у цьому каталозі ігнорується, бо не має frontmatter. Ці файли кажуть агенту, як працювати в репозиторії. Вони не є специфікацією, яку перевіряє лінтер. Вимога, яка є лише в CLAUDE.md або лише в .cursor/rules/specscore.mdc, невидима для specscore spec lint.

Що пише specscore agent setup

README CLI каже, що specscore agent setup пише файл інструкцій кожного агента і, якщо в цього агента є каталог навичок, копіює в нього пакети навичок SpecScore. Команда пропускає наявний файл, якщо не передати --force. Контракт — функція agent-setup у specscore/specscore-cli.

Цей контракт зіставляє ідентифікатор caller claude з CLAUDE.md і .claude/skills/, а ідентифікатор caller cursor — з .cursor/rules/specscore.mdc і .cursor/skills/. Запускайте команду всередині проєкту, у якому вже є specscore.yaml. Якщо цього файла немає, команда завершується з кодом 6, і повідомлення пропонує specscore init. Один виклик, який називає обох агентів, — specscore agent setup claude,cursor. Функція каже, що список через кому — те саме, що окремі аргументи. Батьківські каталоги створюються. Кожен шлях повідомляється як доданий, змінений або пропущений.

Згенерований CLAUDE.md містить назву проєкту, приклади CLI, які передають --caller claude, і рядок встановлення /plugin install specscore@specscore. Файл Cursor — це Markdown із YAML frontmatter. Frontmatter містить description і alwaysApply: true. Таблиця правил Cursor каже, що alwaysApply: true означає, що правило включається в кожен чат. --no-skills пише файли інструкцій і не копіює пакети навичок. Та сама таблиця контракту називає також codex, copilot, antigravity.google, pi.dev, opencode і deepseek. Ця сторінка стосується двох агентів із заголовка.

Пише файли Claude Code і Cursor. Запускайте команду з проєкту, у якому є specscore.yaml.

specscore agent setup claude,cursor

Шляхи, які контракт призначає claude і cursor. Каталоги навичок не створюються, якщо передати --no-skills. Наявний файл лишається як є, якщо не передати --force.

CLAUDE.md
.claude/skills/
.cursor/rules/specscore.mdc
.cursor/skills/

Файл інструкцій вказує на дерево функцій. Він його не замінює. Після налаштування Claude Code і далі має читати spec/features/, а правило Cursor і далі має вказувати на те саме дерево. Специфікація функції залишається документом, який specscore spec lint приймає або відхиляє.

Запускайте specscore spec lint у циклі

Спершу встановіть CLI. Способи встановлення — на сторінці встановлення. Потім тримайте функцію і лінтер у тому самому циклі, що й агента.

Напишіть функцію до промпту

Додайте README функції, рядок індексу функцій і specscore.yaml за шаблоном PRD. Покладіть кожне зобов’язання під ## Behavior як #### REQ: {slug}. Вкажіть критерії приймання на ці id через **Requirements:**. Залиште CLAUDE.md і .cursor/rules/ на наступний крок.

Лінтуйте, перш ніж агент редагуватиме код

Запустіть specscore spec lint у репозиторії. Чисте дерево друкує 0 violations found і завершується з кодом 0. Звіт про збій — файл, рядок, серйозність, правило, повідомлення — у Лінтувати специфікації в CI. Виправляйте функцію, поки ця команда не стане чистою. Агент, який починає з функції, яку лінтер уже відхиляє, скопіює зламану форму.

Спрямуйте Claude Code і Cursor на дерево

Запустіть specscore agent setup claude,cursor. Прочитайте додані CLAUDE.md і .cursor/rules/specscore.mdc і переконайтеся, що вони називають дерево специфікацій і CLI, включно з --caller. Якщо будь-який із цих файлів уже існував, команда його пропускає. Передавайте --force лише тоді, коли ви хочете замінити цей файл.

Попросіть завдання, яке називає критерій

У сесії агента назвіть функцію і критерій приймання, якому має відповідати робота. Завдання плану робить це через **Verifies:** і id критерію приймання. Попросіть агента знову запустити specscore spec lint перед тим, як закінчити, і змінити файл функції, коли змінюється поведінка. Файл інструкцій велить агенту запустити команду. Файл функції — те, що команда перевіряє.

Навички, які відкривають lint, функцію і завдання

Рядки встановлення плагіна-обгортки в README CLI — /plugin marketplace add specscore/ai-marketplace і /plugin install specscore@specscore. Репозиторій плагіна — specscore/ai-plugin-specscore, за ліцензією MIT. Його README навичок каже, що користувачі викликають /specscore:<skill-name>. Обгортки в поставці включають /specscore:spec, яка обгортає specscore spec lint; /specscore:feature, яка обгортає specscore feature (list, info, tree, deps, refs, new і change-status); і /specscore:task, яка обгортає specscore task. /specscore:change-status покриває зміну статусу функції та ідеї. Сторінка CLI Skills на цьому сайті — ця обгортка. specscore agent setup копіює ці пакети навичок у .claude/skills/ і .cursor/skills/, якщо не передати --no-skills.

README плагіна каже, що в Cursor немає команди remote-install і що навички завантажуються з .cursor/skills/ у проєкті або з ~/.cursor/skills/. Ручне копіювання, яке він показує, — git clone репозиторію ai-plugin-specscore і cp -R для skills/* у .cursor/skills/. specscore agent setup cursor — команда, яка робить це копіювання за вас, із маркетплейса, який називає специфікація функції.

SpecStudio Skills — керований воркфлоу. Репозиторій — specscore/specstudio-skills, за ліцензією MIT. Рядок встановлення Claude Code у його README — /plugin install specstudio@specscore, і там сказано, що Claude Code встановлює плагін specscore як залежність. Розділ статусу називає версію 0.0.7 і каже, що навички ideate, specify, plan, implement, verify і recap достатньо активні для dogfood. Таблиця інвентарю того самого README докладно документує specstudio:ideate і specstudio:specify. Ці навички пишуть артефакти SpecScore. Вони не замінюють specscore spec lint.

Та сама команда в CI

dogfood.yml у specscore/specscore задає SPECSCORE_VERSION як v0.39.1 і запускає specscore spec lint на pull requests і на push до main. Уривок воркфлоу і текстовий звіт — у Лінтувати специфікації в CI. Функція, яка ламає заголовок, валить цей job незалежно від того, чи файл написав Claude Code, чи Cursor. Цикл агента і CI викликають ту саму команду.

Ліцензія формату — CC BY 4.0 у specscore/specscore. Ліцензія CLI — Apache-2.0 у specscore/specscore-cli.

Інші інструменти розробки за специфікаціями публікують інші перевірки. Речення нижче використовують лише те, що кажуть власні сторінки цих проєктів. Огляд інструментів записує ті самі сторінки як прочитані 30 жовтня 2026, крім головної сторінки документації Spec Kit, яка друкує 28 вересня 2026.

OpenSpec документує openspec validate у своєму довіднику CLI. Ця команда перевіряє структуру змін і специфікацій OpenSpec. Вона не перевіряє заголовок SpecScore ### AC:.

README Task Master описує розбір PRD на завдання командою task-master parse-prd. Він не описує лінтер для цього PRD.

GitHub Spec Kit описує агентний воркфлоу, фази якого пишуть артефакти Markdown. Ця головна сторінка документації не описує команду, яка лінтує README функції SpecScore у CI.

Питання й відповіді

Що таке розробка за специфікаціями з Claude Code?

Це запис функції SpecScore до того, як Claude Code напише код, а потім збереження CLAUDE.md як файла інструкцій, який вказує на цю функцію. Функція зберігає вимоги (REQ) і критерії приймання (AC). specscore spec lint перевіряє функцію. specscore agent setup claude пише CLAUDE.md у проєкті, у якому вже є specscore.yaml.

Куди класти специфікації Cursor?

Зобов’язання продукту йде в README функції під spec/features/. Правило проєкту Cursor йде в .cursor/rules/specscore.mdc. Файли навичок ідуть у .cursor/skills/. specscore agent setup cursor пише правило і, якщо не передати --no-skills, копіює пакети навичок. Власна документація Cursor — джерело того, як застосовуються правила .mdc.

Чи замінює CLAUDE.md специфікацію функції?

Ні. CLAUDE.md — те, що Claude Code читає як інструкції. README функції — те, що перевіряє specscore spec lint. Функція agent-setup каже, що згенерований файл вчить агента дерево специфікацій і команди CLI. Вона не каже, що файл інструкцій є специфікацією.

Що, якщо CLAUDE.md або правило Cursor уже існує?

Команда пропускає наявний файл і друкує рядок пропуску, який згадує --force. Наявні байти залишаються. Передавайте --force лише тоді, коли заміна — це те, що вам потрібно. Те саме правило пропуску застосовується до файла навички, який уже є.

Яка навичка запускає лінтер?

У README навичок плагіна /specscore:spec обгортає specscore spec lint. Цю команду CLI можна також запустити самому, у сесії агента або в CI. /specscore:feature і /specscore:task обгортають команди функції і завдання. Самі по собі вони не лінтують.

Чи оцінює лінтер прозу?

Ні. specscore spec lint перевіряє структуру. Лінтувати специфікації в CI показує звіт. Чиста структурна перевірка — не огляд продукту.

Джерела

Поведінка agent-setup — контракт у specscore-cli spec/features/cli/agent/setup/README.md на main, прочитаний 6 листопада 2026. Імена навичок узяті з ai-plugin-specscore skills/README.md на main, прочитаного того самого дня. Рядок встановлення SpecStudio і список статусу версії 0.0.7 узяті з specstudio-skills README.md на main, прочитаного того самого дня. Опис Claude Code і речення про CLAUDE.md узяті з code.claude.com/docs/en/overview. Шляхи правил проєкту Cursor узяті з cursor.com/docs/rules. dogfood.yml у цьому репозиторії закріплює SPECSCORE_VERSION на v0.39.1. Сторінки конкурентів — ті, що пов’язані нижче; огляд інструментів записує їх як прочитані 30 жовтня 2026, крім головної сторінки документації Spec Kit, яка друкує 28 вересня 2026.