What problem does it solve?
Provides a single, deterministic protocol to discover and validate a project's workflow context so commands reliably know project identity, push targets, and artifact tracking before taking action.
Core Features & Use Cases
- Canonical context resolution: Read and validate .claude/workflow.yaml fields such as project.name, project.domain, and project.template.
- Bootstrap support: Handle first-run setup when workflow.yaml is missing by enumerating git remotes and pre-parsing candidate org/repo pairs.
- Push target derivation & safety: Derive push_org/push_repo from configured remotes, warn on non-GitHub remotes, and lock the session target to prevent accidental cross-target operations.
- Brief and tracking integration: Resolve briefs from GitHub issues or local files and map brief lifecycle statuses to GitHub labels when tracking is enabled.
Quick Start
Resolve the project's workflow context by reading .claude/workflow.yaml or running bootstrap detection to derive project identity and push targets.