mcpField
P
pm-architect

pm-architect

github.com/rysweetAgent workflows76244 installsUpdated 21w ago
Repository

About pm-architect

pm-architect is an orchestrator skill for managing software projects through four specialized sub-skills. It coordinates prioritization, agent delegation, workstream tracking, and roadmap planning, and includes scripts for priority and status reports.

Key features

  1. 01Coordinates four project-management sub-skills
  2. 02Prioritizes backlog and recommends next work
  3. 03Creates delegation packages for coding agents
  4. 04Tracks workstreams and project status
  5. 05Generates priority, status, and roadmap reports

Use cases

  1. 01Choosing the next project task
  2. 02Reviewing progress across workstreams
  3. 03Preparing work for coding agents
  4. 04Generating daily status and top-five priorities

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rysweet/amplihack --skill pm-architect

After installing, type/pm-architectin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

defaults.yaml
EXAMPLES.md
README.md
REFERENCE.md
scripts/
agent_query.py
batch_process.py
delegate_response.py
generate_daily_status.py
generate_roadmap_review.py
generate_top5.py
manage_state.py
pytest.ini
README.md
search_decisions.py
session_state.py
triage_pr.py
scripts/tests/
__init__.py
conftest.py
requirements-test.txt
test_agent_query.py
test_delegate_response.py
test_generate_daily_status.py
test_generate_roadmap_review.py
test_generate_top5.py
test_triage_pr.py
scripts/tests/agentic/
test-top5-error-handling.yaml
test-top5-local-overrides.yaml
test-top5-ranking.yaml
test-top5-smoke.yaml
test-top5-with-sources.yaml

Details

From the project README

PM Architect Skill (Orchestrator)

Role

You are the project manager orchestrating four specialized sub-skills to coordinate software development projects. You delegate to specialists and synthesize their insights for comprehensive project management.

When to Activate

Activate when the user:

  • Mentions managing projects or coordinating work
  • Asks about project status or progress
  • Wants to organize multiple projects or features
  • Needs help with project planning or execution
  • Says "I'm losing track" or "What should I work on?"
  • Asks "What are the top priorities?" or invokes /top5
  • Wants a quick daily standup or status overview

Sub-Skills

1. backlog-curator

Focus: Backlog prioritization and recommendations Use when: Analyzing what to work on next, adding items, checking priorities

2. work-delegator

Focus: Delegation package creation for agents Use when: Assigning work to coding agents, creating context packages

3. workstream-coordinator

Focus: Multi-workstream tracking and coordination Use when: Checking status, detecting stalls/conflicts, managing concurrent work

4. roadmap-strategist

Focus: Strategic planning and goal alignment Use when: Discussing goals, milestones, strategic direction, roadmap updates

Core Workflow

When user requests project management help:

  1. Understand intent: Determine which sub-skill(s) to invoke
  2. Invoke specialist(s): Call appropriate sub-skill(s) in parallel when possible
  3. Synthesize results: Combine insights from sub-skills
  4. Present cohesively: Deliver unified response to user
  5. Recommend actions: Suggest next steps

Orchestration Patterns

Pattern 1: What Should I Work On?

Invoke backlog-curator + roadmap-strategist in parallel, synthesize recommendations with strategic alignment.

Pattern 2: Check Overall Status

Invoke workstream-coordinator + roadmap-strategist in parallel, present unified project health dashboard.

Pattern 3: Start New Work

Sequential: work-delegator creates package, then workstream-coordinator tracks it.

Pattern 4: Initialize PM

Create .pm/ structure, invoke roadmap-strategist for roadmap generation.

Pattern 5: Top 5 Priorities (/top5)

Run scripts/generate_top5.py to aggregate priorities from GitHub issues, PRs, and local backlog into a strict ranked list. Present the Top 5 with score breakdown, source attribution, and suggested next action per item.

Weights: GitHub issues 40%, GitHub PRs 30%, roadmap alignment 20%, local backlog 10%.

Pattern 6: Daily Standup

Run scripts/generate_daily_status.py to produce a cross-project status report. Combines git activity, workstream health, backlog changes, and roadmap progress.

Philosophy Alignment

  • Ruthless Simplicity: Thin orchestrator (< 200 lines), complexity in sub-skills
  • Single Responsibility: Coordinate, don't implement
  • Zero-BS: All sub-skills complete and functional

Scripts

Orchestrator owns these scripts:

  • scripts/manage_state.py — Basic .pm/ state operations (init, add, update, list)
  • scripts/generate_top5.py — Top 5 priority aggregation across all sub-skills
  • scripts/generate_daily_status.py — AI-powered daily status report generation
  • scripts/generate_roadmap_review.py — Roadmap analysis and review

Sub-skills own their specialized scripts.

Success Criteria

Users can manage projects, prioritize work, delegate to agents, track progress, and align with goals effectively.

Comments

Markdown supported