core-hub/.claude/rules/first-session.md

27 lines
809 B
Markdown
Raw Normal View History

2026-06-27 08:22:42 +00:00
## First Session Protocol
2026-06-27 11:00:12 +02:00
Triggered when State Hub shows no workstreams for `core-hub`.
2026-06-27 08:22:42 +00:00
2026-06-27 11:00:12 +02:00
**Step 1 - Read, do not write yet**
- `INTENT.md`
- `SCOPE.md`
- `docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md`
- `docs/specs/README.md`
- Existing files under `workplans/`
2026-06-27 08:22:42 +00:00
2026-06-27 11:00:12 +02:00
**Step 2 - Survey in-progress work**
Look for untracked files, open workplans, and half-finished specs. Note done vs. started but incomplete.
2026-06-27 08:22:42 +00:00
2026-06-27 11:00:12 +02:00
**Step 3 - Structure work in files first**
Create or update `workplans/CORE-WP-NNNN-<slug>.md` before relying on State Hub records.
2026-06-27 08:22:42 +00:00
2026-06-27 11:00:12 +02:00
**Step 4 - Sync the read model**
After workplan changes, run from `~/state-hub`:
2026-06-27 08:22:42 +00:00
2026-06-27 11:00:12 +02:00
```bash
make fix-consistency REPO=core-hub
2026-06-27 08:22:42 +00:00
```
2026-06-27 11:00:12 +02:00
**Step 5 - Record progress**
Post a non-secret progress note to State Hub summarizing the setup or implementation work.