project-router

This skill is Safa’s canonical project management + context switching control plane.

Core idea:

• Canonical PM is local + queryable (SQLite): projects, tasks, context packs.
• Trello is a tracking backend/UI: cards mirror canonical tasks; lists mirror status; labels mirror priority.
• The “killer feature” is context switching: load the right docs/code/index for a project/task quickly and deterministically.

It provides:

• CLI: project ...
• MCP server: mcp-project-router (tools mirror the CLI)
• Per-project bundle stored in .project/ (brief, targets, artifact index)
• A canonical task store (SQLite) + Trello sync adapter

Project bundle layout (v1)

The .project/ bundle is the project-local context nucleus. The canonical PM DB points at these bundles.

Inside a project root:

• .project/project.json — structured manifest
• .project/PROJECT.md — living brief
• .project/targets.json — target definitions (commands)
• .project/index/artifacts.json — artifact index
• .project/history/plans/*.json — plans
• .project/history/applies/*.json — apply receipts

CLI quick start

Baseline / existing commands

From anywhere inside a repo/workspace:

• project detect
• project context
• project target list
• project target run

Initialize a bundle (dry-run plan + apply):

• project init (prints plan)
• project apply

Artifacts:

• project artifact add [--tags a,b,c] (plan + apply)

Canonical PM + context switching (new)

Note: these verbs are the target UX. Implementations should remain idempotent and safe.

Project registration:

• project pm project add --name "..." --root
• project pm project list

Task management:

• project pm task add "