Skip to main content
Introduction | AEPTyped, executable rules for agent-performed engineering work.AEPreferenceaepreferenceadopterdevelopertry-spec-driven-developmentunderstand-safe-agentic-codingreference

Agentic Engineering Protocol

AEP is a Rust library, a CLI, and a set of typed document formats for running engineering work under rules a program can execute.

You write principles such as “tests must pass,” “verification must be independent,” or “production changes require approval” as validated data. A deterministic engine resolves those rules against a task and its evidence. The result says what is permitted, what is owed, and why progress is blocked.

One substrate, two profiles

ProfileGoverns
AEPartifacts, planning, workflows, evidence, permissions, approvals, audit, and completion
ADPspecification, decomposition, design, tests, implementation, and review
AOPoperational plans, controlled change, verification, rollback, and incidents

ADP and AOP use AEP's planning and evidence substrate; they do not implement separate engines.

The command

aep is canonical. protocol is an exact compatibility alias for existing automation.

aep govern validate
aep plan artifact board
aep govern explain --action production.write
aep observe trace check --spec expectations.trace.yaml --transcript run.jsonl

The CLI also includes a reference driver. It proves the harness contract has a real caller but does not choose a model, credential, endpoint, or plugin. Harness-specific skills and agents are not in this repository. They come from the sibling repository beyond10x/agentplugins, which publishes the beyond10x marketplace, and they are supplied explicitly.

In Claude Code that is /plugin marketplace add beyond10x/agentplugins followed by /plugin install aep-plan@beyond10x (also aep-drive@beyond10x and ess-specify@beyond10x). In Codex, add the same GitHub repository as a marketplace from the Plugins surface. The agent plugins install page carries the current list.

What lives elsewhere

Executable System Specification tooling is a standalone project. ESS publishes its own conformance report and has no AEP dependency. The optional AEP-side adapter converts that report into ess_conformance evidence without core AEP compiling against ESS modeling types.

Continue

GoalRead
run the CLIGetting started
understand the architectureArchitecture overview
govern a taskGovern a task
integrate a harnessIntegrate an agent harness
install the agent pluginsbeyond10x/agentplugins
inspect a complete exampleA governed task, end to end
understand evidenceEvidence
see current delivery stateWhere this stands

Source: github.com/beyond10x/aep.