# Openspec Proposal

> Этот скилл MUST быть вызван когда нужна формальная спецификация изменения: scaffold proposal.md, tasks.md, design.md и spec deltas. SHOULD также вызывать для архитектурных или сквозных изменений, требующих формального отслеживания. Do NOT использовать для быстрого обсуждения идей — используй brainstorm; для только декомпозиции задач — используй write-plan.

- Skill: `arman-kudaibergenov/openspec-proposal` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arman-kudaibergenov/openspec-proposal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arman-kudaibergenov/openspec-proposal/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: arman-kudaibergenov (https://skillmd.com/u/arman-kudaibergenov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/arman-kudaibergenov/openspec-proposal

---


# /openspec-proposal — Создание предложения изменения

**Guardrails**
- Минимальные реализации — добавляй сложность только когда запрошено
- Строго в рамках запрошенного результата
- Читай `openspec/AGENTS.md` для соглашений OpenSpec
- Выявляй неясности и задавай уточняющие вопросы ДО редактирования файлов
- НЕ пиши код на этапе proposal. Только документы (proposal.md, tasks.md, design.md, spec deltas)

**Steps**
1. Прочитай `openspec/project.md`, проверь `openspec/changes/` и `openspec/specs/`, изучи связанный код через Grep/Glob
2. Выбери уникальный `change-id` (глагол-существительное) и создай scaffold в `openspec/changes/<id>/`:
   - `proposal.md` — что, зачем, влияние
   - `tasks.md` — упорядоченный чеклист задач
   - `design.md` — архитектурные решения (если нужно)
3. Маппинг изменения в конкретные capabilities, разбей на spec deltas
4. Draft spec deltas в `changes/<id>/specs/<capability>/spec.md`:
   - Используй `## ADDED|MODIFIED|REMOVED Requirements`
   - Минимум один `#### Scenario:` на каждый requirement
5. Draft `tasks.md` — упорядоченный список верифицируемых задач
6. Валидируй через `openspec validate <id> --strict` (если CLI доступен) или ручная проверка

**Reference**
- Поиск существующих requirements: `Grep "Requirement:|Scenario:" openspec/specs/`
- Изучай кодовую базу через Grep/Glob для alignment с текущей реализацией