@x0rium/devkit-cli 0.5.0 → 0.6.0

package/skills/spec-kit/README.md

@@ -0,0 +1,139 @@
+# SpecKit
+
+> Уровень 4. "Строим."
+
+---
+
+## Отношение к github/spec-kit
+
+DevKit использует оригинальный [github/spec-kit](https://github.com/github/spec-kit) без изменений. SpecKit в контексте DevKit — это уровень 4 который получает на вход верифицированные артефакты из ArchKit.
+
+Разница с использованием spec-kit напрямую:
+
+```
+Без DevKit:
+  разработчик пишет constitution.md вручную
+  AI додумывает архитектуру сам
+  хитрит потому что нет доказанного основания
+
+С DevKit:
+  constitution.md генерируется из invariants.md + decisions/
+  AI работает в рамках верифицированной архитектуры
+  отклонение от инвариантов — блокер, не молчаливое изменение
+```
+
+---
+
+## Входные артефакты
+
+SpecKit получает из ArchKit:
+
+```
+.devkit/arch/constitution.md  →  .specify/constitution.md
+.devkit/arch/invariants.md    →  контекст для всех спек
+.devkit/arch/impact.md        →  используется при эскалации
+.devkit/product/ux_invariants.md → часть constitution
+```
+
+---
+
+## Стандартный флоу (github/spec-kit)
+
+```
+/constitution   ← не писать вручную, брать из ArchKit
+/specify        ← описание фичи
+/clarify        ← уточнение до планирования
+/plan           ← технический план
+/tasks          ← разбивка на задачи
+/analyze        ← проверка согласованности
+/implement      ← реализация
+```
+
+---
+
+## Детектор событий
+
+В процессе работы в SpecKit AI отслеживает триггеры и эскалирует:
+
+### Триггер RFC
+Разработчик упоминает новое требование которое меняет инварианты.
+
+```
+Паттерны:
+  "нам ещё нужно..."
+  "а что если добавить..."
+  "заказчик попросил..."
+
+Реакция AI:
+  "Это затрагивает инвариант [I_N] из invariants.md.
+   Предлагаю RFC перед продолжением. /arch rfc?"
+```
+
+### Триггер Investigation
+Технический блокер в процессе реализации.
+
+```
+Паттерны:
+  "либа не поддерживает..."
+  "бенчмарк показал..."
+  "нашёл баг в..."
+  "это работает не так как ожидали..."
+
+Реакция AI:
+  "Это нарушает допущение из [ADR-N].
+   Нужен Investigation. /arch investigate?"
+```
+
+### Триггер Product Blocker
+UX проблема обнаруженная при реализации.
+
+```
+Паттерны:
+  "это неудобно использовать..."
+  "слишком много параметров..."
+  "пользователь не поймёт..."
+
+Реакция AI:
+  "Это нарушение UX инварианта [U_N].
+   Нужен ProductKit investigation. /product investigate?"
+```
+
+---
+
+## Структура спеки
+
+Каждая спека в DevKit контексте содержит дополнительный раздел:
+
+```markdown
+# Spec NNN: [название]
+
+## Invariants
+TECHNICAL: [какие инварианты из invariants.md затрагивает]
+UX: [какие UX инварианты из ux_invariants.md затрагивает]
+
+## Standard SpecKit content
+...
+
+## Deviation Guard
+Если реализация требует отклонения от инварианта — СТОП.
+Не реализовывать. Создать RFC.
+```
+
+---
+
+## Команды
+
+```
+/speckit init           ← инициализация из ArchKit артефактов
+/speckit sync           ← обновить constitution из ArchKit после RFC
+/speckit check-invariants ← проверить что спеки не нарушают инварианты
+
+# Стандартные команды github/spec-kit
+/constitution
+/specify
+/clarify
+/plan
+/tasks
+/analyze
+/implement
+```

package/skills/spec-kit/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: spec-kit
+description: DevKit Level 4. Use when architecture is verified and it's time to write specifications and implement features. Integrates with github/spec-kit workflow. Monitors conversation for architectural events (new requirements, technical blockers, UX problems) and escalates to the appropriate DevKit level automatically.
+license: MIT
+metadata:
+  author: devkit
+  version: "1.0"
+  layer: "4-of-5"
+  prev: arch-kit
+  next: qa-kit
+---
+
+# SpecKit — Level 4: "Build it."
+
+You are operating in SpecKit phase. Architecture is verified. You have a constitution.md. Now you build — using the github/spec-kit workflow as the implementation engine.
+
+## Your Role
+
+- Follow github/spec-kit methodology for specification and implementation
+- Monitor every developer message for escalation triggers
+- STOP and escalate before proceeding when triggers are detected
+- Never silently modify architecture within a spec
+
+## Constitution
+
+Before any spec work, confirm constitution.md exists at `.specify/constitution.md`.
+If it doesn't exist, stop and run: `/arch-kit generate-constitution`
+
+The constitution comes from ArchKit — do not edit it manually. It contains the verified invariants that all specs must respect.
+
+## Standard Workflow (github/spec-kit)
+
+```
+/constitution   — already generated by ArchKit, review only
+/specify        — describe the feature
+/clarify        — resolve ambiguities before planning
+/plan           — technical plan respecting invariants
+/tasks          — break into reviewable units
+/analyze        — check cross-spec consistency
+/implement      — generate code
+```
+
+## Invariant Guard
+
+Every spec must declare which invariants it touches:
+
+```markdown
+## Invariant Coverage
+TECHNICAL: [I1, I3] from .devkit/arch/invariants.md
+UX: [U2] from .devkit/product/ux_invariants.md
+```
+
+If implementation requires deviating from an invariant → STOP. Do not implement. Open RFC.
+
+## Event Detection — CRITICAL
+
+Monitor every developer message. Before continuing spec work, check for triggers.
+
+### RFC Trigger — New Requirement
+Patterns: "we also need", "add support for", "client wants", "what about", "can we also"
+
+Action:
+> "This sounds like a new requirement. Let me check if it touches our invariants.
+> [read .devkit/arch/invariants.md]
+> This affects invariant [I_N]. I need to open an RFC before continuing.
+> Estimated impact: [N specs affected]. Proceed with RFC? /arch-kit rfc"
+
+Do NOT continue spec work until RFC is resolved.
+
+### Investigation Trigger — Technical Blocker
+Patterns: "bug in library", "this doesn't support", "benchmark shows", "unexpected behavior", "doesn't work as expected", "performance issue"
+
+Action:
+> "This breaks an architectural assumption. Let me identify which one.
+> [read .devkit/arch/decisions/ADR-*.md]
+> This breaks the assumption in [ADR-N]. Opening Investigation.
+> /arch-kit investigate"
+
+Do NOT work around the blocker silently.
+
+### Product Blocker Trigger — UX Problem
+Patterns: "this is hard to use", "too many parameters", "confusing", "users won't get this", "awkward interface"
+
+Action:
+> "This looks like a UX invariant issue. Let me check.
+> [read .devkit/product/ux_invariants.md]
+> This conflicts with [U_N]. Escalating to ProductKit investigation."
+
+Do NOT continue with the current design.
+
+### No Trigger — Normal Work
+When none of the above apply: proceed with standard spec-kit workflow.
+
+## Spec Numbering
+
+Specs are numbered sequentially: spec_001, spec_002, etc.
+When specs are revised after an RFC, they keep their number and get revision suffix: spec_003_r1.
+
+## Handoff to QAKit
+
+After implementation of a feature or milestone:
+```
+IMPLEMENTATION COMPLETE
+SPECS: [list]
+INVARIANTS COVERED: [list]
+OPEN ITEMS: none / [list with owners]
+READY FOR: QAKit
+```