agile-project-mcp/docs/core-concepts.md
2025-07-13 13:40:41 +01:00

2.5 KiB

Core Concepts

The Big Idea 💡

Imagine having a whole software development team working for you - but they're all AI agents. That's what Agile Project MCP does. Instead of one AI trying to do everything (and getting confused), we split the work among specialized AI team members, just like a real development team.

Why Multiple AI Agents?

Think about it: Would you ask one person to be the Product Owner, Developer, QA Engineer, and Project Manager all at once? Probably not! Here's why we use multiple specialized agents:

🧠 Less confusion - Each agent focuses on their specific job 🎯 Better results - Agents get really good at their specialised tasks 📊 Easy to track - You always know which agent did what 🔧 Customisable - Fine-tune each agent for their specific role

Quick Example

When you say "Build me a todo app", here's what happens:

  1. The Product Owner agent breaks down your request into user stories
  2. The Developer agents pick up the coding tasks
  3. The QA Engineer tests everything works
  4. The Project Manager keeps everyone on track

How It All Works Together

The server is like the team's shared workspace. It:

  • Keeps everyone organised - Manages the task board, backlogs, and project files
  • Provides the right tools - Each agent gets tools specific to their role
  • Enforces the process - Makes sure everyone follows proper Agile practices
  • Stores everything - All project data lives in simple YAML/JSON files you can inspect

Key Principles Made Simple

1. Tools Built for AI 🛠️

The API isn't meant for humans to click around - it's designed for AI agents to use as tools. Each endpoint is an action an agent can take (like "move this task to testing").

2. Right Tool for the Right Job 🎨

A Product Owner doesn't need coding tools, and a Developer doesn't need to manage the backlog. Each role gets exactly what they need.

3. Single Source of Truth 📚

The server keeps track of everything - no confusion about what's done, what's in progress, or who's working on what.

4. Process on Rails 🚂

By limiting what each agent can do, we ensure they follow proper Agile practices automatically. No shortcuts, no confusion.

Want to Learn More?