Skip to main content
Public BetaWe're in Public Beta. Things may break. Please report issues via the Support tab.

AI Plan Builder

Create a knowledge base for your project. AI coding tools use it while building.

How It Works: Plan First, Build With Context

1. Plan Builder Creates Knowledge

AI Plan Builder generates a structured knowledge base: decisions, architecture, issues, best practices. This is your project's "brain" - not code, but context.

2. AI Coding Tools Use It

When Claude Code, ChatGPT Codex, or Cursor writes code, they query ACE for context. They know your architecture, decisions, and patterns - and build accordingly.

Plan Builder = Creates the blueprint  →  AI Coding Tools = Build with the blueprint

What Gets Created
A searchable knowledge base your AI tools can query while coding

Describe your project, and the Plan Builder generates interconnected entities that form a knowledge graph. This isn't code - it's the context that helps AI tools write better code.

Instant Context

Project knowledge in seconds

Knowledge Graph

Linked decisions and architecture

Searchable

AI tools query via REST API

What Gets Created
The AI Builder generates all these entity types for your project

Issues

Features to build, bugs to fix, tasks to complete

Decisions

Architectural choices with rationale and alternatives

Architecture

System components, technology stack, data flow

Best Practices

Guidelines and recommended patterns

Patterns

Reusable design patterns and solutions

Tags

Categorization and filtering labels

Relationships

Links between all entities in knowledge graph

How It Works
Simple API endpoint for bulk plan import
1

Send Your Project Description

Make a POST request to /api/v1/{namespace}/plans/bulk with your project details and AI provider choice

curl -X POST http://localhost:7777/api/v1/my-project/plans/bulk \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": "E-commerce Platform",
    "description": "Build a modern e-commerce platform with React, Node.js, and PostgreSQL"
  }'

Uses your default AI provider from Settings. Configure your preferred model in Dashboard → Settings → AI Keys.

2

AI Generates Complete Plan

The AI analyzes your project and creates a comprehensive plan with all entity types, complete with context-aware content and logical relationships

3

Atomic Import to ACE

All entities are created in a single atomic transaction. If anything fails, the entire import rolls back - no partial data.

4

Visualize in Knowledge Graph

View your complete project plan in the interactive knowledge graph dashboard. See how all decisions, issues, and architecture relate to each other.

AI Provider Options
Choose the AI provider that works best for your use case

OpenAI

Best for: Structured plans, detailed technical decisions

"ai_provider": "openai"

Anthropic Claude

Best for: Long-context projects, complex architecture

"ai_provider": "anthropic"

Google Gemini

Best for: Fast generation, cost-effectiveness

"ai_provider": "google"

Configure your preferred model in Dashboard → Settings → AI Keys. ACE uses your configured model or falls back to the latest available.

Example: Building a Feature
See the full workflow from plan to code
1

Create Plan (Dashboard or CLI)

"Build a user authentication system with OAuth, JWT, and role-based permissions"

→ Plan Builder creates: Architecture (auth flow), Decisions (JWT vs sessions), Best Practices (security), Issues (tasks)

2

Start Coding with Claude Code / Codex

You: "Implement the login endpoint"

AI queries ACE: GET /api/v1/my-project/decisions?q=authentication
AI queries ACE: GET /api/v1/my-project/architecture?q=auth
AI queries ACE: GET /api/v1/my-project/best-practices?q=security
3

AI Writes Code With Context

The AI knows to use JWT (from decisions), follows your auth flow (from architecture), and applies security best practices (from best-practices) - all without you repeating yourself.

When to Use Plan Builder
Best scenarios for creating a knowledge base

New Projects

Before writing code, generate the knowledge base. AI tools will have context from day one.

New Features on Existing Projects

Adding a feature? Generate a plan that adds to your existing knowledge. AI sees the full picture.

Document Existing Codebases

Describe what your codebase does. Plan Builder creates the knowledge base, so AI tools understand your existing code.

Team Alignment

Multiple developers? The knowledge base ensures everyone's AI tools follow the same decisions and patterns.

Remember: Plan Builder creates knowledge, not code. The value comes when AI coding tools query this knowledge while building. Use it from the dashboard for planning, or from CLI where your AI tools can immediately start using it.