Skip to content

Commit a391627

Browse files
initcronclaude
andcommitted
chore: archive v2.0 OpenAgentiX milestone
11 phases (13-23), 67 plans shipped over 12 days. Phase directories archived to .planning/milestones/v2.0-phases/. ROADMAP.md collapsed, PROJECT.md evolved, STATE.md updated. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 99df26a commit a391627

144 files changed

Lines changed: 93 additions & 28507 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.planning/PROJECT.md

Lines changed: 45 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -2,28 +2,12 @@
22

33
## What This Is
44

5-
An open-source (Apache 2.0) enterprise agent automation platform built in Rust. Organizations define expert agents in YAML — composing skills, tools, and MCP servers — then run them on cron, on events, or on demand. Single binary deployment, built-in cost tracking, multi-channel delivery (Slack, Teams, Telegram, Discord, WhatsApp), and a Svelte command center for fleet management.
5+
An open-source (Apache 2.0) enterprise agent automation platform built in Rust. Organizations define expert agents in YAML — composing skills, tools, and MCP servers — then run them on cron, on events, or on demand. Single binary deployment, built-in cost tracking, multi-channel delivery (Slack, Telegram, Discord), and a Svelte command center for fleet management. Agents authenticate via API keys or existing LLM subscriptions (Claude, ChatGPT, Gemini) through OAuth.
66

77
## Core Value
88

99
Let any technical organization automate operational tasks with AI agents — without writing Python, without managing infrastructure, without giving up control. Define in YAML, run as a binary, track costs, keep humans in the loop.
1010

11-
## Current Milestone: v2.0 OpenAgentiX
12-
13-
**Goal:** Transform AOF into an enterprise agent automation platform with YAML-first agent composition, skills + tools + MCP, scheduled/event-driven execution, cost tracking, and a Svelte command center.
14-
15-
**Target features:**
16-
- Rebrand to OpenAgentiX with new agent YAML spec
17-
- Skills composition system (composable capability packs)
18-
- Cron/event-driven agent triggers (not just chat)
19-
- Per-agent cost tracking + budgets (inspired by ClawWork)
20-
- OTel telemetry + agent traces
21-
- WASM sandbox for untrusted tools (inspired by IronClaw)
22-
- Approval workflows / human-in-the-loop
23-
- Smart model routing (complexity scoring)
24-
- Multi-channel gateway (Slack, Teams, Telegram, Discord, WhatsApp)
25-
- Svelte command center (agent builder, run history, costs, scheduler)
26-
2711
## Requirements
2812

2913
### Validated
@@ -41,80 +25,77 @@ Let any technical organization automate operational tasks with AI agents — wit
4125
- Session management with resume capability — v1.0
4226
- WebSocket control plane — v1.0
4327
- Production security (seccomp, capability dropping, credential audit) — v1.0
28+
- GitAgent-compatible agent directories with ReAct loop engine — v2.0
29+
- Skills composition with 8 built-in packs + WASM sandbox isolation — v2.0
30+
- Event-driven triggers (cron, webhook, GitHub, Jira, agent-to-agent) — v2.0
31+
- Multi-agent coordination with vector memory and semantic recall — v2.0
32+
- Per-call/run/agent cost tracking with budget enforcement — v2.0
33+
- OpenTelemetry traces/metrics with CLI trace viewer — v2.0
34+
- Security: SSRF protection, AES-256-GCM secrets, comprehensive audit trail — v2.0
35+
- Human-in-the-loop approval workflows (3 autonomy modes) — v2.0
36+
- Multi-channel gateway: Slack, Telegram, Discord bi-directional — v2.0
37+
- Svelte Command Center: dashboard, agent builder, cost charts, trace viewer, approval queue — v2.0
38+
- LLM subscription proxy: OAuth auth for Claude/ChatGPT/Gemini subscriptions — v2.0
39+
- kubectl-style `agentix` CLI with 15+ commands — v2.0
4440

4541
### Active
4642

47-
(Defined in REQUIREMENTS.md for v2.0)
43+
(Defined in REQUIREMENTS.md for next milestone)
4844

4945
### Out of Scope
5046

5147
- Agent personas / SOUL.md / personality system — pivoted away from "fun team" model
5248
- React Mission Control — replaced by Svelte command center
5349
- Squad Chat UI — not enterprise-relevant
54-
- Kanban / workflow builder UI — defer to v2.1+
55-
- Multi-tenancy / MSP isolation — v2.5 enterprise
56-
- SSO / SAML / LDAP — v2.5 enterprise
57-
- Mobile native app — web + messaging channels sufficient
58-
- Voice/talk mode — text-based for v2.0
50+
- Python SDK — Rust-native, no Python dependency is a differentiator
5951
- Public agent marketplace — security concerns, community registry first
6052
- A2A protocol — emerging standard, defer until stable
53+
- Voice/talk mode — text-based for enterprise automation
54+
- Mobile native app — web + messaging channels sufficient
6155

6256
## Context
6357

64-
**Previous milestone:** v1.0 "Humanized Interfaces" shipped 2026-02-22 (12 phases, 55 plans, 164K LOC). Proved the Rust + multi-channel architecture works. The persona/personality direction is being pivoted away from.
58+
**v1.0** shipped 2026-02-22: 12 phases, 55 plans, 164K LOC. Proved Rust + multi-channel architecture.
59+
**v2.0** shipped 2026-03-23: 11 phases, 67 plans, 78K LOC (rewrite). Enterprise pivot — GitAgent agents, skills, triggers, cost tracking, telemetry, security, approvals, multi-channel gateway, Svelte dashboard, OAuth subscription proxy.
60+
61+
**Total:** 23 phases, 122 plans across 2 milestones.
62+
63+
**Tech stack:** Rust (agentix-core, agentix-llm, agentix-mcp, agentix-runtime, agentix-memory, agentix-triggers, agentix CLI), SvelteKit 5 (Command Center), SQLite (persistence).
6564

