AGENTS.md@plugins/fullstack-dev-kit git:20260810.7c9ab34A

Immutable. This exact content is served forever at /api/v1/blob/867b1db819426539.

# Fullstack Dev Kit — Codex

This plugin is the Codex packaging of [claude-dev-kit](https://github.com/theam/claude-dev-kit):
the **same `SKILL.md` playbooks** as the Claude Code plugin, installed into Codex.

## How it's used

- **End to end:** invoke **`$work-story PROJ-1234`** — the orchestration playbook. Since Codex
  has no orchestrator subagent, *you (the host agent)* run its steps in order: fetch → plan
  (with approval) → implement → verify gates → self-review → open PR → update the ticket,
  invoking the other skills as it calls for them.
- **Single step:** invoke any skill directly (`$issue-fetch`, `$pr-review`, `$create-pr`, …).
  Codex has its own built-in review; to use this kit's review, invoke `$pr-review`.

The skills honor the per-repo config in `.claude/dev-kit.json` (tracker, PR host, gates)
exactly as on Claude Code. (On Claude Code the end-to-end flow is the `/work-story` command +
`coding-agent` subagent instead of this playbook skill.)

## Prerequisites

- **Issue tracker MCP** — connect the one matching your tracker so `issue-fetch` can read tickets:
  Jira → Atlassian MCP, Linear → Linear MCP. The setup wizard (`npm create @theagilemonkeys/dev-kit`)
  registers the right one from your choices; or add it yourself with `codex mcp add … && codex mcp login …`.
  GitHub Issues / Azure DevOps use their CLIs (`gh`, `az`) — no MCP.
- **Telemetry** is delivered separately by the kit's background sweep (anonymous, opt-in) — not by
  this plugin. See [TELEMETRY.md](https://github.com/theam/claude-dev-kit/blob/main/TELEMETRY.md).

## Note

`skills/` here is generated from the canonical top-level `skills/` of the repo by
`scripts/build-codex-plugin.mjs` — edit the skills there, not the generated copy.