ClaudeAutoPM

July 2, 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

Requires Node.js >= 22 and npm >= 10.

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

Choose your scenario during installation:

ScenarioAgentsUse case
Lite7 coreLocal PM only, minimal token footprint
GitHub12Core + languages for GitHub projects
Azure12Core + languages + Azure DevOps sync
Docker26Core + languages + frameworks + testing + DevOps
Obsidian7 corePM + Obsidian vault integration
Full45+Complete CI/CD: cloud, databases, AI included
Performance55+All plugins (incl. data + ML) + 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/    ← 50+ specialized agents (per plugin)

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

XML Rules Engine

8 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
issue-structure.xmlStandard GitHub issue structure (goal, criteria, verification)

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-infrastructure-expert
plugin-devops7docker-containerization-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-testing1frontend-testing-engineer
plugin-ml10pytorch-expert, tensorflow-keras-expert, scikit-learn-expert
plugin-pm29 PM commands (PRD, epic, issue management)

Quick Start

All commands run inside Claude Code (not terminal):

# Initialize context and testing
/context:create
/test:test-setup

# PM workflow
/pm:issue-start 42
/pm:issue-close 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 — OpenAI, Gemini, Claude, LangChain, HuggingFace
  • ML — PyTorch, TensorFlow/Keras, scikit-learn, AutoML
  • 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
Agents50+ specialized, load on demandGeneric or none
Rules8 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.