Agent skill
pm-architect
Expert project manager orchestrating backlog-curator, work-delegator, workstream-coordinator, and roadmap-strategist sub-skills. Coordinates complex software projects through delegation and strategic oversight. Activates when managing projects, coordinating work, or tracking overall progress.
Install this agent skill to your Project
npx add-skill https://github.com/rysweet/amplihack/tree/main/docs/claude/skills/pm-architect
SKILL.md
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:
- Understand intent: Determine which sub-skill(s) to invoke
- Invoke specialist(s): Call appropriate sub-skill(s) in parallel when possible
- Synthesize results: Combine insights from sub-skills
- Present cohesively: Deliver unified response to user
- 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-skillsscripts/generate_daily_status.py— AI-powered daily status report generationscripts/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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
chemist-analyst
Analyzes events through chemistry lens using molecular structure, reaction mechanisms, thermodynamics, kinetics, and analytical techniques (spectroscopy, chromatography, mass spectrometry). Provides insights on chemical processes, material properties, reaction pathways, synthesis, and analytical methods. Use when: Chemical reactions, material analysis, synthesis planning, process optimization, environmental chemistry. Evaluates: Molecular structure, reaction mechanisms, yield, selectivity, safety, environmental impact.
learning-path-builder
Creates personalized learning paths for technologies, frameworks, or concepts. Use for user-interactive session only for onboarding new technologies, hackathon skill-building, or personal development planning. Not for use in automated development or investigation. Sequences resources (docs, tutorials, exercises) based on current skill level and learning goals. Adapts to learning style: hands-on, theory-first, project-based.
gh-work-report
Generates comprehensive GitHub activity reports across all authenticated accounts. Gathers repos, PRs, features, and themes for configurable time periods (1/5/7/30/90 days). Produces shareable markdown with tables, mermaid charts, and executive summaries. Can create a private repo with GitHub Actions automation and GitHub Pages aggregation site. Use when: "github report", "work report", "activity summary", "what did I work on", "gh-work-report", "show my github activity".
pr-review-assistant
Philosophy-aware PR reviews checking alignment with amplihack principles. Use when reviewing PRs to ensure ruthless simplicity, modular design, and zero-BS implementation. Suggests simplifications, identifies over-engineering, verifies brick module structure. Posts detailed, constructive review comments with specific file:line references.
code-smell-detector
Identifies anti-patterns specific to amplihack philosophy. Use when reviewing code for quality issues or refactoring. Detects: over-abstraction, complex inheritance, large functions (>50 lines), tight coupling, missing __all__ exports. Provides specific fixes and explanations for each smell.
biologist-analyst
Analyzes living systems and biological phenomena through biological lens using evolution, molecular biology, ecology, and systems biology frameworks. Provides insights on mechanisms, adaptations, interactions, and life processes. Use when: Biological systems, health issues, evolutionary questions, ecological problems, biotechnology. Evaluates: Function, structure, heredity, evolution, interactions, molecular mechanisms.
Didn't find tool you were looking for?