Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 68 additions & 9 deletions docs/architecture/rfcs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,8 +60,11 @@ Within an RFC, keep the same separation:
- a decision log records explicit approval and the sections it changed;
- an evidence registry maps claims to reproducible, public-safe proof.

Do not append progress reports to a normative delivery plan. Move long ledgers
to a linked `*-execution.md` companion. Schema reduction is never an incidental
Do not append progress reports to a normative delivery plan. Dated checkpoint
logs live in [`ledger/<rfc-slug>/`](ledger/README.md), one entry per date and
slice, with the RFC body keeping only a pointer; a heading containing
`checkpoint` inside an RFC body fails the docs governance smoke. Schema
reduction is never an incidental
cleanup: the RFC or PR must name each removed field, document producer/reader/
writer and compatibility research, define migration and rollback, prove the
claimed semantic equivalence, and record explicit maintainer approval.
Expand All @@ -70,11 +73,38 @@ This index was last audited against `main` on **2026-09-04**. Update an entry
whenever its RFC status, promoted behavior, or meaningful delivery boundary
changes.

### Lifecycle index and supersession

[`STATUS.md`](STATUS.md) ([中文版](STATUS.zh-CN.md)) is the generated
lifecycle index. It groups every RFC into `Accepted`, `Active` (`Draft`,
`Under review`), `Superseded` and `Retired` (`Retired`, `Rejected`) from the
status header inside each RFC, cross-checked against the status line in this
README. Regenerate it with `python3 scripts/generate_rfc_status_index.py
--write`; `--check` fails when the file is stale or when any RFC violates the
rules below, and the docs governance smoke runs that check.

- Every RFC header carries `**RFC status:**` whose value begins with one
lifecycle state. A descriptive tail has to follow a delimiter (`,`, `;`, `:`,
`(` or `—`): `Draft, under maintainer review`, not `Drafting notes`. The
README entry for the same RFC repeats the state and is cross-checked against
the header, so changing a state means editing both.
- `**Supersedes / closes:**` names the RFCs this one replaces or closes, or
`none`. A named RFC has to exist, has to be marked `Superseded`, and has to
point back with `**Superseded by:**`; that successor must in turn name this
RFC in its own `Supersedes / closes`. `Superseded by: none` is not a
supersession. A new RFC cannot land without the declaration; every current
RFC carries `none`.
- The Chinese mirror carries the same `**替代 / 关闭:**` declaration.
- Dated delivery logs live in [`ledger/<rfc-slug>/`](ledger/README.md), not in
an RFC body: no dated log heading may appear above the first appendix. An
appendix may keep append-only dated history, and a normative heading may say
"checkpoint" as long as it carries no date.

## Overall Product and Delivery Roadmap

- [LoopX Overall Roadmap v0](loopx-overall-roadmap-v0.md)
([中文版](loopx-overall-roadmap-v0.zh-CN.md))
- **RFC status:** Draft portfolio roadmap.
- **RFC status:** Draft, portfolio roadmap.
- **Delivery on `main`:** Planning and audit evidence, not runtime promotion.
- **Current boundary:** Maps all 30 pre-existing primary RFCs and important
non-RFC domains into 13 streams, G0–G5 product milestones and R1–R7 core
Expand Down Expand Up @@ -238,7 +268,7 @@ changes.
promotion remain open.
- [Obelisk Session Evidence Provider v0](obelisk-session-evidence-provider-v0.md)
([中文版](obelisk-session-evidence-provider-v0.zh-CN.md))
- **RFC status:** Draft integration proposal.
- **RFC status:** Draft, integration proposal.
- **Delivery on `main`:** Evaluation only.
- **Current boundary:** The default-off, read-only evidence-provider boundary
is documented. Obelisk is not installed, promoted, or authoritative for
Expand All @@ -259,10 +289,19 @@ changes.
Cross-session restoration, execution takeover and automatic return are specified
separately, reusing #4094 with optional Obelisk gap recall under its own scope.
Full runtime-profile qualification and generic handoff migration remain open.


