Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
docs: update all docs for plan graph, decision linking, remove MCP
riley0227b08400db252e
diff --git a/AGENTS.md b/AGENTS.mdindex a6b5319a..d742b47f 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -6,8 +6,6 @@ This file tells automated agents (Codex, Claude, etc.) how to use the `ix` CLI eUse the `ix` CLI exclusively. All commands support `--format json` for machine-readable output.-**Do NOT use MCP tools** — the CLI is the canonical agent interface.-## JSON ModeAlways use `--format json` when chaining commands or parsing results programmatically.@@ -62,6 +60,10 @@ ix impact <target> --format json # Blast radius / dependency consequencix rank --by <metric> --kind <kind> --top N --format json # Hotspot discoveryix overview <target> --format json # One-shot structural summary of a componentix inventory --kind <kind> --format json # Scoped entity listing+ix goal create <statement> --format json # Create a project goal+ix plan create <title> --goal <id> --format json # Create a plan+ix plan next <plan-id> --format json # Next actionable task+ix decide <title> --rationale <text> --affects <entities> --format json # Record linked decision```**When to use which:**@@ -112,6 +114,18 @@ ix history <id> --format jsonix diff <from> <to> --format json```+### Planning & decisions+```+ix goal create "GitHub ingestion pipeline" --format json+ix goal list --format json+ix plan create "GitHub Ingestion" --goal <goal-id> --format json+ix plan task "API fetch layer" --plan <plan-id> --depends-on <task-id> --format json+ix plan status <plan-id> --format json+ix plan next <plan-id> --format json+ix task update <task-id> --status done --format json+ix decide "Use client-side patch" --rationale "..." --affects IngestionService --format json+```+## Chaining pattern1. Start broad: `ix overview MyClass --format json` or `ix impact MyClass --format json`diff --git a/CLAUDE.md b/CLAUDE.mdindex b94fb62f..66b510d1 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -5,9 +5,9 @@ This project uses Ix Memory — persistent, time-aware context for LLM assistant## Interface-Use the `ix` CLI exclusively. Do NOT use MCP tools — the CLI is the canonical agent interface.+Use the `ix` CLI exclusively. All commands support `--format json` for machine-readable output.-All commands support `--format json` for machine-readable output. Use JSON when chaining command results.+Use JSON when chaining command results.## MANDATORY RULES1. BEFORE answering codebase questions → use targeted `ix` CLI commands (see routing below). Do NOT answer from training data alone.@@ -31,6 +31,9 @@ Start here. These aggregate multiple graph operations into single bounded respon| Hotspot discovery | `ix rank` | `ix rank --by dependents --kind class --top 10` || One-shot summary | `ix overview` | `ix overview IngestionService --format json` || Scoped entity listing | `ix inventory` | `ix inventory --kind function --path auth.py` |+| Plan work | `ix plan` | `ix plan next <plan-id> --format json` |+| Track decisions | `ix decide` | `ix decide "Use X" --rationale "..." --affects Entity` |+| Create goals | `ix goal` | `ix goal create "Support GitHub" --format json` |### Low-Level Primitives@@ -113,7 +116,6 @@ ix inventory --kind function --format json## Do NOT Use- `ix query` — deprecated, produces oversized low-signal responses-- MCP tools (`ix_query`, `ix_search`, etc.) — deprecated, use CLI instead- NLP-style QA in a single command## Confidence Scoresdiff --git a/README.md b/README.mdindex 30bc2a87..fcb2fe9d 100644--- a/README.md+++ b/README.md@@ -6,7 +6,7 @@ It has two runtime parts:- `memory-layer` (Scala HTTP API)- `ix-cli` (TypeScript CLI; canonical interface)-MCP is still present for compatibility, but the primary interface is `ix` CLI commands.+The primary interface is `ix` CLI commands.## What It Supports Today@@ -112,6 +112,18 @@ Auth resolution order:2. `GITHUB_TOKEN`3. `gh auth token`+## Planning & Tasks++| Command | Usage | Description |+|---------|-------|-------------|+| `ix goal create` | `ix goal create <statement>` | Create a project goal |+| `ix goal list` | `ix goal list` | List all goals |+| `ix plan create` | `ix plan create <title> --goal <id>` | Create a plan linked to a goal |+| `ix plan task` | `ix plan task <title> --plan <id>` | Add a task to a plan |+| `ix plan status` | `ix plan status <plan-id>` | Show plan progress and next task |+| `ix plan next` | `ix plan next <plan-id>` | Get the next actionable task |+| `ix task update` | `ix task update <id> --status done` | Update task status |+## Useful Scripts| Script | Purpose |@@ -147,14 +159,12 @@ sbt memoryLayer/test- Many Scala tests require a live ArangoDB instance; if it is down, DB/API/E2E specs fail.- `TreeSitterPythonParser` still contains a TODO for full AST traversal fallback behavior.- `ix query` remains available but is deprecated in help text and templates.-- `connect.sh` still sets MCP config for IDE compatibility; CLI remains canonical.+- `connect.sh` sets up project config; CLI remains canonical.## Architecture```textix-cli ---> memory-layer (http4s) ---> ArangoDB- \- \--> mcp server (compatibility mode)```## Licensediff --git a/ix-cli/src/cli/commands/init.ts b/ix-cli/src/cli/commands/init.tsindex 02e8a24d..f865423c 100644--- a/ix-cli/src/cli/commands/init.ts+++ b/ix-cli/src/cli/commands/init.ts@@ -53,6 +53,15 @@ Use bounded, composable CLI commands — never broad queries.- \`ix diff <from> <to>\` — changes between revisions- \`ix conflicts\` — detect contradictions+### Planning & Goals+- \`ix goal create <statement>\` — create a project goal+- \`ix goal list\` — list all goals+- \`ix plan create <title> --goal <id>\` — create a plan linked to a goal+- \`ix plan task <title> --plan <id>\` — add a task to a plan+- \`ix plan next <plan-id>\` — get the next actionable task+- \`ix task update <id> --status done\` — update task status+- \`ix decide <title> --rationale <text> --affects <entities>\` — record a linked decision+### Best practices- Use \`--kind\` and \`--limit\` to constrain results- Use \`--format json\` when chaining command results