What problem does it solve? Coordinating multiple software projects with AI agents often leads to duplicated task databases, stale status tracking, and unclear handoffs between planning and execution. This Skill provides a single portfolio and project-architecture layer that treats GitHub Issues and Projects as the authoritative work state, eliminating conflicting sources of truth. ## Core Features & Use Cases - Epic Planning and Architecture Gate: Transform rough ideas or requirements into structured Epic contracts with execution strategy selection, and route cross-cutting initiatives through an architecture preflight before execution. - GitHub-Native Portfolio Reporting: Generate portfolio, project, and issue-level reports from GitHub Issues, Projects, and Git state, with local fallback planning under .agent/work-items/ when GitHub is unavailable. - Registry and Projection Management: Maintain a projects.json portfolio registry, run health checks and onboarding diagnostics, and generate disposable Obsidian projections without duplicating operational state. - Use Case: Register five repositories, run pm-portfolio-report.sh to see open, blocked, and in-review Issues across all of them, then plan a new Epic with an explicit execution strategy and hand it to a coding agent or orchestrator. ## Quick Start Ask the agent to onboard the project manager with scripts/pm-onboard.sh, register your repositories, and produce a portfolio report of open and blocked GitHub Issues.