- [Manager Runtime Profile v0](manager-runtime-profile-v0.md)
([中文版](manager-runtime-profile-v0.zh-CN.md))
- **RFC status:** Draft; M1 implementation candidate under the capable-manager RFC.
- **Delivery on `main`:** Partial; the explicit persistent `restricted` /
`trusted_owner` machine-level grant and its readback are the shipped slice
recorded by the parent RFC.
- **Current boundary:** Defines `manager_runtime_profile_v0` so that host
sandbox, prompt, managed workspace instructions, persistent configuration
and Session readback describe one effective mode. Qualification of the
profile as the default manager mode stays with the parent RFC.
- [Explicit Todo Continuation — Stage A](cross-session-memory-substrate-v0.md)
([中文版](cross-session-memory-substrate-v0.zh-CN.md))
- **RFC status:** Accepted; Stage A shipped, the historical filename is retained.
- **Delivery on `main`:** #4094 shipped the explicit local CLI and rich/legacy
continuation note with revision-guarded ownership adoption.
- **Current boundary:** Registered agents, same host/Goal, lease-free promoted
Expand All @@ -277,7 +316,7 @@ changes.
composition, and recoverable migration are proposed for #3930. A unified
`loopxd` service has not shipped.
- [Provider-Neutral Turn-Start Inbox Hook v0](provider-neutral-turn-start-inbox-hook-v0.md)
- **RFC status:** Implemented behind explicit provider configuration.
- **RFC status:** Accepted; implemented behind explicit provider configuration.
- **Delivery on `main`:** Implemented, opt-in.
- **Current boundary:** The provider-neutral turn-start read contract and
Lark ACK/replay path shipped in
Expand All @@ -304,6 +343,26 @@ changes.
pieces exist, but the unified execution-frontend/session-ownership contract
and cross-transport convergence are not accepted as one shipped product
boundary.
- [DSH / Pi: L1 Observation and Managed Runtime Selection](harness-selection-dsh-pi-v0.md)
([中文版](harness-selection-dsh-pi-v0.zh-CN.md))
- **RFC status:** Draft; evidence-backed implementation assessment, not a
runtime promotion.
- **Delivery on `main`:** Partial; the combined reliability-diagnostics
readback and the bounded managed Turn host default-host resolution shipped,
the steward channel transport and intake sections record dated increments.
- **Current boundary:** Keeps DSH as the first L1 event source and Pi as a
managed-runtime candidate; no quantitative winner is claimed and the
session-owning runtime role stays opt-in pending the C0/C1, overhead,
retention and Mode B evidence rows.
- [External Evidence Research Capability v0](external-evidence-research-capability-v0.md)
([中文版](external-evidence-research-capability-v0.zh-CN.md))
- **RFC status:** Draft, implementation slice.
- **Delivery on `main`:** Bounded slice; see the RFC acceptance section for
the audited state of the `external_evidence_research_v0` lifecycle.
- **Current boundary:** Provider-neutral research planning, provenance
admission, projection and retirement under one capability; a provider is
selectable only when readback says `declared`, `installed`, `enabled` and
`ready`. Product surfaces and TypeScript ownership are proposed, not promoted.
- [Agent Session Execution Modes v0](agent-session-execution-modes-v0.md)
([中文版](agent-session-execution-modes-v0.zh-CN.md))
- **RFC status:** Draft, under maintainer review.
Expand Down Expand Up @@ -351,7 +410,7 @@ changes.
living documents and governed amendment/settlement review remain open.
- [Live Team Workspace v0](live-team-workspace-v0.md)
([中文版](live-team-workspace-v0.zh-CN.md))
- **RFC status:** Draft presentation slice under intelligent presentation.
- **RFC status:** Draft, presentation slice under intelligent presentation.
- **Delivery on `main`:** Design proposal only; no live team-stream qualification.
- **Current boundary:** A command surface plus spatial research studio, evidence
handoff motion, conclusion revision and replay. L1 requires one real
Expand All @@ -369,7 +428,7 @@ changes.
## Benchmark And Reliability Engineering

- [Benchmark Study Upload and Dashboard Projection v0](benchmark-study-upload-dashboard-v0.md)
- **RFC status:** Draft integration proposal.
- **RFC status:** Draft, integration proposal.
- **Delivery on `main`:** Proposal only.
- **Current boundary:** Experiment-board rows and benchmark-native scores
remain authoritative; the study manifest, upload/readback envelope, and
Expand Down
74 changes: 74 additions & 0 deletions docs/architecture/rfcs/STATUS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# RFC Status Index

<!-- generated by scripts/generate_rfc_status_index.py; do not edit by hand -->

This index is derived from the status header of every RFC in this directory.
Change an RFC's state by editing its header and the matching `**RFC status:**`
line in the [README index](README.md), then run
`python3 scripts/generate_rfc_status_index.py --write`; `--check` fails while the
index is stale and `examples/docs-governance-smoke.py` runs it.

Lifecycle buckets: **Accepted**; **Active** (Draft, Under review);
**Superseded** (must name `Superseded by`); **Retired** (Retired, Rejected).
RFC status and delivery maturity are separate facts; delivery lives in the
[README index](README.md) `Delivery on main` lines. Every new RFC declares
`**Supersedes / closes:**` in its header (`none` or links to the RFCs it
replaces or closes). Dated delivery logs go to [ledger/](ledger/README.md); an
appendix may keep dated history, but no dated log heading may precede it.

[中文版](STATUS.zh-CN.md) is the semantic mirror of this file.

## Accepted (4)

| RFC | Header status | Supersedes / closes | Ledger |
| --- | --- | --- | --- |
| [RFC: Agent Loop Effect Interpreter](agent-loop-effect-interpreter-v0.md) | Accepted | none | — |
| [Explicit Todo continuation: Stage A](cross-session-memory-substrate-v0.md) | Accepted | none | — |
| [RFC: Provider-Neutral Turn-Start Inbox Hook v0](provider-neutral-turn-start-inbox-hook-v0.md) | Accepted | none | — |
| [RFC: TypeScript Control-Plane Migration Direction v0](typescript-control-plane-migration-v0.md) | Accepted | none | [12 entries](ledger/typescript-control-plane-migration-v0/) |

