# sdi2200262/agentic-project-management architecture

> Architecture diagram of the GitHub repository sdi2200262/agentic-project-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sdi2200262/agentic-project-management
- Repository: https://github.com/sdi2200262/agentic-project-management

## Overview

##### Project Type and Purpose
– APM is an open-source framework that orchestrates a team of AI agents (Manager Agent + Implementation Agents), coordinates a persistent Memory Bank, and integrates with IDE-specific rules to manage complex projects beyond LLM context limits.

##### File Structure to Discover Architectural Components
- prompts/
– Contains the core prompt assets for Manager and Implementer Agents (initiation prompts, implementation-plan guides, memory-bank guides, handover protocols).
- docs/
– Holds user-facing documentation and workflow overviews (architecture explanations, integration guides).
- rules/
– Cursor IDE integration rules that “persist” scoped instructions for agents.
- assets/
– Visual assets (e.g., apm-graph).
- Memory Bank (runtime directory structure managed by the agents)
– Not explicitly in repo, but dynamically created by the Manager Agent to store logs, context, and handover artifacts.

##### Extract Key Architectural Roles from the README
– User/Developer: Initiates the system by launching the Manager Agent with the initiation prompt.
– Manager Agent: Orchestrator.
– Implementation Agents: Specialized workers that execute tasks.
– LLM Service: External API (e.g., OpenAI) called by all agents.
– Memory Bank: Shared, file-based persistence layer.
– Cursor Rules: Optional integration layer for enhanced reliability in a Cursor IDE.

##### Main Components
A. User Interface (IDE or CLI)
– Developer pastes initiation prompt or triggers automation.
B. Manager Agent
– Reads prompts/docs, creates an Implementation Plan, writes initial Memory Bank structure.
C. Implementation Agents (one or many)
– Consume task-assignment prompts, call LLM, write outputs and logs back to Memory Bank.
D. Memory Bank (Filesystem)
– Persistent storage of project logs, handover artifacts, unlogged directives.
E. External LLM Service
– Provides language-model responses to every agent request.
F. Prompt Library (prompts/ directory)
– Source of all structured prompts for agents.
G. Documentation & Assets (docs/, assets/)
– Reference material for agents and users.
H. IDE Integration Rules (rules/)
– Optional “always-on” instructions for Cursor users to reinforce context.

##### Relationships and Data Flows
1. Developer → Manager Agent: “Initiation Prompt”
2. Manager Agent → Prompt Library + docs/: retrieves guides
3. Manager Agent ↔ Memory Bank: initialize directories, write Implementation Plan, read/write logs
4. Manager Agent → Implementation Agents: issue “Task Assignment Prompts”
5. Implementation Agents → External LLM Service: get task output
6. Implementation Agents ↔ Memory Bank: append logs, deliver handover artifacts
7. Manager & Implementers ↔ IDE Integration Rules: (if using Cursor) continuously reinforced

##### Architectural Patterns and Design Principles
– Orchestration Pattern: a single Manager coordinates multiple workers.
– Separation of Concerns: prompts/docs/rules are decoupled from runtime logic.
– Pipeline & Persistence: Memory Bank acts as the stateful intermediate layer.
– Extensibility: prompt modules and rule sets can be replaced or extended for new workflows or IDEs.

## Diagram (Mermaid)

```mermaid
graph TB
    Dev["Developer / IDE"]:::user
    Mgr["Manager Agent"]:::agent
    Impl["Implementation Agents"]:::agent
    PL["Prompt Library\n(prompts/)"]:::static
    DA["Documentation & Assets\n(docs/, assets/)"]:::static
    RULES["IDE Integration Rules\n(rules/)"]:::static
    MB["Memory Bank\n(persistent storage)"]:::storage
    LLM["External LLM Service"]:::external

    Dev -->|"Initiation Prompt"| Mgr
    Mgr -->|"Fetch guides"| PL
    Mgr -->|"Fetch docs/assets"| DA
    Mgr -->|"Initialize & write Plan"| MB
    Mgr -->|"Issue Task Assignment Prompt"| Impl
    Mgr -->|"Read/Write Logs"| MB
    Mgr -->|"Reinforce Rules"| RULES
    Impl -->|"LLM API Call"| LLM
    Impl -->|"Append logs & artifacts"| MB
    Impl -->|"Reinforce Rules"| RULES

    click Dev "https://github.com/sdi2200262/agentic-project-management/blob/main/README.md"
    click PL "https://github.com/sdi2200262/agentic-project-management/tree/main/prompts/"
    click Mgr "https://github.com/sdi2200262/agentic-project-management/tree/main/prompts/00_Initial_Manager_Setup/"
    click Mgr "https://github.com/sdi2200262/agentic-project-management/tree/main/prompts/01_Manager_Agent_Core_Guides/"
    click Impl "https://github.com/sdi2200262/agentic-project-management/tree/main/prompts/02_Utility_Prompts_And_Format_Definitions/"
    click DA "https://github.com/sdi2200262/agentic-project-management/tree/main/docs/"
    click DA "https://github.com/sdi2200262/agentic-project-management/tree/main/assets/"
    click RULES "https://github.com/sdi2200262/agentic-project-management/tree/main/rules/"

    classDef agent fill:#ADD8E6,stroke:#000
    classDef static fill:#FFFF99,stroke:#000
    classDef storage fill:#90EE90,stroke:#000
    classDef external fill:#D3D3D3,stroke:#000
    classDef user fill:#FFE4E1,stroke:#000
```
