2.6 KiB

Raw Blame History

MOS v3 Portable Package Quick Start

This package is a blank MOS v3 framework bundle for local file-backed memory, static local database/index rebuilds, and one-shot CLI workflows.

1. What is included

mos_v3/
  README_PACKAGED.md
  QUICK_START.md
  NEW_SESSION_README.md
  DEPLOYMENT_CHECKLIST.md
  mos_core/
    AGENTS.md
    active_task.md
    task_log.md
    source_registry.md
    local_static_operation_policy.md
    memory_cards/
    memory_card_candidates/
    tools/
  agent_config_templates/

2. Minimal local workflow

From mos_core/:

py -3 tools\mos_cli.py status
py -3 tools\build_index.py
py -3 tools\check_safety.py
py -3 tools\search_memory.py "MOS usage policy" --top-k 5
py -3 tools\make_bootstrap.py "new session recovery" --top-k 8

3. What a new user must configure

mos_core/active_task.md
mos_core/source_registry.md
mos_core/index_config.json
local source roots that belong to the current user or project

4. Local read/write model

read from memory_cards/, task_log.md, active_task.md, and the local index
write durable conclusions to memory_cards/
write stage handoffs to task_log.md
write uncertain reusable items to memory_card_candidates/
rebuild the local index after memory changes
treat Markdown files as truth and SQLite/search output as navigation

5. One-shot CLI model

MOS v3 does not require a long-running remote service. Use one-shot CLI commands that open local files and derived SQLite/search indexes, perform the operation, and exit.

cd mos_core
py -3 tools\mos_cli.py status
py -3 tools\mos_cli.py rebuild
py -3 tools\mos_cli.py safety
py -3 tools\mos_cli.py search "query" --top-k 8
py -3 tools\mos_cli.py bootstrap "task" --top-k 8
py -3 tools\mos_cli.py write-log .\handoff.md
py -3 tools\mos_cli.py write-card-candidate .\candidate.md

6. Important limitations

runtime data and generated indexes stay outside long-term framework backups unless intentionally captured
credentials, private endpoints, and secrets are excluded
project-specific memory must be added by the new user
local indexes are derived data and must be rebuildable from files
remote server, MCP server, watcher, or UI can be added later only as adapters, not as fact sources

7. MOS v3 checks

After editing MOS memory, rules, or task logs, run:

cd mos_core
py -3 tools\check_memory_cards.py
py -3 tools\check_handoff.py
py -3 tools\check_source_refs.py
py -3 tools\check_agent_config.py
py -3 tools\audit_recent_actions.py

For high-risk tasks, record a harness audit entry using harness_audit_policy.md.

2.6 KiB Raw Blame History