Создание спецификации

Ваша цель — создать новый файл спецификации для ${input:SpecPurpose}.

Файл спецификации должен определять требования, ограничения и интерфейсы компонентов решения ясно, однозначно и структурированно для эффективного использования генеративными ИИ. Следуйте устоявшимся стандартам документации и обеспечьте машиночитаемость и самодостаточность.

Лучшие практики для AI-ready спецификаций

• Используйте точный, явный и однозначный язык.
• Чётко разделяйте требования, ограничения и рекомендации.
• Используйте структурированное форматирование (заголовки, списки, таблицы) для лёгкого парсинга.
• Избегайте идиом, метафор и контекстно-зависимых отсылок.
• Определяйте все аббревиатуры и доменные термины.
• Включайте примеры и краевые случаи, где применимо.
• Документ должен быть самодостаточным и не зависеть от внешнего контекста.

Спецификацию следует сохранять в каталоге /spec/ с именем по соглашению: spec-[a-z0-9-]+.md, где имя описательно и начинается с высокоуровневой цели — одной из [schema, tool, data, infrastructure, process, architecture, design].

Файл спецификации должен быть в корректном Markdown и следовать шаблону ниже, заполняя все секции. Фронтматтер должен быть оформлен как в примере:

---
title: [Concise Title Describing the Specification's Focus]
version: [Optional: e.g., 1.0, Date]
date_created: [YYYY-MM-DD]
last_updated: [Optional: YYYY-MM-DD]
owner: [Optional: Team/Individual responsible for this spec]
tags: [Optional: List of relevant tags or categories]
---

# Introduction
[A short concise introduction to the specification and the goal it is intended to achieve.]

## 1. Purpose & Scope
## 2. Definitions
## 3. Requirements, Constraints & Guidelines
- **REQ-001**: Requirement 1
- **SEC-001**: Security Requirement 1
- **CON-001**: Constraint 1
- **GUD-001**: Guideline 1
- **PAT-001**: Pattern to follow 1

## 4. Interfaces & Data Contracts
## 5. Acceptance Criteria
- **AC-001**: Given [context], When [action], Then [expected outcome]

## 6. Test Automation Strategy
## 7. Rationale & Context
## 8. Dependencies & External Integrations
## 9. Examples & Edge Cases
## 10. Validation Criteria
## 11. Related Specifications / Further Reading
---

Ключевые разделы шаблона (по идентификаторам): требования (REQ/SEC/CON/GUD/PAT), интерфейсы и контракты данных, критерии приёмки (AC в формате Given-When-Then), стратегия автотестирования (уровни Unit/Integration/E2E; фреймворки MSTest, FluentAssertions, Moq для .NET; CI/CD в GitHub Actions; пороги покрытия), обоснование и контекст, зависимости и внешние интеграции (EXT/SVC/INF/DAT/PLT/COM — фокус на «что», а не «как»; указывайте «библиотека OAuth 2.0», а не конкретный пакет), примеры и краевые случаи, критерии валидации, связанные спецификации.