README.md

LifeOS Documentation

Purpose

Provide the canonical index for the LifeOS docs set and give contributors a clear reading path through the Phase 1 vision and architecture.

Active MVP Surface

Current executable MVP targets are:

• @lifeos/cli
• @lifeos/goal-engine
• @lifeos/life-graph
• @lifeos/event-bus
• @lifeos/module-loader
• Runtime modules: @lifeos/reminder-module, @lifeos/calendar-module, @lifeos/scheduler-module, @lifeos/research-module, @lifeos/notes-module, @lifeos/weather-module, @lifeos/news-module, @lifeos/google-bridge, @lifeos/personality, @lifeos/orchestrator, @lifeos/sync-core

Recommended Reading Order

1. Current Product Contract - [current] Active product contract
2. Current System Boundary - [current] Active architecture boundary map
3. Roadmap - [current] Phase sequence and active phase
4. Personal Operations OS MVP Plan - [current] Phase 3 execution plan
5. Project README - [current] Quick start and CLI reference
6. Architecture Overview - [foundation] Core component architecture
7. Phase 1 Overview - [foundation] Phase 1 Personal AI Node foundation
8. Phase 1 Reference Architecture - [foundation] Phase 1 reference architecture

Vision

• Overview [current]
• Principles [current]
• Roadmap [current]
• Personal Operations OS MVP Plan [current]

Phase 1

• Phase 1 Landing Page [foundation]
• Goal Interpreter CLI Demo (MVP #1) [foundation]
• Reference Architecture [foundation]
• Scope [foundation]
• Goals [foundation]
• Non-Goals [foundation]
• Use Cases [foundation]
• Success Criteria [foundation]

Architecture

• Current System Boundary [current]
• Overview [foundation]
• Personal AI Node [foundation]
• Hardware Profile [foundation]
• Reference Stack [foundation]
• Reasoning Engine [foundation]
• Life Graph [foundation]
• Automation Framework [foundation]
• Module System [foundation]
• Integrations [foundation]
• Event Model [foundation]
• Voice and Media [foundation]
• Security and Privacy [foundation]
• User Interfaces [foundation]

Security

• Threat Model [foundation]

Concepts

• Agent Mesh [foundation]
• Simulation [foundation]
• Privacy and Sovereignty [foundation]
• Decentralized Network [foundation]

Community

• Open Source Direction [foundation]
• Contributor Map [current]
• Glossary [current]
• Phase 1 MVP North Star Issue Draft [foundation]
• v0.1.0 Launch Thread Draft [foundation]
• v0.2.0 Ecosystem North Star Issue Draft [future]
• v0.2.0 Launch Thread Draft [future]
• v0.2.0 Release Notes Draft [future]

Module Spec

• lifeos.json Manifest Spec [foundation]