audit-docs
Audit cross-document coherence: docs ↔ READMEs ↔ roadmap ↔ code ↔ fix index ↔ issues. Finds drift — features in docs/ not in the…
@gtrabancoInstall SkillDevelopment
Skill
/runner-contract
The distributable runner's invocation contract: one train-stamped pin for every runtime command the workflow's skills cite. Referenced by the skills that run sensors, guards and ceremony operations; never a menu entry.
Claude Code
$ npx -y skills add gtrabanco/agentic-workflow --skill runner-contract --agent claude-code
Codex
$ npx skills add gtrabanco/agentic-workflow --skill runner-contract -a codex -y
Cursor
$ npx skills add gtrabanco/agentic-workflow --skill runner-contract -a cursor -y
Gemini CLI
$ npx skills add gtrabanco/agentic-workflow --skill runner-contract -a gemini-cli -y
GitHub Copilot
$ npx skills add gtrabanco/agentic-workflow --skill runner-contract -a github-copilot -y
OpenCode
$ npx skills add gtrabanco/agentic-workflow --skill runner-contract -a opencode -y
Windsurf
$ npx skills add gtrabanco/agentic-workflow --skill runner-contract -a windsurf -y
SKILL.md
runner-contract.SKILL.mdname: runner-contract
user-invocable: false
version: 4.10.0
author: "Gabriel Trabanco <1969593+gtrabanco@users.noreply.github.com>"
license: MIT
description: >
The distributable runner's invocation contract: one train-stamped pin for
every runtime command the workflow's skills cite. Referenced by the skills
that run sensors, guards and ceremony operations; never a menu entry.
Runner contract (internal)
The workflow's deterministic layer ships as **one npm package**, not as scripts inside a skill folder: `@gtrabanco/agentic-workflow`, invoked with `bunx` or `npx` at a version that travels with the skills. A target project installs the skills and gets every command they cite, with no clone of this repository.
[RUNNER.md](references/RUNNER.md) is that contract's one home: the canonical invocation, the version pin, the subcommand map and the exit codes. **The pin lives there and nowhere else** — a skill cites the runner and points at RUNNER.md for the version, so a release stamps one file instead of thirteen.
What a skill cites
A skill that runs a runner command states the command with the pin written as a placeholder and names this contract beside it:
bunx @gtrabanco/agentic-workflow@<pin> <subcommand> [args...]
`<pin>` is read from [RUNNER.md](references/RUNNER.md) — never restated, never guessed, never replaced by `latest`. A skill that hard-codes a version re-opens the per-release manual edit this contract exists to remove, and `scripts/normative-drift.test.mjs` fails closed on a pin that drifts from the crate's own version.
What it covers
Every runtime command a skill cites: the sensors (`workflow-status`, `phase-lint`, `diff-guard`, `pre-execution-snapshot`, `needs-input`, `ledger-provenance`), the router (`unit-route`) and the ceremony CLI (`ceremony <object> <op>`). The repository keeps its own authoring gates (`check-skill-context`, `local-gate`, `release`, `test-impact`, …) — those never ship, and no skill cites them.
Authority
- The bin's surface: `packages/agentic-workflow/bin/agentic-workflow.mjs`.
- The subcommand table: `packages/agentic-workflow/src/runner/cli.mjs`.
- The crate's README: `packages/agentic-workflow/README.md` (one Commands row
per subcommand, asserted by `test/cli.surface.test.mjs`).
- The pin: [RUNNER.md](references/RUNNER.md), stamped by
`scripts/release.mjs` at cut time.
Read more
name: runner-contract user-invocable: false version: 4.10.0 author: "Gabriel Trabanco <1969593+gtrabanco@users.noreply.github.com>" license: MIT description: > The distributable runner's invocation contract: one train-stamped pin for every runtime command the workflow's skills cite. Referenced by the skills that run sensors, guards and ceremony operations; never a menu entry.
Runner contract (internal)
The workflow's deterministic layer ships as **one npm package**, not as scripts inside a skill folder: `@gtrabanco/agentic-workflow`, invoked with `bunx` or `npx` at a version that travels with the skills. A target project installs the skills and gets every command they cite, with no clone of this repository.
[RUNNER.md](references/RUNNER.md) is that contract's one home: the canonical invocation, the version pin, the subcommand map and the exit codes. **The pin lives there and nowhere else** — a skill cites the runner and points at RUNNER.md for the version, so a release stamps one file instead of thirteen.
What a skill cites
A skill that runs a runner command states the command with the pin written as a placeholder and names this contract beside it:
bunx @gtrabanco/agentic-workflow@<pin> <subcommand> [args...]
`<pin>` is read from [RUNNER.md](references/RUNNER.md) — never restated, never guessed, never replaced by `latest`. A skill that hard-codes a version re-opens the per-release manual edit this contract exists to remove, and `scripts/normative-drift.test.mjs` fails closed on a pin that drifts from the crate's own version.
What it covers
Every runtime command a skill cites: the sensors (`workflow-status`, `phase-lint`, `diff-guard`, `pre-execution-snapshot`, `needs-input`, `ledger-provenance`), the router (`unit-route`) and the ceremony CLI (`ceremony <object> <op>`). The repository keeps its own authoring gates (`check-skill-context`, `local-gate`, `release`, `test-impact`, …) — those never ship, and no skill cites them.
Authority
- The bin's surface: `packages/agentic-workflow/bin/agentic-workflow.mjs`.
- The subcommand table: `packages/agentic-workflow/src/runner/cli.mjs`.
- The crate's README: `packages/agentic-workflow/README.md` (one Commands row
per subcommand, asserted by `test/cli.surface.test.mjs`).
- The pin: [RUNNER.md](references/RUNNER.md), stamped by
`scripts/release.mjs` at cut time.
Stats
23
Stars
4
Forks
Active
Maintenance
JavaScript
Language
MIT
License
Last commit
Created
Ships withagentic-workflow
A reusable set of agent skills that run a disciplined, doc-driven workflow for building software with agents — from idea/issue to a reviewed, classified, merge-ready change.
2330 skills
Stars on GitHub
Momentum
- stars in total
- 23
Other skills on agentic-workflow.
@gtrabancoInstall Skillaudit-pr
Audit a whole PR against the delivery contract and return MERGE-READY or evidenced blockers with the full URL. Consumes the…
@gtrabancoInstall Skillbatch-scheduler
Deterministic batch planner: read the live work graph and emit parallel-execution batches (order-respecting, collision-free) as…
@gtrabancoInstall Skilldiscover-repository-st…
Discover repository evidence and write a frozen Normalized Repository State. Produces verified repository evidence and keeps…
@gtrabancoInstall Skillexecute-phase
Step executor for units whose triage (unit-lane) decided which steps the unit needs. Implements one triaged step (or all…
@gtrabancoInstall Skillfold-findings
Repair persisted fix-now findings in compatible atomic batches: root-cause fixes, green gate, commit/push, and per-row `folded:…
@gtrabancoInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about runner-contract.
- Which coding agents can use runner-contract?
- runner-contract installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.