About apex
apex is a repository-based agent workflow skill for implementing changes through analysis, planning, execution, validation, review, and handoff. It structures work with checkpoints, configurable options, and evidence-based completion criteria.
Key features
- 01Structured implementation steps
- 02Configurable review, tests, and runtime proof
- 03Persist and resume run checkpoints
- 04Bounded delegation with scope and evidence
- 05Preserve unrelated local changes
Use cases
- 01Plan and implement a repository change
- 02Resume an interrupted implementation
- 03Coordinate independent work and inspect its diff
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ melvynx/ aiblueprint --skill apexAfter installing, type/apexin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
agents/openai.yamlassets/codex-icon.svgscripts/apex-state.pysetup-templates.shtest_apex_state.pyupdate-progress.shsteps/step-00-init.mdstep-00b-branch.mdstep-00b-economy.mdstep-00b-interactive.mdstep-00b-save.mdstep-01-analyze.mdstep-02-plan.mdstep-02b-tasks.mdstep-03-execute-teams.mdstep-03-execute.mdstep-04-validate.mdstep-05-examine.mdstep-06-resolve.mdstep-07-tests.mdstep-08-run-tests.mdstep-09-finish.mdstep-10-verify.mdDetails
From the project READMEImplement through Analyze → Plan → Execute → eXamine. The task contract, repository state, authority, and evidence are the source of truth.
Load only the current step and any reference it names. Start with steps/step-00-init.md. Persist run state with scripts/apex-state.py under .agents/apex/runs/<run-id>/. Never store secrets in run state.
Flags express intent; they do not force a vendor implementation. -a/-A interaction low/standard. -x/-X review adversarial/risk-based. -s/-S artifacts verbose/minimal. -t/-T new tests on/off. -v/-V runtime proof on/off. -e/-E budget low/standard. -b/-B branch on/off. -pr/-PR pull request on/off. -i configure interactively. -k/-K expanded artifacts on/off. -m/-M prefer-parallel/direct. -r <id> resume a checkpoint.
- Contract —
steps/step-00-init.md(interactive00b-interactive, branch00b-branch, budget00b-economy, artifacts00b-save) - Analyze —
steps/step-01-analyze.md - Plan —
steps/step-02-plan.md(expanded graph02b-tasks) - Execute —
steps/step-03-execute.md(teams03-execute-teams) - Validate —
steps/step-04-validate.md - Examine / resolve —
steps/step-05-examine.md,steps/step-06-resolve.md - Tests when required —
steps/step-07-tests.md,steps/step-08-run-tests.md - Prove when required —
steps/step-10-verify.md - Handoff —
steps/step-09-finish.md
Delegate only bounded, independent work. Record objective, allowed files, forbidden scope, done evidence, and stop condition. Returned work is untrusted until the coordinator inspects the diff. Re-plan when evidence invalidates an assumption. Preserve unrelated local changes.
Finish only when the requested implementation is present, acceptance criteria have current evidence, introduced failures are resolved, required review is done, and delivery actions have authoritative read-back.