docs(research): install patterns — lean-ctx / rtk / code-review-graph compare ccteam

[firstintent]

Summary

Read-only research for V0.6.7 install/integration architecture decisions. Three reference repos surveyed:

• lean-ctx (yvgude/lean-ctx, Rust, 2.1k★) — broadest install matrix (6 channels), best-in-class OS-native self-update scheduler.
• rtk (rtk-ai/rtk, Rust, 53k★) — Homebrew core, cleverest install.sh (302-redirect for latest, path-traversal guard), thin-delegator hook pattern.
• code-review-graph (tirth8205/code-review-graph, Python, 17k★) — cleanest `install` dispatcher (12 agents auto-detect), best Codex integration (`~/.codex/hooks.json` SessionStart + PostToolUse), idempotent CLAUDE.md marker injection.

Key findings vs ccteam V0.6.6

维度	Where ccteam stands
Install path	ccteam relies on Anthropic `/plugin marketplace add` (git-clone — breaks on macOS no-CLT); all 3 references bypass it and write per-agent configs directly
Codex integration	ccteam (F173 cost ledger) is deeper than rtk (awareness-doc only) but lacks code-review-graph's `~/.codex/hooks.json` lifecycle hooks
Lifecycle hooks	ccteam has none; code-review-graph has SessionStart + PostToolUse on Claude AND Codex
Self-update	ccteam has none; lean-ctx ships LaunchAgent + systemd timer + cron + Task Scheduler abstraction (~400 LOC, copy-friendly)
Agent breadth	ccteam = 1 (Claude Code, with Codex spawned); lean-ctx = 30; code-review-graph = 12; rtk = 9

Top 3 V0.6.7 recommendations

1. `ccteam install [--agent ]` (M, 1-2d) — direct-config bootstrap modelled on `code-review-graph install`, fixes macOS-no-CLT and opens Codex/Cursor/Zed users.
2. Claude SessionStart hook (S, 0.5d) — surface ccteam state (workflows, IM bot health, recent cost) on every session start; passive version-check.
3. `ccteam update` + LaunchAgent/systemd timer (M, 1-2d) — port lean-ctx's `update_scheduler` abstraction. Opt-in via install wizard.

Plus tier-2 polish: install.sh glibc-detect + macOS ad-hoc codesign + tar path-traversal guard (S, 2-4h total).

Open questions raised in doc

• Keep both `.claude-plugin/marketplace.json` AND `ccteam install` direct-config path, or drop one?
• Does Claude SessionStart hook conflict with the §三 "no prompt injection" red line (mode-3 specific)?
• Auto-update schedule default: on or off? IM-bot supervisor is long-running, mid-session swap could break tmux.

Test plan

• Doc-only PR; no Rust changes; baseline tests not affected.
• Verify diagram links / repo refs render in GitHub markdown.

Read-only research; pure doc add — `docs/versions/v0-6-6/install-patterns-research.md` only (321 lines).

🤖 Generated with Claude Code