## Active (33)

| RFC | Header status | Supersedes / closes | Ledger |
| --- | --- | --- | --- |
| [RFC: Agent IM, LoopX, And OpenViking Collaboration v0](agent-im-openviking-collaboration-v0.md) | Draft | none | — |
| [RFC: Agent Session Execution Modes (v0)](agent-session-execution-modes-v0.md) | Draft | none | — |
| [RFC: Automatic Execution Admission (v0)](automatic-execution-admission-v0.md) | Draft | none | — |
| [RFC: Benchmark Study Upload and Dashboard Projection v0](benchmark-study-upload-dashboard-v0.md) | Draft | none | — |
| [RFC: Capable Agent Manager and Semantic Work Handoff (v0)](capable-manager-semantic-handoff-v0.md) | Draft | none | [1 entry](ledger/capable-manager-semantic-handoff-v0/) |
| [RFC: LoopX Desktop Execution Frontends v0](desktop-execution-frontends-v0.md) | Draft | none | — |
| [RFC: External Evidence Research Capability v0](external-evidence-research-capability-v0.md) | Draft | none | — |
| [RFC: Frontier Science Research Program v0](frontier-science-research-program-v0.md) | Draft | none | — |
| [RFC: Goal Artifact Lifecycle Projection (milestone / guard / next-transition) v0](goal-artifact-lifecycle-projection-v0.md) | Draft | none | — |
| [RFC: Goal Channel Collaboration v0](goal-channel-collaboration-v0.md) | Draft | none | — |
| [RFC: Goal Direction Baseline (v0)](goal-direction-baseline-v0.md) | Draft | none | — |
| [Goal Instance Identity and Orphan Recovery (v0)](goal-instance-identity-and-orphan-recovery-v0.md) | Draft | none | — |
| [RFC: Goal-scoped Capability Portfolio and Connector Lifecycle (v0)](goal-scoped-capability-portfolio-v0.md) | Draft | none | — |
| [RFC: Per-Goal Usage, Token, and Cost Surfacing v0](goal-usage-token-cost-v0.md) | Draft | none | — |
| [DSH / Pi: L1 Observation and Managed Runtime Selection](harness-selection-dsh-pi-v0.md) | Draft | none | — |
| [RFC: Hierarchical Agent Stride Control v0](hierarchical-agent-stride-control-v0.md) | Draft | none | — |
| [RFC: Human Attention Wishlist v0](human-attention-wishlist-v0.md) | Draft | none | — |
| [RFC: Human-confirmed domain operations (v0)](human-confirmed-domain-operations-v0.md) | Draft | none | — |
| [RFC: Intelligent Review and Dynamic Presentation Surfaces v0](intelligent-review-presentation-surfaces-v0.md) | Draft | none | — |
| [RFC: Live Team Workspace v0](live-team-workspace-v0.md) | Draft | none | — |
| [RFC: Long-Horizon Harness Benchmark and Research Program v0](long-horizon-harness-benchmark-research-program-v0.md) | Draft | none | — |
| [RFC: Long-Running Agent Reliability Diagnostics and Governed Delivery v0](long-running-agent-reliability-diagnostics-governed-delivery-v0.md) | Draft | none | — |
| [LoopX Overall Roadmap v0: Product, Collaboration, Technology and Delivery](loopx-overall-roadmap-v0.md) | Draft | none | — |
| [Manager runtime profile v0](manager-runtime-profile-v0.md) | Draft | none | — |
| [RFC: Obelisk Session Evidence Provider v0](obelisk-session-evidence-provider-v0.md) | Draft | none | — |
| [RFC: Agent Judgment and Optional Independent Assessment — Jev as a Candidate (v0)](optional-semantic-assistance-jev-v0.md) | Draft | none | — |
| [RFC: Post-Outcome Memory Utility Attribution v0](post-outcome-memory-utility-attribution-v0.md) | Draft | none | — |
| [RFC: Provider-Neutral Post-Writeback Capability Hooks v0](provider-neutral-post-writeback-capability-hooks-v0.md) | Draft | none | — |
| [RFC: Research Exploration Control Plane v0](research-exploration-control-plane-v0.md) | Draft | none | — |
| [RFC: Semantic Vocabulary Convergence and Commit-Time Drift Checks (v0)](semantic-vocabulary-convergence-v0.md) | Draft | none | [5 entries](ledger/semantic-vocabulary-convergence-v0/) |
| [RFC: Shared Goal Alignment and Governed Amendment Protocol (v0)](shared-goal-alignment-and-governed-amendment-v0.md) | Draft | none | [2 entries](ledger/shared-goal-alignment-and-governed-amendment-v0/) |
| [RFC: LoopX Shared Control-Plane Authority and Pluggable State Providers (v0)](shared-goal-authority-state-provider-v0.md) | Draft | none | [19 entries](ledger/shared-goal-authority-state-provider-v0/) |
| [RFC: Single-Owner Local Daemon (v0)](single-owner-local-daemon-v0.md) | Draft | none | — |

## Superseded (0)

_none_

## Retired (0)

_none_
Loading
Loading