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>
2.6 KiB
PIPELINE — конвейер проекта {{PROJECT_NAME}}
Как задача проходит от идеи до прода. Управляет конвейером оркестратор; этот файл — карта процесса для агентов и людей проекта.
Стадии
created → analysis → architecture → development → review → testing → deploy-staging → deploy → done
↑ │
└──── REQUEST_CHANGES ──────┘ (откат на development)
| Стадия | Агент | Выходной артефакт | Гейт выхода |
|---|---|---|---|
| analysis | analyst | 01-brd.md, 02-trz.md, 03-acceptance-criteria.md, 04-test-plan.yaml |
полнота пакета + человеческий approve |
| architecture | architect | 06-adr/ADR-NNN-slug.md (+ 07/08/10) |
ADR записан |
| development | developer | код + тесты + PR + CHANGELOG.md |
зелёный CI на ветке |
| review | reviewer | 12-review.md (verdict: APPROVED|REQUEST_CHANGES) |
машинный вердикт |
| testing | tester | 13-test-report.md (result: PASS|FAIL) |
машинный вердикт |
| deploy-staging | deployer | 15-staging-log.md (staging_status: SUCCESS|FAILED) |
машинный вердикт |
| deploy | deployer | 14-deploy-log.md (deploy_status: SUCCESS|FAILED) |
машинный вердикт |
Машинные вердикты — строго YAML-frontmatter; имена/регистр ключей не менять. Полная спека
«стадия → обязательный выход» — docs/_standards/HANDOFF_PROTOCOL.md; структура каждого
документа — docs/_standards/PIPELINE_DOCS.md; скелеты — docs/_templates/.
Агенты
Промпты 6 ролей — .openclaw/agents/{analyst,architect,developer,reviewer,tester,deployer}.md.
Каждый промпт направляет агента: прочитай CLAUDE.md (паспорт) и AGENTS.md (карта доков)
ПЕРЕД работой; пиши артефакты в docs/work-items/<id>/; обновляй документацию в том же PR.
Артефакты задачи
Полный перечень номерных документов — паспорт CLAUDE.md, раздел «Артефакты задачи»;
канонический реестр и структура — docs/_standards/PIPELINE_DOCS.md.