Skip to content

INDEX.md

Latest commit

 

History

History
342 lines (259 loc) · 24.1 KB

INDEX.md

File metadata and controls

342 lines (259 loc) · 24.1 KB
Raw

LifeOS Strategic Corpus [P26-02-28 (rev12)]

Last Updated: 2026-05-21 (rev35)

Authority: LifeOS Constitution v2.0

Authority Chain

LifeOS Constitution v2.0 (Supreme)
        │
        └── Governance Protocol v1.0
                │
                ├── COO Operating Contract v1.0
                ├── DAP v2.0
                └── COO Runtime Spec v1.0

Strategic Context

Document Purpose
LifeOS_Strategic_Corpus.md Derived context snapshot — useful for orientation; canonical repo docs and live GitHub evidence win on conflict

New Operator / AI Entry Chain

  1. ../README.md — current system map and authority warning.
  2. This index — authoritative documentation navigation.
  3. 08_manuals/LifeOS_Operator_Onboarding.md — operator roles, surfaces, and safe-start rules.
  4. LifeOS_Strategic_Corpus.md — derived high-context snapshot.
  5. 11_admin/LIFEOS_STATE.md — current focus, WIP, blockers, and state.
  6. 00_foundations/LifeOS Target Architecture v2.3c.md — current canonical target architecture.
  7. Root guidance files: CLAUDE.md, AGENTS.md, GEMINI.md.
  8. .context/REPO_MAP.md — repository map when present.

Agent Guidance (Root Level)

File Purpose
CLAUDE.md Claude Code (claude.ai/code) agent guidance
AGENTS.md OpenCode agent instructions (Doc Steward subset)
GEMINI.md Gemini agent constitution

00_admin — Project Admin (Thin Control Plane)

Canonical Files

Document Purpose
LIFEOS_STATE.md Single source of truth — Current focus, WIP, blockers, next actions (auto-updated)
BACKLOG.md Derived view — Human-readable summary (non-canonical; config/tasks/backlog.yaml is canonical queue authority)
DECISIONS.md Append-only — Decision log (low volume)
INBOX.md Raw capture scratchpad for triage
Plan_Supersession_Register.md Control — Canonical register of superseded and active plans
LifeOS_Build_Loop_Production_Plan_v2.1.md Canonical plan — Production readiness plan (per supersession register)
LifeOS_Master_Execution_Plan_v1.1.md (superseded by v2.1) — Historical master execution plan W0–W7
Doc_Freshness_Gate_Spec_v1.0.md Control — Runtime-backed doc freshness and contradiction gate spec
AUTONOMY_STATUS.md Derived view — Autonomy capability matrix (derived from canonical sources)
WIP_LOG.md WIP tracker — Work-in-progress log with controlled status enum
lifeos-master-operating-manual-v2.1.md Strategic context — Master Operating Manual v2.1
TECH_DEBT_INVENTORY.md Tech debt tracker — Structural debt items with explicit trigger conditions
QUALITY_AUDIT_BASELINE_v1.0.md Audit baseline — Repo-wide quality findings, evidence, and promotion recommendations
build_summaries/COO_Step6_LiveWiring_Build_Summary_2026-03-08.md COO Step 6 build summary — live wiring, shadow validation, gaps, workflow

Subdirectories

Directory Purpose Naming Rule
build_summaries/ Timestamped build evidence summaries *_Build_Summary_YYYY-MM-DD.md
archive/ Historical documents (reference only; immutable) Archive subdirs: YYYY-MM-DD_<topic>/

00_foundations — Core Principles

Document Purpose
LifeOS_Constitution_v2.0.md Supreme governing document — Raison d'être, invariants, principles
LifeOS Target Architecture v2.3c Current canonical target architecture — CEO→COO→EA control-plane, COO Commons, phased authority expansion
Agent_Roles_Reference_v1.0.md Orientation reference — actor taxonomy, COO autonomy levels, provider routing (non-authoritative; canon wins on conflict)
Anti_Failure_Operational_Packet_v0.1.md Anti-failure mechanisms, human preservation, workflow constraints
Architecture_Skeleton_v1.0.md High-level conceptual architecture (CEO/COO/Worker layers)
Tier_Definition_Spec_v1.1.md Canonical — Tier progression model, definitions, and capabilities
ARCH_Future_Build_Automation_Operating_Model_v0.2.md Architecture Proposal — Future Build Automation Operating Model v0.2
lifeos-agent-architecture.md Architecture — Non-canonical agent architecture
lifeos-maximum-vision.md Vision — Non-canonical maximum vision architecture

