agentic-pm

Agentic Project Management (APM)

Manage complex projects with a team of AI assistants, smoothly and efficiently.

What is APM?

Agentic Project Management (APM) is a AI workflow framework that brings real-world project management principles into your AI-assisted workflows. It addresses a fundamental challenge of LLMs: context window limitations.

APM uses various context retention techniques, coordinating a team of specialized AI agents in a structured way so that you can maintain productive AI-assisted work for longer periods before facing model hallucinations and needing to start over. When context window does fill up, APM ensures a smooth transition to a "fresh" chat session without important context loss.

Think of it like having a project manager, developers, ad-hoc specialists, and a setup/configuration expert all powered by AI and working together under your guidance.

Installation

Install APM CLI globally via NPM:

npm install -g agentic-pm

Or install locally in your project:

npm install agentic-pm

Supported AI Assistants

APM supports the following AI assistants and IDEs:

Assistant	Type	Format	Command Directory
Cursor	IDE & CLI	Markdown	.cursor/commands
Claude Code	IDE & CLI	Markdown	.claude/commands
GitHub Copilot	IDE	Markdown	.github/prompts
Windsurf	IDE	Markdown	.windsurf/workflows
Roo Code	IDE	Markdown	.roo/commands
Kilo Code	IDE	Markdown	.kilocode/workflows
Qwen Code	CLI	TOML	.qwen/commands
opencode	CLI	Markdown	.opencode/command
Gemini CLI	CLI	TOML	.gemini/commands
Auggie CLI	CLI	Markdown	.augment/commands
Google Antigravity	IDE	Markdown	.agent/workflows

When you run apm init, simply select your AI assistant from the list, and APM will automatically configure the appropriate command structure for your environment.

Getting Started

Follow these simple steps to start using APM in your project:

• Navigate to your project directory in your terminal.

• Run the APM initialization command:

  apm init
  

  By default, apm init automatically finds and installs the latest template version compatible with your current CLI version. To install a specific template version (e.g., for rollbacks or testing), you can use the --tag option:

  apm init --tag v0.5.0+templates.1
  

• Select your AI assistant when prompted (e.g., Cursor, Copilot, Claude Code, etc.).

• APM automatically installs:

  • .apm/ directory with APM guides and initial assets
  • APM slash commands in your AI assistant's command directory
  • Necessary installation meta-data

• Open your AI assistant chat and enter the slash command:

  /apm-1-initiate-setup
  

• Follow the established APM workflow:
  Setup Phase (Project Discovery & Planning) → Task Loop Phase (Plan Execution)

For step-by-step guidance with video coverage, see the Getting Started Guide. For detailed CLI behavior and policies, see the CLI Guide.

Documentation

Full documentation is available at agentic-project-management.dev

APM v0.5 includes comprehensive documentation covering all aspects of the framework:

Document	Description
Introduction	Overview of APM concepts, goals, and core framework
Getting Started	Step-by-step setup and first session guide
Agent Types	Different agent roles and specializations
Workflow Overview	Complete workflow walkthrough with process diagrams
Token Consumption Tips	Cost optimization strategies and model recommendations
Modifying APM	Customization of APM assets and advanced features
Troubleshooting Guide	Troubleshooting for common issues
Context & Memory Management (advanced)	How APM handles context and manages memory across agent instances
Context & Prompt Engineering (advanced)	Prompt and context engineering techniques used throughout the framework
CLI Guide	Detailed CLI usage, behaviors, policies

For a complete documentation index with recommended reading order, visit the Documentation Hub.

Contributing

APM is an open-source project, and your contributions are welcome! Whether it's improving prompts, enhancing documentation, suggesting new features, or reporting bugs, please feel free to open an issue or submit a pull request.

Ways to contribute:

• Report bugs or workflow issues
• Suggest features or improvements
• Improve documentation
• Share customizations/adaptations for specific domains or use-cases
• Extend support for new AI assistants

Areas particularly seeking contributions:

• Assistant Support: Help expand APM support for additional AI assistants beyond the ones currently supported.
• Ad-Hoc Delegation Guides: The framework includes Debug and Research delegation guides, but there's opportunity to create specialized guides for other context-intensive tasks such as testing automation, security analysis, data extraction and more.
• Workflow Optimizations: Share improvements to agent protocols or memory system enhancements.

Please read CONTRIBUTING.md for details on the code of conduct and contribution process.

Versioning Strategy

APM uses a dual versioning system to separate updates to the core CLI tool from updates to the agent prompts and guides (templates). The CLI follows Semantic Versioning on NPM, while template updates are released via GitHub Releases using build metadata. This allows for frequent template improvements without unnecessary CLI version bumps.

For a detailed explanation of the versioning, tagging, and release process, please see the VERSIONING.md file.

License

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for full details.

License Update: MIT → MPL-2.0

As APM has matured from an experimental framework into a comprehensive multi-agent coordination system with growing commercial interest, its license has been upgraded from MIT to Mozilla Public License 2.0 (MPL-2.0). This change helps protect the Open Source Software community while maintaining full commercial compatibility.

What this means: APM remains completely free and Open Source for all uses (personal, commercial, enterprise). You can build proprietary products using APM, integrate it into commercial IDEs, and create paid services around it. The only requirements are that improvements to core APM files must be shared back with the community, and that you attribute the creators and the APM project as required by the MPL 2.0 license. Make sure to read the LICENSE file for full details.