Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

docs: update all docs for plan graph, decision linking, remove MCP

riley0227b08400db252e
diff --git a/AGENTS.md b/AGENTS.md
index 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 e
Use 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 Mode
Always use `--format json` when chaining commands or parsing results programmatically.
@@ -62,6 +60,10 @@ ix impact <target> --format json # Blast radius / dependency consequenc
ix rank --by <metric> --kind <kind> --top N --format json # Hotspot discovery
ix overview <target> --format json # One-shot structural summary of a component
ix 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 json
ix 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 pattern
1. Start broad: `ix overview MyClass --format json` or `ix impact MyClass --format json`
diff --git a/CLAUDE.md b/CLAUDE.md
index 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 RULES
1. 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 Scores
diff --git a/README.md b/README.md
index 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
```text
ix-cli ---> memory-layer (http4s) ---> ArangoDB
- \
- \--> mcp server (compatibility mode)
```
## License
diff --git a/ix-cli/src/cli/commands/init.ts b/ix-cli/src/cli/commands/init.ts
index 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