Governed AI delivery · files-only

Let the model write the code. Keep the guarantees.

{ai} engineering drops a deterministic governance layer into any repo — specs, decisions, hooks, gates, and a hash-chained audit log, all as versioned local files you own. No hosted control plane. No telemetry by default. No lock-in to undo.

Install in under a minuteRead the source on GitHub

54 skills · 9 agents · 6 IDE surfaces · 1 governed flow

ai-eng — zsh
uv-first · under a minute
$ uv tool install ai-engineering   # install the CLI
$ ai-eng install .                 # add governance to your repo
$ ai-eng doctor
  [PASS] hooks · mirrors · manifest · required tools
$

Not a prompt pack. A governed delivery system.

Why governance

A deterministic plane that gates the probabilistic one

LLMs are fast and fallible. {ai}engineering puts a deterministic layer underneath them — hooks, gates, a hash-chained audit log, and a spec-lifecycle state machine — so the creative work stays probabilistic while everything that reaches a merge is checked, owned, and reproducible.

The judgment is yours; the guarantees are the framework's.

Everything below is how that holds — the flow, the enforcement, the toolkit.

  • PyPI version
  • Python 3.11+
  • CI
  • Quality Gate
  • Coverage
  • Snyk security
  • License: MIT
contributors
Contributors to arcasilesgroup/ai-engineering
star history
GitHub star history for arcasilesgroup/ai-engineering

The governed flow

One chain. Intent to merge, gated at every step.

You drive the intent and approve each handoff; deterministic gates block the rest — no secret, broken doc, or untested change reaches a merge. Big multi-concern specs swap/ai-build for /ai-autopilot automatically.

  1. /ai-brainstorm
  2. /ai-plan
  3. /ai-build
  4. /ai-pr
the governed workflow
The governed workflow: /ai-brainstorm to /ai-plan to /ai-build or /ai-autopilot to /ai-pr, with you approving each step and automatic checks — clean diff, tests, docs, review — gating the merge

See it run

One command in. A governed session out.

Press play: a real session installs the CLI, clears ai-eng doctorwith a [PASS], then runs the governed flow end to end — gates and all.

demo — ai-eng
Static by default — click to play. Honours reduced-motion preferences.

Why it holds

Governance that is enforced, not suggested.

Suppression comments are banned. Every bypass gets an owner and a TTL. Every tool call is screened before it runs, and every AI action is appended to a log you can verify offline — the rules hold whether or not anyone is watching the PR.

  • Ship a whole spec in one run

    /ai-autopilot decomposes it, builds a dependency DAG, runs parallel waves, and converges on a reviewed PR.

  • What you approved is what shipped

    a brainstorm hard-gate plus a spec-lifecycle state machine keep every change anchored to the approved spec (Rung 2 SDD — spec and code stay in sync, not just spec-first that drifts).

  • An audit trail you own

    every AI action lands in a hash-chained NDJSON log you can verify offline, with no telemetry by default.

  • Every bypass has an owner and an expiry

    no # noqa or @ts-ignore; findings are refactored or formally risk-accepted with a severity-based TTL.

  • Every tool call is screened before it runs

    a deterministic guard checks each edit, write, and shell command and stops risky ones.

  • AI quality is a tested property

    skills are measured with pass@k, and a regression beyond five points blocks the pull request.

The toolkit

Fifty-four skills, nine agents, one flow.

Plan, build, ship, review, research, document — each a /ai- command backed by an isolated agent context. Learn it once; it travels with the repo, identical on every surface.

  • 54skills
  • 9agents
  • 6surfaces
  • 1governed flow
skills · agents — taxonomy
Toolkit taxonomy: 54 skills and 9 agents grouped by activity — plan and build, ship safely, design and docs, research and learn — across 6 IDE surfaces

Same flow, every surface

  • Claude Code
  • GitHub Copilot
  • Codex
  • Antigravity
  • OpenCode
  • Cursor

Start now

Install once. Approve each step. Ship governed.

your editor — first session
your first session
› /ai-start
  [ready] context loaded · gates armed · audit live

Install with uv tool install ai-engineering, then open your editor and type/ai-start. Not ready to enforce? Run observe-only and switch on gates as they prove their worth. Update any time with ai-eng update — and if it is not for you, it is local files: delete the directory and you are out.

Get it on PyPIRead the docs