MOS/mos_v3/NEW_SESSION_README.md

New Session Readme for Agents

If you are a new agent session reading this MOS v3 package, do not load everything blindly.

Read order

1. README_PACKAGED.md
2. QUICK_START.md
3. mos_core/mos_always_rules.md
4. mos_core/AGENTS.md
5. mos_core/active_task.md
6. mos_core/memory_cards/context_compression_recovery_policy.md
7. mos_core/memory_cards/mos_usage_policy.md
8. mos_core/tool_and_external_source_policy.md
9. mos_core/local_static_operation_policy.md
10. mos_core/runtime_protocol.md
11. mos_core/harness_audit_policy.md
12. mos_core/permission_and_information_flow_policy.md
13. mos_core/memory_cards/README.md
14. Only then inspect task-specific memory cards.

Mental model

• mos_core/ is the portable memory framework.
• memory_cards/ are long-term reusable conclusions, not raw chat logs.
• task_log.md is stage handoff history.
• active_task.md is current state only.
• source_refs tell you where to verify critical claims.
• Search/bootstrap/SQLite outputs are navigation aids, not final truth.
• Local files are the fact source; generated indexes are rebuildable.

What to avoid

• Do not treat old personal memory cards as universally true for a new user.
• Do not assume placeholder paths or IPs are valid.
• Do not write credentials into memory cards, task logs, indexes, or bootstrap files.
• Do not assume a remote server is required; prefer local CLI and static index workflows.
• Do not promote candidate memory into confirmed memory without review.

First action in a new session

Read the core files, edit active_task.md, and run local safety/index checks before relying on retrieval.