devkit

README

devkit

AI-powered dev workflow toolkit. Extracts a self-correcting CI/agent loop into a reusable scaffold for any Go project.

What it does

• council — runs parallel AI roles (strict critic, creative explorer, analyst, security reviewer, performance analyst) against your branch diff and synthesizes a weighted health score
• review — single-pass AI diff review focused on a configurable concern area
• meta — designs and runs parallel agents for any freeform task against your repo context
• ci-agent — standalone binary that diagnoses failed CI jobs and opens/updates issues automatically (GitHub and Gitea)

Requirements

• Go 1.23+
• An ANTHROPIC_API_KEY (council, review, meta); optionally OPENAI_API_KEY and GEMINI_API_KEY for ci-agent fallback
• gum for the interactive installer

Install

curl -fsSL https://raw.githubusercontent.com/89jobrien/devkit/v0.0.1/install.sh | bash

Or clone and run locally:

git clone https://github.com/89jobrien/devkit
cd devkit
bash install.sh

The installer will:

1. Ask which components and CI platform(s) to enable
2. Install the devkit and ci-agent binaries via go install
3. Write .devkit.toml in your project root
4. Copy the appropriate CI workflow file (.github/workflows/ci.yml or .gitea/workflows/ci.yml)
5. Install git hooks (pre-push runs devkit review, post-commit reminds you about devkit council)
6. Write Claude Code hooks to .claude/settings.json so devkit review runs after file edits

Usage

# Multi-role branch analysis
devkit council --base main --mode core
devkit council --base main --mode extensive   # adds security + performance roles

# AI diff review
devkit review --base main

# Run parallel agents on any task
devkit meta "find all places where we do not validate user input"
echo "audit the auth layer" | devkit meta

All commands log to ~/.dev-agents/<project>/.

Configuration

.devkit.toml (generated by install.sh):

[project]
name        = "my-project"
description = "What it does"
install_date = "2026-01-01"
ci_platforms = ["github"]

[components]
council  = true
review   = true
meta     = true
ci_agent = true

[review]
focus = "security, performance, correctness"

[council]
mode = "core"

CI integration

The CI templates in ci/ include:

• A diagnose job that runs ci-agent automatically on any CI failure, opening a GitHub/Gitea issue with an AI diagnosis
• A bump-version job (GitHub only) that increments the patch version in VERSION on every successful push to main

Upgrading

bash upgrade.sh

Architecture

Hexagonal Go: each internal package (council, review, meta, loop, tools, platform, log) defines a Runner or Platform interface. Concrete implementations are wired at the cmd/ layer. No package imports another's concrete type.

License

MIT