крупное обновление документации

This commit is contained in:
2026-07-10 18:15:05 +04:00
parent 01953cc25e
commit 0eef72a2c2
28 changed files with 2435 additions and 6 deletions
+14
View File
@@ -0,0 +1,14 @@
# OpenWC Coordination
Основные правила находятся в [`../docs/TEAM_WORKFLOW.md`](../docs/TEAM_WORKFLOW.md).
Предпочтительно вести claims в issue и draft PR/MR общего Git forge. Каталог `claims/` — fallback, если issue tracker недоступен. Один claim — один файл; не использовать общий изменяемый board.
## Создание fallback claim
1. Скопировать [`TASK_TEMPLATE.md`](TASK_TEMPLATE.md) в `claims/<work-package-id>.md`.
2. Заполнить owner, lease, paths, contracts и tests.
3. Опубликовать claim до production edits.
4. После интеграции заменить состояние на `accepted` или удалить claim отдельным coordination commit, сохранив историю в Git.
Claim-файлы не заменяют target Evidence и не меняют milestone status.
+66
View File
@@ -0,0 +1,66 @@
# <WORK-PACKAGE-ID> — <Title>
<!-- OPENWC_CLAIM:<WORK-PACKAGE-ID>:<AGENT-ID>:<YYYY-MM-DD> -->
## Ownership
- Target:
- Program:
- Owner/Agent ID:
- Branch:
- Lease expires UTC:
- Integrator:
## Outcome
## Non-goals
## Paths
- Exclusive:
- Shared/hotspots:
- Generated/ignored:
## Contracts and data
- Public API/events:
- Schema/format version:
- Migration/compatibility:
- Consumers:
## Dependencies
- Requires:
- Blocks:
- External state:
## Verification
- Commands:
- Fixtures:
- Fidelity evidence:
- Performance budget:
## Documentation deliverables
- Inline public API docs:
- Module specification:
- Data-flow diagram:
- Sequence/state/dependency diagrams:
- Source map/status updates:
## Status
- State: claimed
- Done:
- Next:
- Blocked by:
## Handoff
- Commit:
- Results:
- Remaining risks:
- Documentation updated:
+5
View File
@@ -0,0 +1,5 @@
# Fallback claims
Этот каталог используется только когда общий issue/PR tracker недоступен. Каждый активный work package создаёт отдельный Markdown-файл по [`../TASK_TEMPLATE.md`](../TASK_TEMPLATE.md).
Файл без валидного `OPENWC_CLAIM` marker не считается claim. Не хранить здесь secrets, credentials, proprietary data или большие логи.