Maverick AI

An open-source project by Jhones Gonçalves

Maverick AI

Context before code. Evidence before merge.

Your AI agent writes the code. Maverick makes it mergeable. Turn an idea into a grounded plan, a task graph and verifiable evidence — with a human decision before merge.

Get startedGitHubDocumentation
Local-firstOpen sourceNode.js 20+MIT / CC BY-NC 4.0
MAVERICK LENS / INBOXExplore Lens
Maverick Lens local workspace with approval inbox, task status and recent runs

0.

Telemetry

9.

AI tools supported

11+.

Language stacks

3.

Workflow levels

BEYOND THE DIFF

AI writes. Engineers decide.

A fast diff is not enough. Maverick connects intent, scope, architecture and evidence so your team can answer what changed, why it changed and how it was verified. Built for real repositories, not disposable demos.

One workflow. Your preferred assistant.

Shared context. Portable artifacts.
  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • Gemini CLI
  • Kiro
  • Antigravity
  • OpenCode
  • Windsurf

INTENT → EVIDENCE → REVIEW

The right rigor for every change.

Three workflows, one pipeline. Maverick selects a starting workflow based on the idea — from everyday changes to critical systems.

Features, fixes & refactors

The core pipeline: understand the change, design against the real repository, build, verify and review before preparing the PR.

  1. 01PRD
  2. 02TECHSPEC
  3. 03TASKS
  4. 04BUILD
  5. 05VERIFY
  6. 06REVIEW
  7. 07PR

RECORDED ARTIFACTS

PRD.md · TECHSPEC.md · subtasks/ · EVIDENCE.md · REVIEW.md · PR-DRAFT.md

Maverick prepares the PR. It never merges. Accountability stays with the engineer.

Read the workflow

MAVERICK LENS

See what your agent is building.

A local cockpit for tasks, evidence and architecture. The actual project workspace, not a mockup.

Explore Lens
Decisions, in the right order. — Maverick Lens

Decisions, in the right order.

Pending approvals, failing gates and ready subtasks — with the next action beside each one.

127.0.0.1 · LOCAL

QUICK START

Your next idea. A better workflow.

Node.js 20+ · An existing repository · Your preferred AI tool

Installation guide
01

Initialize your repository

Run inside your project. Maverick interviews the repository and prepares shared skills for your AI tools.

npx @maverick-ai/cli init
02

Start with an idea

Create a task grounded in your code. Maverick selects a workflow and opens the agent at the planning stage.

npx @maverick-ai/cli new "Add cursor pagination to the orders endpoint"
03

Open Maverick Lens

Inspect tasks, gates, evidence and architecture in a workspace running on your own machine.

npx @maverick-ai/cli lens --open

Prefer a global install? npm install --global @maverick-ai/cli

Follow the first-task tutorial

BUILT IN THE OPEN

From my engineering practice. To your repository.

Jhones Gonçalves

Jhones Gonçalves

Staff Software Engineer · Software Architect

Maverick AI is where my work with architecture, developer experience and AI-assisted engineering becomes a reusable tool. The code and documentation are public: inspect the decisions, try it in your own repository and bring real feedback.

Explore the projectTalk to Jhones

Code: MIT · Documentation and content: CC BY-NC 4.0

PROJECT LINKS

Everything you need to go deeper.

Documentation

Installation, concepts and your first task.

GitHub Pages

Source code

Explore the code, examples and project history.

GitHub

CLI package

Install @maverick-ai/cli and check published versions.

npm

CLI reference

Commands, options, agents and flows.

CLI

Issues & feedback

Report a bug or discuss an improvement.

GitHub Issues

Releases

Follow releases and changes to the project.

GitHub Releases

FAQ

Before you start.

MAVERICK AI

Ship changes you can defend in review.

Visit Maverick AIRun your first task