Acceptance-Driven Agentic Coding

Acceptance first. Agents second.

ADAC Skills turns AI coding from plausible patch generation into evidence-backed engineering delivery. Define context, boundaries, acceptance checks, and human gates before implementation expands.

$ npx skills add HaloForgeAI/adac-skills --skill adac
Context
source paths, business rules, incidents, logs, tests
Spec
target behavior, non-goals, stable interfaces, fallback
Evals
behavior, regression, performance, lifecycle evidence
Gates
architecture, concurrency, security, rollout decisions

A delivery contract for AI coding agents.

ADAC is broader than TDD and stricter than prompt guidelines. It asks agents to produce reviewable acceptance evidence, not just code that compiles.

01

Context

Make the system, business rules, history, and known risks available before generation.

02

Spec

Define target behavior, non-goals, boundaries, and fallback before implementation.

03

Evals

Turn real risks into behavior, regression, performance, lifecycle, and observability checks.

04

Gates

Reserve architecture, concurrency, security, release, and residual-risk calls for people.

Where ADAC helps.

Use it when agent output is fast but correctness depends on engineering judgment, historical regressions, or release safety.

Critical Path

Async resource loading

Before code, ADAC asks for lifecycle checks, same-scene timing, logs, telemetry, and concurrency gates.

High Impact

Checkout coupon path

ADAC classifies payment changes upward, then requires pricing invariants, audit evidence, and security/product gates.

Team Asset

Incident workflow skill

ADAC turns one-off incident fixes into reusable skills with evidence collection and approval boundaries.

Install and validate.

The repository is shaped for portable `SKILL.md` installation, Claude Code plugin packaging, Codex plugin packaging, and npm publishing.

# portable skills CLI
npx skills add HaloForgeAI/adac-skills --skill adac

# local validation
npx skills add . --list
# plan validation
npx adac-skills validate examples/worker-module.adac.md

# npm publish after login
npm publish --access public