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>
{{PROJECT_NAME}}
{{PROJECT_DESCRIPTION}}
Репозиторий: {{GITEA_OWNER}}/{{REPO}} · Стек: {{STACK}}
Quickstart
# тесты
{{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-ом, который его закрыл)