01_governance — Governance & Contracts

Core Governance

Document Purpose
COO_Operating_Contract_v1.0.md CEO/COO role boundaries and interaction rules
AgentConstitution_GEMINI_Template_v1.0.md Template for agent GEMINI.md files
DOC_STEWARD_Constitution_v1.0.md Document Steward constitutional boundaries

Council & Review

Document Purpose
Council_Invocation_Runtime_Binding_Spec_v1.1.md Council invocation and runtime binding
Antigravity_Council_Review_Packet_Spec_v1.0.md Council review packet format
ALIGNMENT_REVIEW_TEMPLATE_v1.0.md Monthly/quarterly alignment review template

Policies & Logs

Document Purpose
COO_Expectations_Log_v1.0.md Working preferences and behavioral refinements
Antigrav_Output_Hygiene_Policy_v0.1.md Output path rules for Antigravity
OpenCode_First_Stewardship_Policy_v1.1.md Mandatory OpenCode routing for in-envelope docs

Active Rulings

Document Purpose
Council_Ruling_OpenCode_DocSteward_CT2_Phase2_v1.1.md ACTIVE — OpenCode Document Steward CT-2 Phase 2 Activation
Council_Ruling_OpenCode_First_Stewardship_v1.1.md ACTIVE — OpenCode-First Doc Stewardship Adoption
Council_Ruling_Build_Handoff_v1.0.md Approved: Build Handoff Protocol v1.0 activation-canonical
Council_Ruling_Build_Loop_Architecture_v1.0.md ACTIVE: Build Loop Architecture v0.3 authorised for Phase 1
Council_Ruling_Phase9_Ops_Ratification_v1.0.md ACTIVE — Phase 9 constrained ops ratification for workspace_mutation_v1
Tier3_Reactive_Task_Layer_Council_Ruling_v0.1.md Active: Reactive Task Layer v0.1 Signoff
Council_Review_Stewardship_Runner_v1.0.md Approved: Stewardship Runner cleared for agent-triggered runs

Historical Rulings

Document Purpose
Tier1_Hardening_Council_Ruling_v0.1.md Historical: Tier-1 ratification ruling
Tier1_Tier2_Activation_Ruling_v0.2.md Historical: Tier-2 activation ruling
Tier1_Tier2_Conditions_Manifest_FP4x_v0.1.md Historical: Tier transition conditions
Tier2_Completion_Tier2.5_Activation_Ruling_v1.0.md Historical: Tier-2.5 activation ruling

02_protocols — Protocols & Agent Communication

Batch 1 Runtime Protocols

Note: The 5 Batch 1 runtime modules (run_lock, invocation_receipt, invocation_schema, shadow_runner, shadow_capture) do not yet have dedicated protocol docs in 02_protocols/. Their protocol definitions are captured in:

Document Coverage
LifeOS_Autonomous_Build_Loop_Architecture_v0.3.md Batch 1: run_lock, invocation_receipt, invocation_schema, shadow_runner, shadow_capture — autonomous build loop protocol definitions

Core Protocols

Document Purpose
Governance_Protocol_v1.0.md Envelopes, escalation rules, council model
Git_Workflow_Protocol_v1.1.md Fail-Closed: Branch conventions, CI proof merging, receipts
Document_Steward_Protocol_v1.1.md Document creation, indexing, GitHub/Drive sync
Deterministic_Artefact_Protocol_v2.0.md DAP — artefact creation, versioning, and storage rules
Build_Artifact_Protocol_v1.0.md NEW — Formal schemas/templates for Plans, Review Packets, Walkthroughs, etc.
Tier-2_API_Evolution_and_Versioning_Strategy_v1.0.md Tier-2 API Versioning, Deprecation, and Compatibility Rules
Build_Handoff_Protocol_v1.1.md Messaging & handoff architecture for agent coordination
Intent_Routing_Rule_v1.1.md Decision routing (CEO/CSO/Council/Runtime)
LifeOS_Design_Principles_Protocol_v1.1.md Canonical — "Prove then Harden" development principles, Output-First governance, sandbox workflow
Emergency_Declaration_Protocol_v1.0.md Canonical — Emergency override and auto-revert procedures
Test_Protocol_v2.0.md WIP — Test categories, coverage, and flake policy
EOL_Policy_v1.0.md Canonical — LF line endings, config compliance, clean invariant enforcement
Filesystem_Error_Boundary_Protocol_v1.0.md Draft — Fail-closed filesystem error boundaries, exception taxonomy
GitHub_Actions_Secrets_Setup.md PAT creation, secrets config, and rotation for CI workflows
Project_Planning_Protocol_v1.0.md Build mission plan requirements, schema compliance, lifecycle, and review rubric
Work_Management_Framework_v0.1.md NEW — Work Management Framework v0.1: intake, prioritisation, dispatch, review, closure
workstream_context_v1.md Context Management v1: canonical workstream state, preflight validation, resume prompt emission
COO_EA_Dispatch_Pipeline_Protocol_v0.1.md Design packet — GitHub-controlled COO to Codex EA dispatch pipeline, payloads, state machine, failure matrix, and #79 plan
OpenClaw_COO_Integration_v1.0.md OpenClaw gateway invocation, CLI wrappers, known constraints
Agent_Control_Plane_Pin_v1.0.md Dependency contract — pins LifeOS to the external agent-control-plane protocol/control-plane source
LifeOS_Multi_Agent_Protocol_v1.0.md Active protocol — Multi-agent message schema, addressing, lifecycle, transport bindings, and DAP authority integration. Consolidates ratified DAP, transport envelope, and bilateral protocol components.

