Axiom¶

Agentic Decision Support System - OODA/RGRD workflow framework for capability-driven development.

Quick Install¶

curl -fsSL https://axiomcadence.io/install | bash

Prerequisites¶

Before installing Axiom, you'll need:

Zed Editor - Download and install Zed IDE
OpenCode - Install OpenCode CLI:
```
npm install -g @opencode/cli
```

Setup & Configuration¶

Shell Function (Optional but Recommended)¶

Add this to your ~/.zshrc or ~/.bashrc for easy launching:

zeda() {
  export OPENCODE_CONFIG_DIR="$(pwd)/.contributing"
  command zed "$@"
}

Then use: zeda . from any Axiom project directory.

Zed Settings (Required)¶

Add to ~/.config/zed/settings.json:

{
  "agent_servers": {
    "OpenCode": {
      "type": "custom",
      "command": "opencode",
      "args": ["acp"]
    }
  }
}

Full recommended settings (includes UI layout, theme, and formatting):

{
  "project_panel": {
    "dock": "right"
  },
  "agent": {
    "dock": "left"
  },
  "ui_font_size": 12,
  "buffer_font_size": 12,
  "theme": {
    "mode": "system",
    "light": "One Light",
    "dark": "Gruvbox Dark Soft"
  },
  "prettier": {
    "allowed": true,
    "tabWidth": 2,
    "bracketSpacing": false
  },
  "agent_servers": {
    "OpenCode": {
      "type": "custom",
      "command": "opencode",
      "args": ["acp"]
    }
  }
}

See Installation Guide for detailed setup instructions.

What is Axiom?¶

Axiom is an implementation of the Agentic Decision Support System using Zed IDE + OpenCode + GitHub Copilot Models. It provides a structured approach to capability development through the OODA (Observe, Orient, Recommend, Align) workflow with built-in memory management and agent coordination.

Features¶

Multi-agent coordination via RACI framework (12+ agents)
OpenCode Skills for on-demand agent/framework loading (90% context reduction)
Workflow completeness enforcement with 37 step memories and automated validation
Session-per-phase architecture for 95% token reduction and optimal context retention
Persistent memory with compacted phase memories (≤250-900 tokens per phase)
Automated validation script for workflow completeness checks
OODA/RGRD workflows for strategy and development
Enhanced CAPTURE phase with original prompt preservation and verb-noun naming
IDE integration with Zed and OpenCode
Clear file navigation through AGENTS.md entry point

OODA Workflow¶

CAPTURE → OBSERVE → ORIENT → RECOMMEND → ALIGN
  (6 steps) (8 steps) (11 steps) (8 steps) (4 steps)

Phase	Duration	Steps	Step Memories	Key Output
CAPTURE	~10 min	6	6 required	idea.md
OBSERVE	30-45 min	8	8 required	job-definition.md
ORIENT	40-60 min	11	11 required	problem-statement.md
RECOMMEND	45-60 min	8	8 required	recommendation.md
ALIGN	25-35 min	4	4 required	capability-thesis.md, workflow-summary.md

Total: 37 steps, 37 step memories (150-250 tokens each)
Session-Per-Phase: Recommended for 95% token reduction (75,000 → 3,500 per phase)

Available Agents¶

Core Workflow Agents¶

Agent	Phase	Accountable For
@analyst	OBSERVE	job-definition.md
@ux-researcher	OBSERVE	Interviews
@problem-framer	ORIENT	problem-statement.md
@strategic-planner	RECOMMEND	Solution strategy
@creative-solutions	RECOMMEND	Hypotheses generation
@evaluator	RECOMMEND	Prioritization
@strategic-recommender	RECOMMEND	recommendation.md
@senior-product-manager	ALIGN	capability-thesis.md
@execution-planner	ALIGN	execution-plan.md
@alignment-facilitator	ALIGN	Alignment process

Supporting Agents¶

@workflow-manager - Memory and state management
@quality-assurance - Validation and compliance

Strategic Frameworks¶

JTBD - Jobs-to-be-Done for outcome discovery
RICE - Reach, Impact, Confidence, Effort prioritization
Kano - Feature classification model
Blue Ocean - Value innovation strategy
SCAMPER - Creative solution generation
Toulmin - Argumentation method for recommendations

License¶

MIT License - See LICENSE.md for details.