{"id":28768369,"url":"https://github.com/cyberlife-coder/agile-planner-mcp-server","last_synced_at":"2026-01-27T14:49:13.504Z","repository":{"id":291318736,"uuid":"977219517","full_name":"cyberlife-coder/agile-planner-mcp-server","owner":"cyberlife-coder","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-02T00:41:28.000Z","size":1354,"stargazers_count":3,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-07T13:35:40.032Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyberlife-coder.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-03T17:37:51.000Z","updated_at":"2026-01-02T00:41:25.000Z","dependencies_parsed_at":"2025-05-04T17:36:58.956Z","dependency_job_id":"7383e2dd-8ef7-4326-8e99-bb064dffa407","html_url":"https://github.com/cyberlife-coder/agile-planner-mcp-server","commit_stats":null,"previous_names":["cyberlife-coder/agileplanner","cyberlife-coder/agile-planner-mcp","cyberlife-coder/agile-planner-mcp-server"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/cyberlife-coder/agile-planner-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberlife-coder%2Fagile-planner-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberlife-coder%2Fagile-planner-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberlife-coder%2Fagile-planner-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberlife-coder%2Fagile-planner-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyberlife-coder","download_url":"https://codeload.github.com/cyberlife-coder/agile-planner-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberlife-coder%2Fagile-planner-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28815380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T12:25:15.069Z","status":"ssl_error","status_checked_at":"2026-01-27T12:25:05.297Z","response_time":168,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-17T13:03:02.965Z","updated_at":"2026-01-27T14:49:13.498Z","avatar_url":"https://github.com/cyberlife-coder.png","language":"JavaScript","funding_links":["https://buymeacoffee.com/wiscale","https://buymeacoffee.com/wiscale)!"],"categories":["Task and Project Management"],"sub_categories":[],"readme":"[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cyberlife-coder-agile-planner-mcp-server-badge.png)](https://mseep.ai/app/cyberlife-coder-agile-planner-mcp-server)\n\n# Agile Planner MCP Server (v1.7.3) - AI-Powered Agile Backlog Generator\n\n[![smithery badge](https://smithery.ai/badge/@cyberlife-coder/agile-planner-mcp-server)](https://smithery.ai/server/@cyberlife-coder/agile-planner-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/cyberlife-coder/agile-planner-mcp-server/blob/main/LICENSE) \n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io) \n[![Windsurf Ready](https://img.shields.io/badge/Windsurf-Ready-brightgreen)](https://docs.windsurf.com/windsurf/mcp) \n[![Cascade Integrated](https://img.shields.io/badge/Cascade-Integrated-purple)](https://cascade.ai)\n[![npm version](https://img.shields.io/npm/v/agile-planner-mcp-server.svg?style=flat-square)](https://www.npmjs.com/package/agile-planner-mcp-server)\n[![GitHub Stars](https://img.shields.io/github/stars/cyberlife-coder/agile-planner-mcp-server?style=social)](https://github.com/cyberlife-coder/agile-planner-mcp-server)\n\n[\u003cimg alt=\"Install in Windsurf\" src=\"https://img.shields.io/badge/Windsurf-Windsurf?style=flat-square\u0026label=Install%20Agile%20Planner\u0026color=5fa8fb\"\u003e](#install-in-windsurf)\n[\u003cimg alt=\"Install in Cascade\" src=\"https://img.shields.io/badge/Cascade-Cascade?style=flat-square\u0026label=Install%20Agile%20Planner\u0026color=9457EB\"\u003e](#install-in-cascade)\n[\u003cimg alt=\"Install in Cursor\" src=\"https://img.shields.io/badge/Cursor-Cursor?style=flat-square\u0026label=Install%20Agile%20Planner\u0026color=24bfa5\"\u003e](#install-in-cursor)\n\n**Agile Planner MCP** automatically generates complete agile backlogs (Epics, User Stories, MVP, iterations) or specific features from a simple description, directly within Windsurf, Cascade, or Cursor, with no technical skills required.\n\n\u003e **Latest improvements (v1.7.3):**\n\u003e - **Correction du mode MCP pour generateFeature**: Amélioration robuste de l'extraction des user stories\n\u003e - **Structure RULE 3 renforcée**: Creation cohérente des dossiers epics/features/user-stories\n\u003e - **Résolution du problème Notepad sur Windows**: Normalisation des flux stderr/stdout en mode MCP\n\u003e - **Logs de diagnostic détaillés**: Identification plus facile des problèmes\n\u003e - **Restructuration du projet**: Organisation claire des fichiers de test et temporaires\n\u003e - **Mise à jour des guides d'utilisation**: Instructions complètes pour Windsurf, Claude et Cursor\n\u003e - See [CHANGELOG.md](./CHANGELOG.md) for full details.\n\u003e\n\u003e **Previous improvements (v1.7.1):**\n\u003e - **Refonte complète de la documentation MCP**: Documentation détaillée de l'architecture serveur MCP avec diagrammes Mermaid.\n\u003e - **Réduction de la complexité cognitive**: Refactorisation majeure des modules critiques (json-parser, mcp-router).\n\u003e - **Amélioration de la robustesse**: Meilleure gestion des erreurs et tests d'intégration E2E optimisés.\n\u003e - See [CHANGELOG.md](./CHANGELOG.md) for details.\n\n## ❌ Without Agile Planner MCP\n\nCreating agile backlogs manually is time-consuming and error-prone:\n\n- ❌ Hours spent writing user stories, acceptance criteria, and tasks\n- ❌ Inconsistent formatting and structure across different projects\n- ❌ No clear implementation guidance for AI coding assistants\n- ❌ Manual prioritization and organization without strategic framework\n\n## ✅ With Agile Planner MCP\n\n### Gestion d’erreur centralisée\n- Tous les retours d’erreur des fonctions `generateBacklog` et `generateBacklogDirect` sont désormais formatés par `handleBacklogError` pour garantir l’uniformité du JSON et la robustesse de l’audit.\n- Les exemples d’erreur affichent le format : `{ success: false, error: { message: ... } }`\n\n\nAgile Planner MCP generates complete, structured agile backlogs with precise AI-guided annotations in seconds:\n\n- ✅ **Complete backlog structure** with epics, features, user stories, and orphan stories\n- ✅ **AI-optimized annotations** that guide implementation step-by-step\n- ✅ **Progress tracking** with task checkboxes and dependency management\n- ✅ **Centralized organization** in a dedicated `.agile-planner-backlog` folder\n- ✅ **Intelligent feature organization** that automatically associates features with relevant epics\n\n## 📑 Documentation\n\nThis documentation has been reorganized for better navigation:\n\n### User Guides\n- [Guide d'intégration MCP](./docs/guides/mcp-integration.md) - Guide d'intégration avec Claude, Cursor et Windsurf IDE\n- [Guide d'utilisation optimal](./docs/guides/optimal-usage-guide.md) - Guide d'utilisation détaillé\n- [Guide de migration](./docs/guides/migration-guide.md) - Guide pour migrer depuis les versions précédentes\n\n### Developer Documentation\n- [Développement](./docs/development/development.md) - Guide de développement\n- [Spécifications MCP](./docs/development/mcp-specification.md) - Spécification du protocole MCP\n- [Problèmes connus](./docs/development/KNOWN_ISSUES.md) - Liste des problèmes connus et dette technique\n- [Plan de refactorisation](./docs/development/REFACTORING-PLAN.md) - Plan détaillé de refactorisation du code\n- [Plan de refactorisation des tests](./docs/development/TEST-REFACTORING.md) - Plan de correction des tests\n- [Roadmap](./docs/development/ROADMAP.md) - Feuille de route des versions futures\n- [Architecture MCP](./docs/architecture/mcp-server-architecture.md) - Architecture complète du serveur MCP\n- [Système de génération Markdown](./docs/architecture/markdown-generation.md) - Architecture du générateur markdown\n- [Format du backlog](./docs/architecture/backlog-format.md) - Spécification du format JSON de backlog\n\n### Helper Functions\n- **createApiMessages(project)** - Génère la paire de messages système/utilisateur pour l'IA. Le paramètre `project` peut être une chaîne de type `\"Nom: description\"` ou un objet `{ name, description }`.\n\n\u003e **Note TDD** : Les assertions sur les erreurs doivent vérifier le format unifié `{ success: false, error: { message: ... } }`.\n\u003e Toute modification du format d’erreur nécessite la mise à jour des tests d’intégration.\n\n### Architecture Documentation\n- [Design](./docs/architecture/design.md) - Design général du projet\n- [Format de backlog](./docs/architecture/backlog-format.md) - Format du backlog généré\n- [Diagramme de validation de backlog](./docs/architecture/backlog-validation-diagram.md) - Diagramme de validation\n- [Compatibilité Multi-LLM](./docs/architecture/multi-llm-compatibility.md) - Compatibilité avec plusieurs LLMs\n\n## 🚦 Setting up in Windsurf / Cascade / Cursor\n\nAsk your administrator or technical team to add this MCP server to your workspace configuration:\n1. Copy `.env.example` to `.env` and fill in your `OPENAI_API_KEY` or `GROQ_API_KEY`.\n\n### Option 1: Using a local installation\n\n```json\n{\n  \"mcpServers\": {\n    \"agile-planner\": {\n      \"command\": \"node\",\n      \"args\": [\"D:/path/to/agile-planner/server/index.js\"],\n      \"env\": {\n        \"MCP_EXECUTION\": \"true\",\n        \"OPENAI_API_KEY\": \"sk-...\"\n      }\n    }\n  }\n}\n```\n\n### Option 2: Using the NPM package\n\n```json\n{\n  \"mcpServers\": {\n    \"agile-planner\": {\n      \"command\": \"npx\",\n      \"args\": [\"agile-planner-mcp-server\"],\n      \"env\": {\n        \"MCP_EXECUTION\": \"true\",\n        \"OPENAI_API_KEY\": \"sk-...\"\n      }\n    }\n  }\n}\n```\n\n## 🧠 How It Works\n\n1. **Describe your project** in plain English, providing as much detail as possible.\n\n   ```txt\n   SaaS task management system for teams with Slack integration, \n   mobile support, and GDPR compliance.\n   ```\n\n2. **Agile Planner MCP processes your description** through a robust validation pipeline:\n   - 🤖 Leverages OpenAI or Groq LLMs to generate the backlog structure\n   - 🧪 Validates the structure against a comprehensive JSON schema\n   - 🔍 Enhances features with acceptance criteria and tasks\n   - 📝 Organizes stories into epics and features\n   - 🏗️ Creates a complete directory structure with markdown files\n\n3. **Receive a fully structured agile backlog** in seconds:\n\n### Structure du dossier généré\n\n```\n.agile-planner-backlog/\n├── epics/\n│   └── [epic-slug]/\n│       ├── epic.md\n│       └── features/\n│           └── [feature-slug]/\n│               ├── feature.md\n│               └── user-stories/\n│                   ├── [story-1].md\n│                   └── [story-2].md\n├── orphan-stories/\n│   ├── [story-orpheline-1].md\n│   └── [story-orpheline-2].md\n└── backlog.json\n```\n\n\u003e **Note :** Les dossiers `planning/mvp` et `planning/iterations` sont supprimés. Toutes les user stories sont générées dans leur arborescence épics/features ou dans `orphan-stories` si elles ne sont rattachées à aucune feature/epic. Le fichier `backlog.json` ne contient plus de sections `mvp` ou `iterations`.\n\nAll files include AI-friendly instructions to guide implementation. See the [examples](./examples) folder for sample outputs.\n\n### Commands\n\nAgile Planner MCP supports the following commands:\n\n#### Generate a Complete Backlog\n```javascript\n// In Windsurf or Cascade\nmcp0_generateBacklog({\n  projectName: \"My Project\",\n  projectDescription: \"A detailed description of the project...\",\n  outputPath: \"optional/custom/path\"\n})\n\n// CLI\nnpx agile-planner-mcp-server backlog \"My Project\" \"A detailed description of the project...\"\n```\n\n#### Generate a Specific Feature\n```javascript\n// In Windsurf or Cascade\nmcp0_generateFeature({\n  featureDescription: \"A detailed description of the feature to generate\",\n  storyCount: 3,  // Optional: number of user stories to generate (min: 3)\n  businessValue: \"High\", // Optional: business value of this feature\n  iterationName: \"iteration-2\", // Optional: target iteration (default: 'next')\n  epicName: \"Optional Epic Name\", // Optional: specify an epic or let the system find/create one\n  outputPath: \"optional/custom/path\" // Optional: custom output directory\n})\n\n// CLI\nnpx agile-planner-mcp-server feature \"A detailed description of the feature to generate\"\n```\n\n## 🔄 Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `MCP_EXECUTION` | **Required** - Must be set to \"true\" for MCP mode | - |\n| `OPENAI_API_KEY` | OpenAI API key for generating backlog | - |\n| `GROQ_API_KEY` | Alternative Groq API key | - |\n| `DEBUG` | Enable debug mode for additional logs | false |\n| `TEST_MODE` | Enable test mode (mock generation) | false |\n| `AGILE_PLANNER_OUTPUT_ROOT` | Base directory for output | current dir |\n\n## 📜 License\n\nAgile Planner MCP Server is licensed under the MIT License with Commons Clause. See the LICENSE file for the complete license text.\n\n## 👥 Support\n\nFor support, please open an issue on the [GitHub repository](https://github.com/cyberlife-coder/agile-planner-mcp-server/issues) or contact your Windsurf/Cascade/Cursor administrator.\n\n---\n\n## ☕️ Support the Project\n\n\u003ca href=\"https://buymeacoffee.com/wiscale\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px; width: 217px;\" \u003e\n\u003c/a\u003e\n\nIf you find this project useful, you can support its development by buying me a coffee on [BuyMeACoffee](https://buymeacoffee.com/wiscale)!\n\n## 🚀 Get Windsurf\n\n\u003ca href=\"https://windsurf.com/refer?referral_code=8f4980f9ec\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Windsurf-Get%20250%20Bonus%20Credits-5fa8fb?style=for-the-badge\" alt=\"Get Windsurf with bonus credits\" \u003e\n\u003c/a\u003e\n\nThank you 🙏\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberlife-coder%2Fagile-planner-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyberlife-coder%2Fagile-planner-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberlife-coder%2Fagile-planner-mcp-server/lists"}