lilo

First-run setup script Lilo follows on a fresh clone. Walks the operator through `.mcp.json`, the tools-bridge venv, `USER.md`, optional platform MCPs (`ios-simulator` on macOS), Telegram setup, the optional Notion pipeline dashboard, and an optional smoke-test project. Use when the operator says "bootstrap", "walk me through setup", "first-time setup", or anything clearly equivalent. Skip steps that are already done (e.g. if `USER.md` exists and looks complete, confirm it and move on).

Scaffold a new Claude Code project as a sibling of the orchestrator repo. Use when the operator says "new project <name>", "start a project called X", "spin up X", "scaffold X", or anything equivalent. All projects scaffold with the team template (PM + specialist agents) and auto-launch the PM in tmux. Accepts an optional `--profile mvp|work` to layer a config overlay on top of the base team template (default: `mvp`). Use `--profile work` for paid-client projects that need tighter permissions and work-only MCP connectors (HubSpot, GitHub, ClickUp, Figma).

Run `/sweep`, then run `/pipeline` only if the sweeper returned non-empty messages. Use when the operator says "/sync" or "sweep and refresh now".

Package a sibling project into the tools framework so it's callable via the custom MCP bridge. Use when the operator says to toolify a project or asks to expose a project as a tool.

Pre-exit scan for this Lilo session — save memory-worthy lessons silently, commit and push routine changes, branch off anything risky. Use when the operator says "/kill", "kill the session", "wrap up", or signals the session is ending. NOT for killing PM tmux sessions.

Pre-exit scan for this PM session — finalize outbox, persist state, commit and push routine changes, branch off anything risky. Use when Lilo or the operator says "/kill", "wrap up", "save and close", or signals the PM session is ending. NOT for killing tmux sessions of other projects.

Toggle the recurring `/sync` cron. `/poll on` registers it at 30-minute intervals starting 10 minutes after activation. `/poll off` deletes it. Use when the operator says "/poll on", "/poll off", "turn polling on", or "stop polling".

Notion dashboard refresh — dispatches the `pipeline-syncer` subagent to render pipeline data, diff against the per-project sync cache + parent-page fingerprint, and fire only the Notion calls that are required. Steady state is 0 calls. The subagent returns a JSON summary; Lilo only surfaces errors to the operator. Use when the operator says "/pipeline" or "refresh the dashboard".

PM control + project status. Default (no args) lists sibling projects and live tmux sessions. With an action (`start <name>`, `stop <name>`), operate on a specific PM tmux session. Use when the operator says "/pm", "status", "what's running", "/pm start X", "spin up the X PM", "/pm stop X", "kill the X PM session", or anything equivalent.

Outbox sweep — dispatches the `outbox-sweeper` subagent to find new PM messages across every sibling project, archive them, and roll up agent feedback. The subagent returns a JSON summary; Lilo only relays to the operator if anything was found. Use when the operator says "/sweep" or "sweep now".

Team-mode project coordination for Lilo — launching PM sessions on the `team` template, relaying PM outbox messages to the operator by type/priority, and aggregating specialist ratings into the registry-refinement loop. Use when scaffolding a team-template project, sweeping `../<project>/.lilo-outbox/*.json`, or processing `done` messages from PMs.

Safely find, vet, and import a new specialist agent definition from an external source (GitHub, marketplaces, blog posts) into the orchestrator's agent registry. Use when the operator asks you to "find an agent for X", "look for an existing Y specialist", "recruit a Z agent from online", or greenlights importing one after a search. Enforces a prompt-injection scan + adaptation pass before anything lands in the registry.

Close out a task — append a `task_done` event to `.team-history.jsonl` and remove it from `active_tasks` in `.team-state.json`. Use whenever a task in `active_tasks` is finished. Optional `--rating effective|adequate|poor` records the agent's performance for the registry refinement loop.

Delete a sibling project directory entirely (destructive, irreversible). Use when the operator says "nuke <name>", "delete the <name> project", "tear down X", or anything clearly asking to remove a scaffolded project. ALWAYS confirm with the operator before deleting.

Read new messages from Lilo in .lilo-inbox/, summarize them into the working plan, and archive. Use at session start, when Lilo nudges you via tmux, or whenever you suspect new instructions have arrived. Plumbing only — does not act on the messages, that's the PM's judgment call.