# RFCs

This directory holds CCD architecture decision records, captured as RFCs following the convention shared with the [`pituitary`](https://github.com/dusk-network/pituitary/tree/main/docs/rfcs) project, with three CCD-specific extensions (draft status, explicit supersession, and a consequences section). Those extensions are proposed upstream in [pituitary#318](https://github.com/dusk-network/pituitary/issues/318); if adopted there, the two projects stay in sync.

## Conventions

- **Filename:** `NNNN-short-slug.md`. Zero-padded four-digit number; numbers are unique and frozen once assigned.
- **Required sections:**
  - `## Status` — `Accepted`, `Proposed`, `Draft`, or `Superseded by: RFC NNNN (<path>)`
  - `## Date` — YYYY-MM-DD of the decision, not the last edit
  - `## Related` — links to issues and sibling RFCs
  - `## Summary`
  - `## Context`
  - `## Options Considered` (when genuine alternatives existed)
  - `## Decision`
  - `## Consequences`
- **Supersession:** once an RFC lands on `main`, do not delete it. Set `## Status` to `Superseded by: RFC NNNN (<path>)` and keep the file so readers of the old RFC have a forward pointer.

## Index

### Accepted

- [RFC 0001 · Continuity Threads and Channels](0001-continuity-threads-and-channels.md) — Immortal threads as umbrella; 5-item kernel-center list; recall adapters and automatic session renewal as supporting kernel.
- [RFC 0002 · Backlog Extraction to `ccd-extensions`](0002-backlog-extraction-to-ccd-extensions.md) — CCD core reduced to the continuity kernel; backlog ships from a sibling repo.
- [RFC 0003 · Threads as First-Class](0003-threads-as-first-class.md) — continuity thread promoted from emergent concept to a named, addressable kernel artifact with identity, lifecycle, and resumption semantics.

### Draft

- [RFC 0004 · Automatic Session Renewal](0004-automatic-session-renewal.md) — kernel-side design for the renewal loop sketched in RFC 0001: `renew` signal on `session_boundary`, heartbeat and renewal leases, two-phase kernel primitive with single-action realization.
- [RFC 0005 · Shared Continuity Snapshot](0005-shared-continuity-snapshot.md) — portable snapshot artifact and minimum-viable file-based transport for moving a continuity thread between machines; closes the machine-locality pointer from RFC 0003 §2.
- [RFC 0006 · Pod Layer Collapse](0006-pod-layer-collapse.md) — retire the pod layer; collapse policy into profile, delete pod-memory ceremony outright, relocate machine identity and presence one step flatter; compat-alias window and non-destructive migration tool.

### Superseded

_none yet_
