Project Tracker module

Programmes, projects, tasks, issues, stages, and gates. Constellation dogfoods this module to track its own development.

• Source: apps/project-tracker/
• Schema: projects
• Project Tracker prefix: PT-*
• MCP server + CLI: tools/mcp-server/

Interfaces

Two equivalent surfaces wrap the REST API:

• pt CLI — npx pt <subcommand> from the monorepo root. Works in any shell-based agent.
• MCP server — for Claude Desktop and other MCP-native clients.

Both read PT_BASE_URL and PT_AUTH_TOKEN from the environment.

Task vs issue

• Task — planned work with acceptance criteria (features, refactors, specs).
• Issue — unplanned work (bugs, incidents, help desk).

Reference documents

• Implementation Plan — feature roadmap, completed phases, current scope
• API Reference — auto-generated from apps/project-tracker/openapi.json
• Deployment & Migration Plan — Vercel project, Supabase database, rollout strategy