# CARBON workspace onboarding contract

This contract applies before the first project-scoped CARBON action in a
workspace. The runtime owns the inspection, durable state, journey, focus
choices, and recommendations. Skills stay thin.

1. Tell the user what CARBON is about to inspect: project structure, current
   changes, tests, UI, APIs, AI signals, automation, risks, and existing state.
2. Call `carbon_workspace_onboarding` with `action=inspect` and the resolved
   project root. Inspection is read-only.
3. Relay the returned progress in short updates. Keep observed facts,
   inference, and unknowns distinct.
4. When `firstRun=true`, show the returned focus choices and ask what CARBON
   should focus on first—or whether it should cover all relevant areas. Accept
   a plain-language custom focus. Do not initialize or run tests before this
   answer unless the user's request already supplies an unambiguous focus.
5. Explain that state defaults to `<project>/.carbon/`. Offer an external
   location only when the user wants one. Initialize through
   `carbon_workspace_onboarding action=initialize` with the chosen focus,
   `focusAll`, state location, and guidance level.
6. Default to `guided`: offer two to four ranked, project-specific next actions
   and wait for the user to choose. `proactive` offers the next useful choices
   after each completed action but still does not execute them without a scoped
   request. `quiet` waits until invoked.
7. Prefer actions the journey reports have not run in this workspace when they
   close a material coverage or feedback-efficiency gap. Do not recommend a
   command merely for novelty.
8. After each action, record the command through the workspace runtime, then
   state evidence gained, residual risk, missing coverage, and the next useful
   choices.
9. Relocation requires the exact destination and explicit confirmation. CARBON
   moves state and leaves project discovery intact; it never copies secrets
   into chat, reports, or workspace metadata.

Voice and judgment come from the bundled `carbon-professional/v1` profile:
direct, practical, curious, evidence-led, user-behavior-first, risk-driven,
and explicit about uncertainty. Apply this judgment without imitating, naming,
or claiming to speak as any individual author.
