Autonomous Goal Compiler

A Codex skill that compiles broad owner intent into the smallest reusable autonomous execution contract that can safely pursue and prove the requested outcome.

It supports compact one-shot goals, durable Standard plans, and Full long-running contracts with proportionate skill activation, proof, handoff, and resume controls.

The canonical skill ID is autonomous-goal-compiler.

Boundary

The skill prepares an executable goal. It does not perform the project unless the user also explicitly requests immediate implementation.

It is an instruction-layer compiler, not a host scheduler. It can require skill resolution, activation receipts, completion gates, and resume behavior, but it cannot independently guarantee host-level skill activation or continuation.

Repository Layout

autonomous-goal-compiler/  Exact installable skill package
PACKAGE_SHA256SUMS         Package integrity manifest

Install

Clone the repository:

git clone https://github.com/oniivan/autonomous-goal-compiler.git
cd autonomous-goal-compiler

Install the skill package:

mkdir -p ~/.codex/skills/autonomous-goal-compiler
rsync -a --delete autonomous-goal-compiler/ ~/.codex/skills/autonomous-goal-compiler/

Restart Codex or open a fresh task so the installed skill inventory is reloaded.

Use

Explicitly invoke the skill:

$autonomous-goal-compiler compile this intent into a reusable autonomous one-shot goal.

The compiler selects the highest warranted mode:

• compact: one bounded workstream, one clear proof surface, no durable state needed;
• standard: several material stages or proof surfaces, with useful pause/resume state;
• full: long-running, source-heavy, delegated, compaction-risky, or difficult-to-prove work.

Specialist skills are selected only at material route, tranche, pivot, or proof boundaries. Required skills are re-resolved and reloaded before their executable stage.

Validate

Run the package validator:

PYTHONDONTWRITEBYTECODE=1 \
python3 autonomous-goal-compiler/scripts/validate_compiler_package.py \
  autonomous-goal-compiler

Run the deterministic package tests:

PYTHONDONTWRITEBYTECODE=1 \
python3 autonomous-goal-compiler/scripts/test_goal_compiler.py

Verify the published package snapshot:

shasum -a 256 -c PACKAGE_SHA256SUMS

These checks prove package and contract structure. They do not prove automatic runtime activation, mode-selection judgment, factual correctness, or owner usefulness.

The compiled-goal validator parses an intentionally strict package-local YAML subset, uses unfenced operative Markdown for structural checks and skill tokens, validates typed receipt fields, and fails closed on unsupported state syntax. It remains a structural validator rather than runtime or semantic proof.

Current Status

This repository publishes the reviewed package as of July 27, 2026. Its package-local static validator, stock skill shape validator, and 24 deterministic tests pass. Behavioral and activation evidence remains specific to the tested model, CLI version, execution surface, and prompts.

License

No license file is currently included.