codex-bot
1fd7e6ad97
npm run validate: toolchain check, openspec schema validate, openspec validate --all --strict, lychee --offline --include-fragments for root *.md and openspec/specs. CI verify installs the pinned CLI and sha256-pinned lychee and runs it. Closes #2
39 lines
3.0 KiB
Markdown
39 lines
3.0 KiB
Markdown
# Specs
|
|
|
|
Репозиторий содержит существующие behavioral specifications и SDD history.
|
|
Для обычной разработки не создавай и не обновляй planning artifacts ради
|
|
процесса. До edits найди/создай подходящую Gitea Issue, проверь AC и ветку;
|
|
чтение допускается без Issue. Выбор lightweight/SDD — по
|
|
[Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/03b3b59e6ff2ba391f9dfc42a039a96d0d84c1c9/.ai/conventions/engineering-workflow.md)
|
|
(main#28; после merge — актуальная версия `develop`);
|
|
OpenSpec lifecycle начинается только после явного решения Change Owner.
|
|
|
|
Если нужна существующая behavioral spec, выбери точный target через
|
|
[AI_INDEX](AI_INDEX.md). Specs не являются вторым editable HTTP OpenAPI:
|
|
HTTP-провайдер публикует контракт, а потребитель получает отдельный artifact
|
|
и локально проверяет generated types. Specs фиксируют behavioral requirements;
|
|
другие checkout не нужны для чтения и native validation этого store.
|
|
|
|
Архивы и чужие active changes сохраняй. Для правки индекса или specs выполни
|
|
`npm run validate` (targets/anchors, native checks) и `git diff --check`;
|
|
application gates принадлежат affected repos.
|
|
Если явно запрошена работа через OpenSpec, следуй
|
|
[локальным инструкциям OpenSpec](README.md#начало-работы)
|
|
и используй store `wealth-ledger-specs`. Перед Node-командами активируй
|
|
местную `.nvmrc`: если `nvm` не загружен в non-interactive shell, загрузи
|
|
установленный `$HOME/.nvm/nvm.sh`, затем выполни `nvm use --silent` из specs.
|
|
Если `nvm.sh` недоступен, остановись; не используй системный Node.
|
|
|
|
## Ветки и релизы
|
|
|
|
Работа — в issue-linked ветке от `develop`, затем PR в `develop`; в `main` напрямую
|
|
не пушить. PR сливается squash или rebase-merge; merge-коммит не используется.
|
|
`main` обновляется только fast-forward из `develop`, поэтому `origin/main`
|
|
всегда предок `origin/develop`:
|
|
`git merge-base --is-ancestor origin/main origin/develop`. Срочный fix —
|
|
обычная ветка `fix/*` от `develop`; пути hotfix от `main` нет.
|
|
Релиз — по [README](README.md#релизы).
|
|
Commits и заголовки PR — Conventional Commits со ссылкой на Issue (кроме release);
|
|
для спецификаций допустим `spec:`.
|
|
Перед подготовкой релиза прочитай местный README; версии вручную не повышать.
|