Council Protocols

Document Purpose
Council_Protocol_v1.3.md Canonical — Council review procedure, modes, topologies, P0 criteria, complexity budget
AI_Council_Procedural_Spec_v1.1.md Runbook for executing Council Protocol v1.2
Council_Context_Pack_Schema_v0.3.md CCP template schema for council reviews

Packet & Artifact Schemas

Document Purpose
lifeos_packet_schemas_v1.yaml Agent packet schema definitions (13 packet types)
lifeos_packet_templates_v1.yaml Ready-to-use packet templates
build_artifact_schemas_v1.yaml NEW — Build artifact schema definitions (6 artifact types)
templates/ NEW — Markdown templates for all artifact types
example_converted_antigravity_packet.yaml Example: converted Antigravity review packet

Operational Guides

Document Purpose
guides/OpenClaw_Codex_OAuth_Recovery_v1.0.md Recovery flow for stale openai-codex auth ordering, refresh_token_reused, and secrets reload validation

03_runtime — Runtime Specification

Memory & Knowledge Architecture

Document Purpose
memory/LIFEOS_MEMORY_KNOWLEDGE_ARCHITECTURE_v0.5.md Canonical — Memory and knowledge architecture v0.5: authority model, logical stores, COO sole-writer rule, candidate packets, durable write receipts, retrieval model, phase split. Implementation: #53
memory/Agent_Memory_Bridge_v0.1.md Canonical boundary — Obsidian bridge authority boundary: navigation-only vault role, authority precedence, promotion preflights, and no watcher/runtime-ingestion rule
memory/LIFEOS_MEMORY_PHASE1_OPERATING_CONTRACT.md Operating contract — Phase 1 repo-backed memory tools, candidate transport, manual COO review flow, Hermes/OpenClaw native-memory posture, validator/generator/retrieval usage
memory/HERMES_OPENCLAW_MEMORY_GATEWAY_ADOPTION_v0.1.md Adoption runbook — Hermes/OpenClaw Memory Gateway v0.1 usage flow, smoke checklist, candidate-packet boundary, and no-direct-durable-write proof path

Core Specs

Document Purpose
COO_Runtime_Spec_v1.0.md Mechanical execution contract, FSM, determinism rules
COO_Runtime_Implementation_Packet_v1.0.md Implementation details for Antigravity
COO_Runtime_Core_Spec_v1.0.md Extended core specification
COO_Runtime_Spec_Index_v1.0.md Spec index and patch log
LifeOS_Autonomous_Build_Loop_Architecture_v0.3.md Canonical: Autonomous Build Loop Architecture (Council-authorised)
Council_Agent_Design_v1.0.md Information Only — Conceptual design for the Council Agent

Roadmaps & Plans

Document Purpose
LifeOS_Programme_Roadmap_CoreFuelPlumbing_v1.0.md Current roadmap — Core/Fuel/Plumbing tracks
LifeOS_Recursive_Improvement_Architecture_v0.2.md Recursive improvement architecture
LifeOS_Router_and_Executor_Adapter_Spec_v0.1.md Future router and executor adapter spec
LifeOS_Plan_SelfBuilding_Loop_v2.2.md Plan: Self-Building LifeOS — CEO Out of the Execution Loop (Milestone)

