/project-status

Gather and report project status across Linear, GitHub, and git — read-only

05 Refine Input: CLAUDE.md (initiative name), optional project filter Output: markdown status report with tables and recommendations

Step

Human

Claude Code Agent

External Systems

Invoke

"Give me a status report on this repo"

Resolve

Reads initiative name from CLAUDE.md, discovers Linear projects

Narrows scope to matching project if filter argument provided

Read CLAUDE.md, mcp__linear__get_initiative, list_projects

Initiative and project list fetched

Linear

Gather

Parallel Agent Fetch

Linear

Issues by state
Done · In Progress · Todo · Backlog

GitHub

PRs
merged + open

Git

Commits · branches · worktrees

All three fetched in parallel. Each source queried independently via MCP tools or CLI.

Issues, PRs, and git state fetched

Linear GitHub Git

Format

Groups issues by status and priority, detects newly unblocked work

Cross-references parent/child relationships, identifies stale branches and orphan worktrees

Synthesize

Produces narrative: completed work, planned work, git housekeeping, concerns

Highlights blocked items, recommends next actions with specific commands

Present

Renders full markdown summary with tables, recommendations, and next steps

Tables: completed issues, in-progress work, upcoming by priority. Lists: branch cleanup, recommended actions.

Human

Agent

External

Decision gate