chore: consolidate new foundation and archive v1 (#1495)

2026-09-07 12:32:57 -05:00
parent 9a5fbdbda7 5d27700026
commit 127a54fdff
3511 changed files with 727899 additions and 10 deletions
@@ -0,0 +1,17 @@
+# Claude Adapter
+
+Use this adapter when running Claude CLI sessions.
+
+## Required Context
+
+1. `~/.config/mosaic/STANDARDS.md`
+2. `<repo>/AGENTS.md`
+
+## Command Wrapper
+
+Use wrapper commands from `~/.config/mosaic/bin/` for lifecycle rituals.
+
+## Migration Note
+
+Project-local `.claude/commands/*.md` should call `scripts/agent/*.sh` so behavior stays runtime-neutral.
+Guides and tools should resolve to `~/.config/mosaic/guides` and `~/.config/mosaic/tools` (linked into `~/.claude` for compatibility).
@@ -0,0 +1,13 @@
+# Codex Adapter
+
+Use this adapter when running Codex CLI sessions.
+
+## Required Context
+
+1. `~/.config/mosaic/STANDARDS.md`
+2. `<repo>/AGENTS.md`
+
+## Runtime Behavior
+
+- Favor repo lifecycle scripts under `scripts/agent/` for start/end rituals.
+- Keep instructions and quality gates aligned with Mosaic standards.
@@ -0,0 +1,14 @@
+# Generic Adapter
+
+For runtimes without a first-class adapter yet.
+
+## Required Context
+
+1. Load `~/.config/mosaic/STANDARDS.md`
+2. Load project `AGENTS.md`
+
+## Minimal Contract
+
+- Use `scripts/agent/session-start.sh` at start if present.
+- Use `scripts/agent/session-end.sh` before completion if present.
+- If missing, run equivalent repo commands and report what was executed.
@@ -0,0 +1,38 @@
+# Pi Adapter
+
+Use this adapter when running Pi sessions via `mosaic pi`.
+
+## Required Context
+
+1. `~/.config/mosaic/STANDARDS.md`
+2. `<repo>/AGENTS.md`
+
+## Integration
+
+Pi is the native Mosaic agent runtime. The `mosaic pi` launcher:
+
+1. Injects the full runtime contract via `--append-system-prompt`
+2. Loads Mosaic skills via `--skill` flags
+3. Loads framework-owned `mosaic-extension.ts` and `goal-extension.ts` from
+   `~/.config/mosaic/runtime/pi/` via ordered `--extension` flags
+4. Detects active missions and injects initial prompts
+
+## Capabilities vs Other Runtimes
+
+- No permission restrictions (no yolo flag needed)
+- Native thinking levels replace sequential-thinking MCP
+- Native skill discovery compatible with Mosaic SKILL.md format
+- Native extension system for lifecycle hooks (TypeScript, not bash shims)
+- Bounded persistent `/goal` loop with per-turn, post-compaction, and two-pass evidence checks
+- Native session persistence and resume
+- Model-agnostic (Anthropic, OpenAI, Google, Ollama, custom providers)
+
+## Command Wrapper
+
+```bash
+mosaic pi                    # Interactive session
+mosaic pi "Fix the auth bug" # With initial prompt
+mosaic yolo pi               # Identical to mosaic pi
+mosaic coord --pi run        # Coordinator-driven session
+mosaic prdy --pi init        # PRD creation via Pi
+```