Project Manager API
Relevant source files
The following files were used as context for generating this wiki page:
The Project Manager API coordinates project lifecycles, agent delegations, and task tracking within the NeXifyAI platform. It functions as the central management layer for orchestrating work across multiple tenants and specialized AI agents.
Sources: services/api/agents/skill_registry/skills/project-manager/SKILL.md, services/api/agents/brain_agents/project-manager.md
System Architecture
The Project Manager operates within the NeXifyAI Agent Mesh. It integrates with the Workflow Orchestrator and the NeXifyAI Brain to manage project history and current execution states.
Core Components
- Orchestration Layer: Manages workstreams across 4 tenants and 7 GitHub repositories.
- Skill Registry: Provides access to core capabilities like task decomposition and risk management.
- Brain Integration: Interfaces with Qdrant and SQLite-based "Brain" databases for context injection and lesson persistence.
Sources: services/api/agents/brain_agents/project-manager.md, services/api/agents/skill_registry/skills/project-manager/SKILL.md
Data Flow Diagram
The following diagram illustrates the flow of a project request through the management system.
API Endpoints
The system exposes RESTful endpoints via the external API v1 and internal admin routes for managing project resources.
| Endpoint | Method | Scope | Description |
|---|---|---|---|
/api/v1/projects | GET | projects:read | Lists all projects with pagination and status filters. |
/api/v1/projects/{id} | GET | projects:read | Retrieves detailed information for a specific project. |
/api/admin/projects | GET | Admin | Internal list of projects including milestone details. |
Sources: services/api/routes/api_v1_routes.py:161-164, services/api/routes/nexify_ai_routes.py:440
Project Execution Workflow
Project execution follows a "Brain-First" mandate. Before starting any action, the Project Manager must query the Qdrant nexifyai_brain collection to verify lessons, credibility warnings, and past execution outcomes.
Delegation Matrix
The Project Manager delegates specific sub-tasks to specialized agents:
| Task Category | Assigned Agent |
|---|---|
| Work Breakdown | task-decomposition-expert |
| Infrastructure | cloud-architect, deployment-engineer |
| Code Quality | review-agent, fullstack-developer |
| Security | security-engineer, security-auditor |
| Documentation | documentation-expert |
Sources: services/api/agents/brain_agents/project-manager.md:46-52
Order Lifecycle States
Every project task moves through a strictly defined state machine managed by the workflow system:
Constraints and Compliance
The Project Manager must adhere to the Operational Constitution E3.5 and DOS v2.1 standards. It is forbidden from creating tasks that require external automation tools like n8n or Zapier, favoring internal autonomous execution.
- Mandatory Reporting: Every action must include
mission_alignment(direct/indirect/none) and acustomer_outcomedescription. - Credibility Check: Entries with a
quarantine_score> 0.7 in the Brain are automatically flagged and rejected.
Sources: services/api/agents/brain_agents/project-manager.md:16-25, services/api/agents/brain_agents/project-manager.md:55-63
Conclusion
The Project Manager API serves as the operational hub of NeXifyAI. It ensures that all platform-level planning and execution remain consistent with the project's primary mission: making customer work faster and safer through autonomous orchestration.