Files
orchestrator/onboarding/repo-skeleton/docs/PIPELINE.md
claude-bot dc1cb87818 feat(onboarding): turnkey project onboarding — kit + CLI + runbook (ORCH-009)
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>
2026-06-10 16:08:43 +03:00

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.