
Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving.
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
--- name: knowledge-db description: Работа с базой знаний knowledge-db. Структура узлов, создание записей. Путь к базе: {{DATA_PATH}} --- # База знаний knowledge-db При работе с базой знаний используй структуру узлов и правила ниже. ## Путь к базе Путь к корню базы: **{{DATA_PATH}}** ## Структура узла Каждый узел (статья, заметка) — папка с главным файлом `{имя-папки}.md` (формат Obsidian): | Элемент | Назначение | |---------|------------| | `{dirname}.md` | Главный файл: YAML frontmatter
Правила и лучшие практики для Go-кода backend (cmd/kb-server, cmd/kb-cli, internal/). Используй при работе с internal/**/*.go, cmd/**/*.go.
Структура backend knowledge-db (cmd/, internal/). Используй при добавлении handlers, пакетов internal/, работе с kb и ingestion.
Валидация данных в Go с github.com/muonsoft/validation. Используй при проверке входных данных, доменных моделей.
Тестирование на Go — API-тесты (muonsoft/api-testing), unit-тесты. Arrange–Act–Assert. Используй при написании тестов для internal/ и cmd/.
Контекстное логирование в Go с github.com/muonsoft/clog. Используй при добавлении логов, работе с контекстным логгером в internal/ и cmd/.
Работа с ошибками в Go (github.com/muonsoft/errors). Sentinel-ошибки, обёртывание, атрибуты, маппинг в HTTP.
Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.
Continue working on an OpenSpec change by creating the next artifact. Use when the user wants to progress their change, create the next artifact, or continue their workflow.
Archive multiple completed changes at once. Use when archiving several parallel changes.
Frontend web/ (React, TypeScript, Vite). Используй при работе с web/src/**/*.tsx, web/src/**/*.ts.
Регистрация фоновых процессов через pior/runnable. Используй при добавлении Telegram bot и других воркеров в kb-server.
Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.
Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.
Fast-forward through OpenSpec artifact creation. Use when the user wants to quickly create all artifacts needed for implementation without stepping through each one individually.
Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
Knowledge base layout and node format for knowledge-db. Use when creating or editing KB markdown files. Root path placeholder {{DATA_PATH}}.