ClaudeAutoPM

April 15, 2026 · View on GitHub

NPM Version NPM Downloads MIT License GitHub Stars

AI-Powered Project Management Framework for Claude Code

ClaudeAutoPM transforms your development workflow with intelligent automation, specialized AI agents via a plugin system, and complete GitHub/Azure DevOps integration. Install only what you need — pay only for the tokens you use.


Quick Install

npm install -g claude-autopm
cd your-project
autopm install

Choose your scenario during installation:

ScenarioAgentsUse case
Lite7 coreMinimal token footprint
GitHub12Core + languages for GitHub projects
Azure14Core + languages + Azure DevOps
Docker16Core + DevOps + containers
Obsidian12PM + Obsidian vault integration
Full44+All plugins, all agents
Performance44+Full + max parallelization

Architecture

Plugin-Based Agent System

ClaudeAutoPM uses a plugin architecture for token efficiency. Only 7 core agents are loaded by default. Specialized agents are installed on demand via plugins.

autopm/.claude/agents/       ← 7 core agents (always available)
packages/plugin-*/agents/    ← 37+ specialized agents (per plugin)

Token savings: Lite installs use 73% fewer agent tokens vs full.

XML Rules Engine

7 critical rules auto-loaded via @include in XML format:

RuleEnforcement
tdd.enforcement.xmlZero-tolerance TDD cycle
coverage-thresholds.xml80/75/80/80 coverage gates
agent-mandatory.xmlAgent delegation + context strategy
context7.xmlContext7 MCP before any library code
github-operations.xmlRepo protection + mandatory issue footer
naming-conventions.xmlNaming prohibitions + code quality
command-pipelines.xml5 mandatory command sequences

3 MD operational guides: standard-patterns.md, frontmatter-operations.md, git-strategy.md

Dynamic Agent Registry

agent-registry.xml is generated at install time based on selected plugins:

<!-- Core agents (always present) -->
<agents category="core">
  <agent name="code-analyzer">...</agent>
  <agent name="test-runner">...</agent>
  ...
</agents>

<!-- Plugin agents (injected by installer) -->
<!-- PLUGIN_AGENTS_START -->
<agents category="languages">...</agents>
<agents category="frameworks">...</agents>
<!-- PLUGIN_AGENTS_END -->

Core Agents (Always Available)

AgentPurpose
agent-managerAgent lifecycle, registry maintenance
code-analyzerCode analysis, bug detection, logic tracing
test-runnerTest execution with actionable insights
file-analyzerSummarize large files, reduce context
parallel-workerMulti-agent parallel work streams
mcp-managerMCP server install, config, health
context-optimizerContext window efficiency, compaction

Plugin Agents

PluginAgentsExamples
plugin-languages5python-backend-engineer, nodejs-backend-engineer, bash-scripting-expert
plugin-frameworks6react-frontend-engineer, tailwindcss-expert, e2e-test-engineer
plugin-cloud8aws-cloud-architect, kubernetes-orchestrator, terraform-expert
plugin-devops7docker-expert, github-operations-specialist, observability-engineer
plugin-databases5postgresql-expert, mongodb-expert, redis-expert
plugin-ai8openai-python-expert, gemini-api-expert, langchain-expert
plugin-data3airflow-orchestration-expert, kedro-pipeline-expert
plugin-testing2frontend-testing-engineer, e2e specialists
plugin-ml2ML workflow agents
plugin-pm29 PM commands (PRD, epic, issue management)

Quick Start

All commands run inside Claude Code (not terminal):

# Initialize context and testing
/context:create
/testing:prime

# PM workflow
/pm:issue-start 42
/pm:issue-finish 42

# Working with agents
@python-backend-engineer Build FastAPI endpoint
@test-runner execute all tests
@code-analyzer review recent changes

Features

14 Official Plugins

  • Core — Context management, testing, configuration, MCP
  • PM System — PRD, epics, issues, decomposition, git workflow
  • Obsidian — Read-only vault sync, Dataview frontmatter, diagnostics
  • Azure DevOps — Work items, boards, pipelines, sprints
  • GitHub — Workflows, issues, PRs, automation
  • Languages — Python, JavaScript, Node.js, Bash
  • Frameworks — React, Tailwind, UX, E2E testing, NATS
  • Testing — Frontend unit/integration, E2E
  • DevOps — Docker, Kubernetes, Traefik, SSH, observability
  • Cloud — AWS, Azure, GCP, Terraform, serverless
  • Databases — PostgreSQL, MongoDB, BigQuery, CosmosDB, Redis
  • AI/ML — OpenAI, Gemini, LangChain, HuggingFace
  • Data — Airflow, Kedro, LangGraph

Provider Integration

  • GitHub — Issues, PRs, Actions, Projects
  • Azure DevOps — Work Items, Boards, Pipelines
  • Local — Git-based workflow with markdown tracking

Execution Strategies

  • Sequential — Safe, predictable
  • Adaptive — Intelligent mode selection (default)
  • Hybrid — Maximum parallelization

Documentation


Why ClaudeAutoPM?

FeatureClaudeAutoPMTraditional Tools
AI-nativeBuilt for Claude CodeAdapted/retrofitted
Token-efficientPlugin system, install what you needMonolithic
Agents44+ specialized, load on demandGeneric or none
Rules7 XML auto-enforced (TDD, coverage, Context7)Manual checklists
IntegrationGitHub + Azure DevOpsLimited
DocumentationContext7-verified, always currentOften outdated

Contributing

We welcome contributions! See Contributing Guide.

TDD is mandatory — every PR must follow Red-Green-Refactor.


License

MIT License - see LICENSE for details.