6665
**Market landscape (researched 2026-03-12):**
6766
- Python-dominant (LangChain, LangGraph, CrewAI, Agno, AutoGen) — no Rust-native competitor
68-
- 45% of developers who try LangChain never use it in production (abstraction bloat)
67+
- 45% of developers who try LangChain never use it in production
6968
- 75% of enterprise leaders cite security/compliance as top AI priority
70-
- Enterprises need: cost tracking, audit trails, RBAC, event-driven triggers, deployment flexibility
71-
- MCP becoming standard (97M monthly SDK downloads). A2A emerging but nascent.
7269
- No framework does config-first + enterprise security + cost tracking + event-driven well
7370

74-
**Competitive inspiration:**
75-
- ClawWork: per-call/task/day cost tracking, quality thresholds, ROI metrics
76-
- OpenFang: "Hands" (pre-built domain-complete agents), 16-layer security, workflow orchestration
77-
- IronClaw: WASM sandbox, shared agentic loop, smart model routing, routines engine, cost guard
78-
- ZeroClaw: trait-driven architecture, research phase, AgentBuilder pattern
79-
80-
**Target users:**
81-
- Platform engineering teams (Netflix, Dropbox, Adobe scale)
82-
- SRE/DevOps teams (regulated industries — Visa, Morgan Stanley)
83-
- Startup CTOs (5-person team, need automation fast)
84-
- Enterprise architects (standardize agents across 15+ teams)
85-
- SI/MSP/GCC (manage agents for multiple clients)
86-
87-
**Example agents enterprises want to build:**
88-
- DBA optimizer (analyze RDS config, recommend/apply optimizations)
89-
- Cost anomaly detector (daily AWS cost analysis, alert on spikes)
90-
- Compliance scanner (CIS benchmark checks, file Jira tickets)
91-
- Security scanner (vulnerability detection, remediation tickets)
92-
- Self-healing infrastructure (detect + remediate common failures)
93-
- Deployment agent (canary rollouts with approval gates)
71+
**Target users:** Platform engineering teams, SRE/DevOps (regulated industries), startup CTOs, enterprise architects, SI/MSP/GCC.
72+
73+
## Key Decisions
74+
75+
| Decision | Rationale | Outcome |
76+
|----------|-----------|---------|
77+
| Rust single binary | No Python, no runtime deps, 180ms cold start, 40MB idle | ✓ Good |
78+
| YAML-first agent definition | Enterprises want declarative, version-controllable config | ✓ Good |
79+
| Svelte for command center | Lighter than React, better DX, user preference | ✓ Good |
80+
| Skills composition (not monolithic agents) | Build expert agents from capability packs | ✓ Good |
81+
| WASM sandbox for tools | Lightweight isolation without Docker overhead | ✓ Good |
82+
| OTel native telemetry | Standard, exportable to Grafana/Datadog/any backend | ✓ Good |
83+
| Smart model routing | Route simple->cheap, complex->expensive | ✓ Good |
84+
| Cost tracking built-in | Not an add-on. Per-call, per-task, per-agent | ✓ Good |
85+
| Pivot from personas to enterprise | Personality-driven agents don't solve enterprise problems | ✓ Good |
86+
| AES-256-GCM for secrets | Already in workspace, proven crypto | ✓ Good |
87+
| SQLite for all stores | Simple, embedded, zero-config persistence | ✓ Good |
88+
| OAuth subscription proxy | Reduce cost for users with existing LLM subscriptions | ✓ Good |
9489

9590
## Constraints
9691

9792
- **Language**: Rust for core engine. Svelte for command center.
9893
- **License**: Apache 2.0 — open source core, enterprise features later
9994
- **Architecture**: Single binary, local-first. Server mode for teams.
100-
- **CLI style**: kubectl-style (`oax run agent`, `oax apply -f agent.yaml`)
95+
- **CLI style**: kubectl-style (`agentix run agent`, `agentix apply -f agent.yaml`)
10196
- **No Python dependency**: Users should never need pip/venv/conda
102-
- **Backward compatibility**: Existing AOF agent YAML configs should still work
97+
- **Backward compatibility**: Existing AOF agent YAML configs still work
10398
- **Cross-platform**: macOS, Linux, Windows
10499

105-
## Key Decisions
106-
107-
| Decision | Rationale | Outcome |
108-
|----------|-----------|---------|
109-
| Rust single binary | No Python, no runtime deps, 180ms cold start, 40MB idle | — Pending |
110-
| YAML-first agent definition | Enterprises want declarative, version-controllable config | — Pending |
111-
| Svelte for command center | Lighter than React, better DX, user preference | — Pending |
112-
| Skills composition (not monolithic agents) | Build expert agents from capability packs, not one agent with 100 tools | — Pending |
113-
| WASM sandbox for tools | Lightweight isolation without Docker overhead, capability-based | — Pending |
114-
| OTel native telemetry | Standard, exportable to Grafana/Datadog/any backend | — Pending |
115-
| Smart model routing | Route simple→cheap models, complex→expensive. Cost optimization. | — Pending |
116-
| Cost tracking built-in | Not an add-on. Per-call, per-task, per-agent. Enterprise requirement. | — Pending |
117-
| Pivot from personas to enterprise | Personality-driven agents don't solve enterprise problems | ✓ Good |
118-
119100
---
120-
*Last updated: 2026-03-12 after v2.0 milestone start*
101+
*Last updated: 2026-03-23 after v2.0 milestone*

0 commit comments

Comments
 (0)