pmp-tool/poc/README.md

FlowPilot Agent Orchestration PoC

This proof-of-concept demonstrates the core agent orchestration ideas from the FlowPilot PRD:

Core Concepts Demonstrated

1. HR Manager Agent: Decomposes high-level tasks into atomic tasks and creates executor agents
2. Experience Manager Agent: Logs executions, provides context, and maintains a knowledge base
3. Atomic Task Decomposition: Breaking down complex tasks into single-agent-completable units
4. Agent Lifecycle Management: Dynamic creation of executor agents for specific task types

How to Run

python3 agent_poc.py

Output

The PoC processes three sample high-level tasks from the project management handbook:

• Creating a project charter
• Identifying software development risks
• Creating a project schedule

For each task, it shows:

• How the HR Manager decomposes the task into atomic tasks
• How executor agents are created for each atomic task type
• How the Experience Manager logs executions and provides context
• The final results and execution logs

Next Steps for Development

1. Replace simulation with actual LLM calls - Integrate with OpenAI/Anthropic/etc APIs
2. Add real task execution - Instead of mock results, have agents actually perform tasks
3. Implement persistence - Store agent configurations, execution logs, and knowledge base in database
4. Add feedback loops - HR Manager improves based on execution scores
5. Integrate with Feishu - Build the actual frontend and Feishu bot interfaces

Files

• agent_poc.py: Main PoC implementation
• poc_results.json: Detailed execution results from the last run
• .gitignore: Git ignore file

Design Notes

This PoC focuses on demonstrating the orchestration logic rather than actual AI execution. In a real implementation:

• The _simulate_execution method would call actual LLM APIs
• Agents would have specific prompt templates for their task types
• The Experience Manager would use vector embeddings for context retrieval
• Task decomposition would be more sophisticated (possibly using LLMs themselves)

Relation to PRD

This PoC validates the core architectural concepts from PRD v0.2:

• Dual agent management (HR Manager + Experience Manager)
• Atomic task decomposition
• Agent lifecycle management
• Context sharing and knowledge base

It does not yet cover:

• Feishu integration
• Full PMBOK process coverage
• Production-level error handling and scaling
• Actual LLM provider integration