Skip to content

Commit 89b2d2a

Browse files
tercelclaude
andcommitted
docs: fix architecture diagram — apcore is embedded, not a middle layer
apcore is not a separate layer between AI agents and apflow. It's embedded inside apflow as the mechanism that makes orchestration capabilities AI-perceivable (like CAN bus makes car systems perceivable to FSD, not a layer between driver and car). Updated: README architecture diagram, CLAUDE.md dependency description. Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
1 parent a20f226 commit 89b2d2a

File tree

2 files changed

+33
-13
lines changed

2 files changed

+33
-13
lines changed

CLAUDE.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,10 @@ apflow is NOT an AI product. It is a deterministic, reliable orchestration engin
1818
- **app.py**: Bootstrap factory — `create_app()` initializes full stack
1919
- **cli.py**: Entry points — `apflow serve`, `apflow mcp`, `apflow info`
2020

21-
### Key Dependencies
22-
- `apcore`Schema-enforced AI-perceivable module standard
23-
- `apcore-mcp`MCP server (AI agents discover and invoke orchestration)
24-
- `apcore-a2a`A2A server (services invoke orchestration via HTTP)
21+
### Key Dependencies (embedded, not external layers)
22+
- `apcore`Module standard embedded inside apflow (like CAN bus in a car)
23+
- `apcore-mcp`Protocol adapter: exposes modules as MCP tools
24+
- `apcore-a2a`Protocol adapter: exposes modules as A2A skills
2525
- `apcore-cli` — CLI generation (humans operate orchestration)
2626

2727
## Core Principles

README.md

Lines changed: 29 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -117,18 +117,38 @@ Every orchestration capability is automatically exposed as an apcore Module:
117117
## Architecture
118118

119119
```
120-
AI Agents (bring your own — Claude, Gemini, LangGraph, any)
121-
↓ invoke via MCP / A2A / CLI
122-
apcore (Module Standard — makes everything AI-perceivable)
120+
AI Agents / Services / Humans
121+
↓ discover & invoke
123122
124-
apflow (This project — deterministic orchestration engine)
125-
├─ Task Orchestration (dependency graphs, priority, parallel)
126-
├─ Durable Execution (checkpoint, retry, circuit breaker)
127-
├─ Cost Governance (budget, policy, downgrade)
128-
├─ Distributed Runtime (leader election, leasing)
129-
└─ Storage (SQLite / PostgreSQL)
123+
┌──────────────────────────────────────────────┐
124+
│ apflow — AI-Perceivable Distributed │
125+
│ Orchestration Engine │
126+
│ │
127+
│ ┌── Protocol Exposure (apcore) ───────────┐ │
128+
│ │ apcore-mcp · apcore-a2a · apcore-cli │ │
129+
│ │ ↕ │ │
130+
│ │ apcore Registry (Modules) │ │
131+
│ └──────────────┬──────────────────────────┘ │
132+
│ │ │
133+
│ ┌──────────────▼──────────────────────────┐ │
134+
│ │ Orchestration Core │ │
135+
│ │ TaskManager · TaskCreator · Scheduler │ │
136+
│ │ Dependency Graphs · Priority · DAG │ │
137+
│ ├─────────────────────────────────────────┤ │
138+
│ │ Durability │ Governance │ │
139+
│ │ Checkpoint │ Budget · Policy │ │
140+
│ │ Retry │ Model Downgrade │ │
141+
│ │ Circuit Break │ Usage Reporting │ │
142+
│ ├─────────────────────────────────────────┤ │
143+
│ │ Infrastructure │ │
144+
│ │ SQLite/PostgreSQL · Distributed Runtime│ │
145+
│ │ ConfigManager · Adapters │ │
146+
│ └─────────────────────────────────────────┘ │
147+
└──────────────────────────────────────────────┘
130148
```
131149

150+
apcore is not a separate layer — it's embedded inside apflow as the mechanism that makes orchestration capabilities AI-perceivable (like a CAN bus makes car systems perceivable to FSD).
151+
132152
## Built-in Executors
133153

134154
| Executor | Purpose |

0 commit comments

Comments
 (0)