repo-scoping/.claude/rules/first-session.md

First Session Protocol

Triggered when get_domain_summary("capabilities") shows no workstreams. The project is registered but work has not yet been structured.

Step 1 — Read, don't write

• ~/the-custodian/canon/projects/capabilities/project_charter_v0.1.md — purpose, scope
• ~/the-custodian/canon/projects/capabilities/roadmap_v0.1.md — planned phases
• Scan repo root: README, directory structure, existing code or docs

Step 2 — Survey in-progress work Look for TODOs, open branches, half-finished files. Note done vs. started but incomplete.

Step 3 — Propose workstreams to Bernd Propose 1–3 workstreams — each a coherent strand, weeks to months, anchored to a roadmap phase. Wait for approval before creating.

Step 4 — Create workplan file first, then DB record (ADR-001)

workplans/repo-scoping-WP-NNNN-<slug>.md   ← write this first

Then register in the hub:

create_workstream(topic_id="64418556-3206-457a-ba29-6884b5b12cf3", title="...", owner="...", description="...")
create_task(workstream_id="<id>", title="...", priority="high|medium|low")

Step 5 — Record the setup

add_progress_event(
    summary="First session: structured capabilities into N workstreams, M tasks",
    event_type="milestone",
    topic_id="64418556-3206-457a-ba29-6884b5b12cf3",
    detail={"workstreams": [...], "tasks_created": M}
)