Autonomous Organization Framework

You say what you want - System organizes it completely autonomously

A complete autonomous organization system for OpenCode - works for ANY project type: Software, Events, Personal, Business.

---

Quick Start

# Create project folder and install (one command!)
mkdir my-project && cd my-project && curl -fsSL https://raw.githubusercontent.com/mguttmann/autonomous-org-framework/main/install.sh | bash

# Start OpenCode
opencode

Or even shorter - run from any empty folder:

curl -fsSL https://raw.githubusercontent.com/mguttmann/autonomous-org-framework/main/install.sh | bash

That's it! Now just describe what you want:

• "Build me a todo app with authentication"
• "Plan my wedding in June"
• "Launch a marketing campaign"

---

What's Included

Component	Count	Description
Agents	33	From CEO to Developer - each with specific expertise
Tools	24	TypeScript tools for GitHub, state, safety, DCP, notifications
Commands	22	Slash commands - most trigger automatically
Skills	76	Reusable workflows and processes
Plugin	1	Master enforcement - injects rules into EVERY LLM call

---

v2.0 Features

Feature	Description
Dynamic Context Pruning	6 strategies to optimize token usage
Magic Keywords	Say ultrawork, ultrathink, or boulder anywhere
Background Delegations	Fire-and-forget research with persistent results
Subagent Management	Spawn, complete, and recall isolated subagents
Todo Enforcer	Sessions can't end with uncompleted todos
ENV Guard	Blocks .env file writes
OS Notifications	Native notifications (macOS/Linux/Windows)
Git Worktrees	Isolated worktrees for parallel agent work

---

Prerequisites

Requirement	Install
OpenCode	npm install -g opencode or see opencode.ai
Bun	curl -fsSL https://bun.sh/install | bash
GitHub CLI	brew install gh then gh auth login

---

Installation Options

Option 1: One-Line Install (Recommended)

mkdir my-project && cd my-project
curl -fsSL https://raw.githubusercontent.com/mguttmann/autonomous-org-framework/main/install.sh | bash

Option 2: Add to Existing Project

cd your-existing-project
curl -fsSL https://raw.githubusercontent.com/mguttmann/autonomous-org-framework/main/install.sh | bash

The installer will warn if the folder is not empty and ask for confirmation.

Update Existing Installation

curl -fsSL https://raw.githubusercontent.com/mguttmann/autonomous-org-framework/main/update.sh | bash

Updates framework files (agents, tools, plugins) while preserving your project files.

---

How It Works

The Autonomous Flow

YOU SAY                              SYSTEM DOES
─────────────────────────────────────────────────────────────
"Build a todo app"            →  GitHub Project + Issues created
                                 @architect → @developer → @qa
                                 PR created and merged

"Plan my wedding"             →  Labels: venue, catering, guests
                                 @project-manager → @coordinator
                                 Timeline and tasks created

"Fix the login bug"           →  @debugger investigates
                                 @developer fixes
                                 @qa-engineer verifies

Agent Hierarchy (33 Agents)

STRATEGIC    @ceo @cfo @cto @cpo @cmo           "What & Why?"
     ↓
TACTICAL     @product-director @engineering-director   "When & Who?"
     ↓
OPERATIONAL  @engineering-manager @product-manager     "Which sprint?"
     ↓
EXECUTION    @architect @developer @designer @qa       "Build it!"
     ↓
SUPPORT      @reviewer @verifier @debugger             "Is it good?"

Magic Keywords (v2.0)

Keyword	Effect
ultrawork	Maximum effort - parallel agents, strict todos
ultrathink	Deep analysis - explore all edge cases
boulder	Never give up - retry failures, push through

Example: "Build a todo app ultrawork" activates maximum effort mode.

---

Commands

Most Common

Command	Description
/status	Show current progress
/continue	Resume from last checkpoint
/checkpoint	Save state before ending
/verify	Check if goals are met
/review	Invoke @reviewer

v2.0 Commands

Command	Description
/init	Auto-analyze codebase, generate docs
/ledger	Create session continuity ledger
/search	Search delegations, extractions, ledgers

Auto-Triggered

Trigger	Action
"Build X"	GitHub setup → Agents invoked
After 100+ lines	@reviewer enforced
Session end	Checkpoint saved
PR merged	Issue auto-closed

---

File Structure

your-project/
├── opencode.json              # Configuration
├── AGENTS.md                  # Main instructions
│
└── .opencode/
    ├── agents/                # 33 Agent definitions
    ├── tools/                 # 24 TypeScript tools
    ├── commands/              # 22 Commands
    ├── plugins/               # Master plugin
    │   └── projekt-planer.ts  # THE BRAIN
    ├── skills/                # 76 Workflows
    └── templates/             # File templates

---

Context Optimization (DCP)

Strategy	Description
deduplication	Remove duplicate outputs
supersede_writes	Keep only latest file versions
purge_errors	Remove failed tool calls
discard_ephemeral	Prune verbose bash/grep/read outputs
extract	Extract key findings, discard originals
auto	Apply all strategies automatically

---

Customization

Add Custom Agent

.opencode/agents/my-agent.md:

---
description: What this agent does
mode: subagent
model: anthropic/claude-sonnet-4-20250514
tools:
  read: true
  write: true
---

You are a specialized agent for [task].

Add Custom Tool

.opencode/tools/my-tool.ts:

import { tool } from "@opencode-ai/plugin"

export default tool({
  description: "What this tool does",
  args: {
    input: tool.schema.string(),
  },
  async execute(args) {
    return `Result: ${args.input}`
  },
})

Add Custom Command

.opencode/commands/my-command.md:

---
description: What this command does
---

Do something with $ARGUMENTS.

---

Troubleshooting

Problem	Solution
"WORKFLOW BLOCKED"	Describe what you want - system sets up automatically
GitHub not working	Run gh auth login
Tools not loading	Run cd .opencode && bun install
High token usage	Use /checkpoint, start new session, /continue

Bypass Plugin (Not Recommended)

mv .opencode/plugins/projekt-planer.ts .opencode/plugins/projekt-planer.ts.disabled

---

Links

• OpenCode - OpenCode CLI
• Report Issues

---

License

MIT License - Use freely, attribution appreciated.