Multi-runtime agent workflow plugins for Claude Code and Codex.
This repository renders one source set into four self-contained plugins:
| Runtime | Adapter | Plugin path |
|---|---|---|
| Claude Code | GitHub | plugins/claude/epic-workflow-github/ |
| Claude Code | tkt | plugins/claude/epic-workflow-tkt/ |
| Codex | GitHub | plugins/codex/epic-workflow-github/ |
| Codex | tkt | plugins/codex/epic-workflow-tkt/ |
Each plugin includes seven skills:
adversarial-code-reviewadversarial-design-reviewepic-brainstormingepic-decompositionsubtask-planningteam-executionepic-completion
Claude plugins also include teammate agent definitions for implementer-standard, implementer-complex, and spec-reviewer.
Claude Code marketplace:
.claude-plugin/marketplace.json
Codex marketplace:
.agents/plugins/marketplace.json
Claude Code:
/plugin marketplace add wi-adam/agent-skills
/plugin install epic-workflow-github@wi-adam-skillsCodex:
codex marketplace add wi-adam/agent-skillsInstall Codex plugins through the Codex plugin manager after adding the marketplace.
tools/ai-sync/ is the source of truth:
operations.yamldefines typed operations, validators, and formatter contracts.adapters/*.yamlmap operations to GitHub or tkt argv recipes and text formatters.runtimes/*.yamldefine Claude and Codex runtime behavior.registry.yamldefines plugins, skills, and durable workflow rules.templates/contains the Jinja2 source templates.
Regenerate outputs:
cd tools/ai-sync
uv sync
uv run python scripts/render.py
uv run python scripts/render.py --checkFor local Codex skill development without installing a plugin:
cd tools/ai-sync
uv run python scripts/install_codex.py --adapter githubVerified locally on 2026-04-20:
- Claude Code can invoke Codex through
codex mcp-server, exposingcodexandcodex-reply. - Codex can invoke Claude through
claude mcp serve, exposingAgent.
Codex plugin-bundled MCP activation is not assumed yet. Generated Codex adversarial review skills include an explicit setup requirement and stop path if Agent is unavailable.
Verified locally on 2026-04-20 with ~/go/bin/tkt reporting tkt dev.
The generated adapter expects tkt on PATH. On this machine, add ~/go/bin to PATH before running generated tkt skills.
The verified workflow maps review publication to:
- create tickets with
tkt create <title> --description <body text> - append review bodies with
tkt add-note <id> <body text> - mark review-ready work with
tkt edit <id> --status needs_testing - close tickets with
tkt edit <id> --status closed
Generated files contain a notice near the top. Edit YAML data or templates, then rerender; do not hand-edit generated plugin output.
Consumer projects capture raw workflow notes in .agent-skills/retro-notes.md. Promote durable upstream rules by updating tools/ai-sync/registry.yaml in this repository and rerendering.