Work Plans & Fix Packs

Document Purpose
Hardening_Backlog_v0.1.md Hardening work backlog
Tier1_Hardening_Work_Plan_v0.1.md Tier-1 hardening work plan
Tier2.5_Unified_Fix_Plan_v1.0.md Tier-2.5 unified fix plan
F3_Tier2.5_Activation_Conditions_Checklist_v1.0.md Tier-2.5 activation conditions checklist (F3)
F4_Tier2.5_Deactivation_Rollback_Conditions_v1.0.md Tier-2.5 deactivation and rollback conditions (F4)
F7_Runtime_Antigrav_Mission_Protocol_v1.0.md Runtime↔Antigrav mission protocol (F7)
Runtime_Hardening_Fix_Pack_v0.1.md Runtime hardening fix pack
fixpacks/FP-4x_Implementation_Packet_v0.1.md FP-4x implementation

Templates & Tools

Document Purpose
BUILD_STARTER_PROMPT_TEMPLATE_v1.0.md Build starter prompt template
CODE_REVIEW_PROMPT_TEMPLATE_v1.0.md Code review prompt template
COO_Runtime_Walkthrough_v1.0.md Runtime walkthrough
COO_Runtime_Clean_Build_Spec_v1.1.md Clean build specification

Other

Document Purpose
Automation_Proposal_v0.1.md Automation proposal
Runtime_Complexity_Constraints_v0.1.md Complexity constraints
README_Recursive_Kernel_v0.1.md Recursive kernel readme

12_productisation — Productisation & Marketing

Document Purpose
An_OS_for_Life.mp4 Promotional Video — An introduction to LifeOS

internal — Internal Reports

Document Purpose
OpenCode_Phase0_Completion_Report_v1.0.md OpenCode Phase 0 API connectivity validation — PASSED

10_meta — Meta / Architecture Control

Document Purpose
ARCHITECTURE_SOURCE_OF_TRUTH.md Orientation surface — Current canon / proposal / stale map for architecture control
ARCHITECTURE_CHANGELOG.md Control log — Architecture deltas and their status
Implementation_Documentation_Drift_Audit_2026-05-13.md Reconciliation packet — May 2026 bus/hub/runtime implementation vs LifeOS documentation drift audit; no canon promotion
Review_Packet_Drift_Audit_2026-05-13_v1.0.md Review packet — Flattened review materials for the May 2026 drift audit packet
Review_Packet_Canonical_Doc_Reconciliation_2026-05-13_v1.0.md Review packet — Flattened review materials for the May 2026 canonical-doc reconciliation slice
Review_Packet_Operator_Entrypoint_Docs_2026-05-14_v1.0.md Review packet — Flattened changed files for the operator entrypoint documentation refresh
Architecture_Normalization_Reconciliation_Packet_2026-04-24.md Normalization packet — Canon, authority, writer boundaries, mismatch matrix
COO_Authority_Contract_Draft_2026-04-24.md Decision draft — Approval, proxy authority, active/standby, sole-writer boundaries
architecture_decisions/INDEX.md ADR register — Ratified architecture decisions only
Architecture_Normalization_Targeted_Issue_List_2026-04-24.md Issue draft — Targeted follow-on issues derived from reconciliation packet

99_archive — Historical Documents

Archived documents are in 99_archive/. Key locations:

  • 99_archive/superseded_by_constitution_v2/ — Documents superseded by Constitution v2.0
  • 99_archive/legacy_structures/ — Legacy governance and specs
  • 99_archive/lifeos-master-operating-manual-v2.md — Preceding version of the master operations manual
  • 99_archive/lifeos-operations-manual.md — First version of the master operations manual

Other Directories

Directory Contents
04_project_builder/ Project builder specs
05_agents/ Agent architecture
06_user_surface/ User surface specs
08_manuals/ Operational manuals (COO Doc Management, Governance Runtime)
09_prompts/v1.0/ Legacy v1.0 prompt templates
09_prompts/v1.2/ Current — Council role prompts (Chair, Co-Chair, 10 reviewer seats)
10_meta/ Meta documents, reviews, tasks

08_manuals — Operational Manuals

Document Purpose
LifeOS_Operator_Onboarding.md Operator entrypoint — repo surfaces, authority order, role boundaries, and safe-start workflow for new operators or AI agents
COO_Doc_Management_Manual_v1.0.md Executable runbook — Doc stewardship operations, validators, governance boundaries
Governance_Runtime_Manual_v1.0.md Governance runtime operations