/project-onboard

name: project-onboard
description: Primary project onboarding for Claude Lane Stack. Diátaxis-classified LLM pack (MODULE_MAP, API_SURFACE, TEST_INDEX, TAXONOMY, RUNBOOK, Google DESIGN.md). Schemas + validation in references/. Weekly docs-maintainer. Use when: /project-onboard, онбординг, init project, bootstrap CLAUDE.md, deep onboard, wiki→llm docs in the terminal Lane Stack; `$ARGUMENTS` exactly info prints the card. Not inside Lane Pilot chats (reference only).
argument-hint: "[info]"
user-invocable: false

Project onboard (Claude Lane Stack)

> **Inside a Lane Pilot chat** (`LANE_PILOT_AGENT_TYPE` set / tools `lane_pilot_*` present) this skill is reference only. Do not generate `docs/llm`, and do not write `docs/`, `CLAUDE.md`, `AGENTS.md` or `llms.txt` unless the owner asked for that in this chat (Lane Pilot's nightly docs pass owns `docs/` and builds `docs/index.md`; the onboarding preview accepts only `docs/**.md` and `apps/**.md`). Orient the owner from `PROJECT.md` → `docs/index.md` and answer in Russian. The pipeline below is the terminal Lane Stack harness.

Info

If `$ARGUMENTS` is exactly `info`, print `references/info.md` verbatim (Russian), then stop. Do not start onboard.

Who runs it

| Role | How | |------|-----| | **One-shot CLI** | `project-onboard .` (detect + seed + Codex/Cursor fill) | | **Default writer** | **Codex** (`stages.onboard` from adoc) | | Instructions | `~/.agents/codex/instructions/onboard.md` | | Model / effort / fast | **adoc** `stages.onboard` | | Weekly refresh | `docs-maintainer` (`ONBOARD_REFRESH=weekly`) | | Existing UI, no DESIGN.md | `design-lead` (skill `project-design`) — extract, do not re-onboard |

Default CLI = full pipeline. `--seed-only` = stubs without model. Do **not** use Grok.

References (load before filling)

| Ref | What | |-----|------| | [references/PACK-SCHEMAS.md](references/PACK-SCHEMAS.md) | Author every file (Diátaxis + schemas) | | [references/VALIDATION.md](references/VALIDATION.md) | Shell + acceptance; refuse `complete` | | [references/design-md-standard.md](references/design-md-standard.md) | Full `@google/design.md` canon | | https://diataxis.fr/ | Tutorial / how-to / reference / explanation | | https://agents.md/ · https://llmstxt.org/ | Agent entry + curated index |

**Classifier file in every project:** `docs/llm/TAXONOMY.yaml` We **omit tutorials** from the LLM pack.

Pack summary

| File | Diátaxis | Load | |------|----------|------| | CLAUDE / AGENTS | how-to | always | | `apps/*/CLAUDE.md` + `apps/*/docs/` | how-to + reference | on_demand (per-app pack, phase4b) | | llms.txt / INDEX | reference | always | | TAXONOMY / MODULE_MAP / API_SURFACE / TEST_INDEX | reference | on_demand | | ARCHITECTURE / FLOWS / gotchas / ADR | explanation | on_demand | | RUNBOOK / TESTING / deployment | how-to | on_demand | | DESIGN (`has_ui`) | reference | on_demand |

Deep pipeline

Phase0 seed
  → Pass A (model): Phase1–4 root pack
  → Host: onboard_app_packs prepare (skeletons + project API_SURFACE → apps/*)
  → Pass B (model): Phase4b fill each apps/* + Phase5
  → Host: VALIDATION gate (fail thin/catch-all packs)
  → report

Deep monorepo (≥2 apps) uses this **two-pass pipeline**. Toy/single-app stays single-pass.

Signals

| Signal | Extra files | |--------|-------------| | `has_ui` | `docs/DESIGN.md` (Google format) | | `has_deploy` / `signals.deploy` | `docs/RUNBOOK.md` |

Procedure (PM, terminal)

1. Passport thin: spawn **project-onboarder** (or `project-onboard`). Wait `DONE`. 2. If `stages.docs.enabled`: then spawn **docs-maintainer**. Never both at once. 3. Writer reads skill `references/`. 4. After: RU summary — surfaces, modules, tests, DESIGN?, RUNBOOK?, validation.

After checklist

• [ ] PACK-SCHEMAS followed
• [ ] VALIDATION green or GAPS listed
• [ ] TAXONOMY / API_SURFACE / MODULE_MAP / TEST_INDEX real
• [ ] MODULE_MAP covers apps (+ runners/hot libs) or GAPS
• [ ] Phase4b: each `apps/*` walked → **filled** local CLAUDE + docs/ (not stubs; surfaces projected/split)
• [ ] Webhooks split per provider; auth unknown ≤40%
• [ ] MANIFEST always_load lean (CLAUDE/AGENTS/INDEX only)
• [ ] decisions.md 3–5 evidenced ADRs (deep full) or GAPS
• [ ] FLOWS notification includes stream handler + queue consumer when present
• [ ] has_ui ⇒ DESIGN Google format
• [ ] has_deploy ⇒ RUNBOOK
• [ ] phase artifacts + report under `.agents/runs/_onboard/artifacts/001`
• [ ] MANIFEST weekly refresh