docs: AIOS v5 architecture foundation and migration roadmap

docs/AGENT_OS_KERNEL.md

@@ -0,0 +1,16 @@
+# Agent OS Kernel
+
+AIOS v5.1 direction:
+
+- Agent process model
+- Lifecycle manager
+- Resource manager
+- Isolation
+- Agent IPC
+- Recovery
+
+Agent lifecycle:
+
+CREATED -> INITIALIZING -> READY -> RUNNING -> WAITING -> SUSPENDED -> TERMINATED
+
+All autonomous changes require policy checks and audit trails.

docs/AIOS_v5_ARCHITECTURE.md

@@ -0,0 +1,43 @@
+# AIOS v5 Architecture Foundation
+
+## Vision
+
+AIOS v5 evolves into an agent operating system with:
+
+- Runtime API
+- Orchestrator
+- Execution Kernel
+- Event Bus
+- Memory Graph
+- Skill Engine
+- Multi-Agent Scheduler
+- Distributed Workers
+- Security Governance
+- Production Runtime
+
+## Execution Flow
+
+User -> Runtime API -> Orchestrator -> Scheduler -> Agent -> Security -> ExecutionKernel -> Tools -> EventBus -> Memory/Skills/Audit
+
+## Migration Roadmap
+
+1. Core Foundation
+2. ExecutionKernel
+3. EventBus
+4. Orchestrator v5
+5. Memory Graph + Recovery
+6. Skill Engine
+7. Multi-Agent Scheduler
+8. Distributed Runtime
+9. Security Layer
+10. Production Hardening
+
+## Agent OS Direction
+
+Future versions introduce:
+
+- Agent lifecycle management
+- Resource quotas
+- Plugin ecosystem
+- Evolution loops
+- Knowledge consolidation

docs/V5_MIGRATION_PR_ROADMAP.md

@@ -0,0 +1,26 @@
+# AIOS v5 Migration PR Roadmap
+
+## PR Sequence
+
+- PR #1 Core Foundation
+- PR #2 ExecutionKernel
+- PR #3 EventBus and Observability
+- PR #4 Orchestrator Migration
+- PR #5 Memory Graph and Recovery
+- PR #6 Skill Engine
+- PR #7 Multi-Agent Scheduler
+- PR #8 Distributed Runtime
+- PR #9 Security Governance
+- PR #10 Production Hardening
+
+## Release Flow
+
+feature branches -> release/v5.0-rc1 -> release/v5.0 -> main
+
+## Rules
+
+- Execution through ExecutionKernel only
+- Events for state changes
+- Recoverable agent state
+- Plugin-based extensions
+- Auditable autonomous actions