agentic-workflow

Agentic Workflow

A multi-agent development workflow that orchestrates specialized AI agents through planning, implementation, and documentation phases. Supports custom crew definitions for any domain — software development, content creation, research, and more.

Supports Claude Code, GitHub Copilot CLI, Gemini CLI, OpenCode, Devin for Terminal, Droid (Factory.ai), and OpenAI Codex CLI.

New here? Check out the Visual Overview -- a jargon-free guide with diagrams, perfect for managers, team leads, and anyone curious about how it works.

Why Agentic Workflow?

Complex development tasks require multiple perspectives: architecture considerations, detailed planning, security review, edge case analysis, and careful implementation. Managing this manually with AI means constant context switching and oversight.

Agentic Workflow solves this by:

• Orchestrating specialized agents - Each agent has a focused role (planner, reviewer, implementer, quality guard, etc.)
• Maintaining human control - Configurable checkpoints let you review and approve at critical stages
• Supporting autonomous execution - Loop mode handles repetitive fix tasks while you sleep
• Preserving context - Gemini integration provides massive context analysis; state files enable resumption

Features

• Multi-agent architecture - Specialized agents for planning, implementation, review, quality, security, and documentation
• Custom crew definitions - Define custom roles and pipelines for any domain via YAML config (crew: section). Built-in software-dev crew is the default. See examples/crews/
• Single agent consultation - Quick /crew ask for second opinions without full workflow
• Workflow modes - Quick, standard, thorough modes for different task complexity (--mode)
• Human checkpoints - Control points for review and approval at each phase
• Loop mode - Autonomous iteration until tests/build pass (Ralph Wiggum-style)
• Effort levels - Per-agent thinking depth calibration mapped to Anthropic API parameters
• Server-side compaction - Auto-summarizes conversation context approaching limits
• Cost tracking - Per-agent token usage and cost tracking with compaction support
• Configuration cascade - Global → Project → Task → CLI overrides
• Gemini + Repomix integration - Large-context codebase analysis for research phases
• State management - Resume interrupted workflows from any point
• Model resilience - Automatic failover with exponential backoff across model fallback chain
• Git worktree support - Isolated parallel /crew workflows with Jira integration and custom post-setup commands
• Agent teams - Experimental parallel agent execution via Claude Code agent teams
• Beads integration - Optional issue tracking integration
• Technical documentation - Automatic AI-context documentation updates

Prerequisites

• Python 3.10+
• Git
• One (or more) of the supported AI coding platforms:

Platform	Install Guide
Claude Code	github.com/anthropics/claude-code
GitHub Copilot CLI	docs.github.com/copilot
Gemini CLI	github.com/google-gemini/gemini-cli
OpenCode	github.com/sst/opencode
Devin for Terminal	cli.devin.ai
Droid (Factory.ai)	factory.ai
OpenAI Codex CLI	github.com/openai/codex

Optional

• Repomix for intelligent file aggregation
• Beads for issue tracking

Installation

Claude Code

git clone https://github.com/Spiris-Innovation-Tech-Dev/agentic-workflow.git
cd agentic-workflow
./install.sh

Installs to:

• Commands → ~/.claude/commands/
• Agents → ~/.claude/agents/
• Scripts → ~/.claude/scripts/ (helper scripts referenced by agents/commands)
• Config → ~/.claude/workflow-config.yaml

GitHub Copilot CLI

git clone https://github.com/Spiris-Innovation-Tech-Dev/agentic-workflow.git
cd agentic-workflow
.\install-copilot.ps1

Installs to:

• Agents → .github/agents/ (repo-level) + ~/.copilot/agents/ (user-level)
• Config → ~/.copilot/workflow-config.yaml
• MCP server → Python package + ~/.copilot/mcp-config.json
• Instructions → .github/copilot-instructions.md

Gemini CLI

git clone https://github.com/Spiris-Innovation-Tech-Dev/agentic-workflow.git
cd agentic-workflow
./install-gemini.sh