ados

Agentic Delivery OS (ADOS)

Turn AI from "chat assistance" into a repeatable, auditable delivery system:

ticket -> spec -> plan -> test plan -> code -> /review -> /sync-docs -> /check -> /pr -> release

This repo is a practical reference implementation of a spec-driven workflow using OpenCode (and supporting Claude Code):

• Artifacts are first-class (versioned in Git), not trapped in chats.
• Deterministic quality gates define "done".
• The workflow is tracker-agnostic: the tracker owns status, Git stores the delivery artifacts.
• The repo maintains a continuously updated "current system spec" under doc/spec/** (created if missing; reconciled after each accepted change).

Note: doc/spec/** may not exist in a fresh repo; it's created/updated by the workflow (see /sync-docs).

• Agentic Delivery OS (ADOS)
  • Why this exists
  • What this gives you
  • Installation
    • Quick Start
      • For Claude Code users
    • Installation Modes
    • Tool Selection (OpenCode only)
  • Benefits
  • Intention
  • Docs at a glance
  • What is implemented here
  • Multi-tool support
  • Autopilot (PM-driven)
  • Typical workflow (manual)
  • Change artifacts (tracker-agnostic)
  • Repo structure
  • License
  • Author

Why this exists

AI can generate code quickly, but most teams struggle to use it reliably at scale:

• Prompts live in DMs and chat logs (not versioned, not repeatable)
• Output quality varies day-to-day ("prompt roulette")
• Delivery still needs specs, acceptance criteria, test strategy, reviews, docs, release discipline
• Tooling glue work persists between Jira/Git/CI/docs

Agentic Delivery OS codifies a predictable pipeline where quality and traceability are non-negotiable.

What this gives you

• A team of 19 repo-local agents aligned to SDLC roles (PM, spec writer, planner, coder, reviewer, bootstrapper, and more).
• A standard artifact set (spec, implementation plan, test plan) stored under doc/changes/ using stable, tracker-linked names.
• A versioned, human-readable system spec under doc/spec/** that acts as the baseline input for planning the next change (kept up to date via /sync-docs).
• Commands that compose those agents into repeatable workflows (manual or autopilot).

Installation

Quick Start

For OpenCode users:

# Global (all projects)
curl -fsSL https://raw.githubusercontent.com/juliusz-cwiakalski/agentic-delivery-os/main/scripts/install.sh | bash -s -- --global

# Local (current project)
~/.ados/repo/scripts/install.sh --local

Then in your AI coding agent:

/bootstrap                                  # AI-guided configuration

For Claude Code users

Recommended: Install from GitHub marketplace

# Step 1: Add ADOS marketplace (one-time setup)
/plugin marketplace add juliusz-cwiakalski/agentic-delivery-os

# Step 2: Install ADOS plugin
/plugin install ados@ados

This uses the git-subdir source to load ADOS directly from the GitHub repository.

For local development (contributors):

claude --plugin-dir .ados-claude

This loads ADOS directly from the local repo — useful for contributors testing changes.

Installation Modes

Mode	OpenCode Target	Claude Code Target
--global	~/.config/opencode/	Use /plugin marketplace add
--local	./.opencode/	claude --plugin-dir .ados-claude

Tool Selection (OpenCode only)

--tool opencode    # OpenCode only (default)
--tool claude      # Not needed - use /plugin commands instead
--tool all         # Not needed - install separately per tool

Uninstall: ~/.ados/repo/scripts/uninstall.sh --global or ~/.ados/repo/scripts/uninstall.sh --local