claude-bot
dc1cb87818
Operator capability to bring a NEW project online in one pass, fully
outside the runtime and the pipeline (src/** byte-exact, no kill-switch
needed — activation is an explicit human CLI run). Reference = the
orchestrator repo itself (ORCH-52b/c/d/e canons).
* onboarding/repo-skeleton/ — parametrized kit of a new repo: 6 agent
prompt templates per canon 52d/92 (5 ru + deployer en with the
shared-host guardrail frame), reviewer doc-gate (REQUEST_CHANGES),
CLAUDE.md passport, AGENTS.md, CONTRIBUTING.md, docs/ skeleton with
mandatory operations/INFRA.md, .env.example; {{NAME}} placeholders +
stdlib render, dictionary onboarding/placeholders.json (bijection
held by tests). Canon is NOT forked: docs/_templates + docs/_standards
are live-copied from the checkout at materialization time (BR-2/D3).
* scripts/onboard_project.py — plan (default, GET-only, zero mutations)
/ apply (idempotent ensure, no delete ops at all) / verify (registry
round-trip via the actual projects._parse_projects_json, all 22 state
names incl. fail-closed Confirm Deploy/STOP, labels, webhook, kit
completeness, unresolved-placeholder scan). Closed read-only src
import list (ADR D4); state groups fixed per ADR D5 (STOP→cancelled,
terminal groups only Done/Cancelled/STOP); Gitea webhook reuses the
single global ORCH_GITEA_WEBHOOK_SECRET (TR-6); initial push ONLY
into a freshly created empty repo (INV-4 untouched); never restarts
prod / never edits .env / deletes nothing (NFR-2); secrets masked
(NFR-3); Plane CE API gaps degrade to manual-step (fail-safe).
* docs/operations/ONBOARDING.md runbook + SETUP_WEBHOOKS.md generalized
per-repo; CLAUDE.md / docs/architecture/README.md / CHANGELOG.md
updated in the same PR (golden source).
* Anti-drift tests: test_onboarding_kit.py / test_onboarding_script.py
(mocked, no network) / test_onboarding_invariants.py (snapshots of
STAGE_TRANSITIONS/QG_CHECKS, closed CLI import list, reference
.openclaw/agents/ prompts untouched). Full regression: 1713 passed.
Refs: ORCH-009
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# {{PROJECT_NAME}}
|
||
|
||
{{PROJECT_DESCRIPTION}}
|
||
|
||
Репозиторий: `{{GITEA_OWNER}}/{{REPO}}` · Стек: {{STACK}}
|
||
|
||
## Quickstart
|
||
|
||
```bash
|
||
# тесты
|
||
{{TEST_CMD}}
|
||
```
|
||
|
||
Среды: prod — порт `{{PROD_PORT}}`, staging — порт `{{STAGING_PORT}}`
|
||
(топология и env — `docs/operations/INFRA.md`).
|
||
|
||
## Документация
|
||
|
||
| Документ | Что в нём |
|
||
|----------|-----------|
|
||
| `CLAUDE.md` | паспорт проекта: стек, команды, правила агентов |
|
||
| `AGENTS.md` | карта документации и правила её ведения |
|
||
| `CONTRIBUTING.md` | канон процесса: ветки, коммиты, PR, доки |
|
||
| `docs/ARCHITECTURE.md` | код-карта, потоки, БД |
|
||
| `docs/PIPELINE.md` | конвейер стадий, Quality Gates, агенты |
|
||
| `docs/PRODUCT_VISION.md` | зачем проект |
|
||
| `docs/operations/INFRA.md` | топология, env-карта, границы доступа |
|
||
| `CHANGELOG.md` | история изменений |
|
||
|
||
## Как ведётся проект
|
||
|
||
Проект ведёт мульти-агентный конвейер (Plane → стадии → Quality Gates → PR в Gitea); правила и
|
||
артефакты — `docs/PIPELINE.md` и `docs/_standards/PIPELINE_DOCS.md`. Изменения едут ветками
|
||
`feature/{{WORK_ITEM_PREFIX}}-NNN-slug` с Conventional Commits; документация обновляется в том же
|
||
PR, что и код.
|
||
|
||
## Известные ограничения
|
||
|
||
- (заполняется по мере жизни проекта; пункт снимается PR-ом, который его закрыл)
|