Skip to content

MAVERICK AI DEV STACKContext before code. Evidence before merge.

A local-first engineering workflow for AI-assisted development that keeps intent, context, verification evidence, and human review connected from task to PR.

WHY MAVERICK

AI writes. Engineers decide.

Maverick makes the work around a change visible: the problem, relevant context, plan, evidence, and review decision.

Explicit boundaries

Small briefs say what changes, what does not, and how completion is verified.

Inspectable context

Targeted paths and local conventions replace repository-wide guessing.

Human review gate

Evidence and the diff support the decision to merge.

WORKFLOW / CORE

One workflow, any assistant.

01BRIEF
02CONTEXT
03PLAN
04BUILD
05VERIFY
06REVIEW
07PR
QUICK START

First value in a few minutes.

maverick / project shell
$ npx maverick-ai-dev-stack init
✓ project initialized: .maverick/config.json

$ npx maverick-ai-dev-stack task add-pagination
✓ task created: .maverick/tasks/add-pagination

$ npx maverick-ai-dev-stack validate add-pagination
PASS required artefacts and sections are present (warnings may remain).
ARTEFACTS

Brief. Context. Evidence.

TASK BRIEF

Scope before code

Problem, goal, constraints, and verification make intent reviewable.

CONTEXT PACK

Only useful context

Architecture, paths, rules, and commands give an agent a bounded start.

VERIFY / REVIEW

Evidence before merge

Tests, security checks, and a human decision close the loop.

ADAPTERS / LAB / OPEN SOURCE

Keep the workflow portable.

Claude Code, Codex, Cursor, and generic agents can read the same artefacts. The Lab helps teams test a workflow carefully; it does not manufacture benchmark claims.

Why Maverick ​

An agent can produce a diff quickly; engineering confidence comes from making the intent, relevant context, scope, checks, and review decision inspectable. Maverick is the workflow around the coding agent, not a competing agent or model.

text
Without: prompt → agent → diff → “looks good”
With:    intent → context → plan → build → verify → review → PR

Core capabilities ​

  • Preset-driven task artifacts for lightweight through strict-review work.
  • Repository mapping, textual impact lookup, and focused task packets.
  • Recorded command evidence, diff and scope review, dependency and security signals.
  • Policy checks, handoffs, merge readiness, local adapters, and a local Lens dashboard.

Maverick Lens ​

Inspect tasks, documentation, Git state, available commands, and workflow signals from a local dashboard—without uploading the repository. Start with maverick dashboard --open, then read the Lens guide or the feature announcement.

Quickstart ​

bash
npx maverick-ai-dev-stack init
npx maverick-ai-dev-stack map
npx maverick-ai-dev-stack task add-orders-pagination --preset standard
npx maverick-ai-dev-stack packet add-orders-pagination --agent codex

Continue with Getting started. AI writes; engineers decide.