Use this skill when a task needs a spec-driven workflow. The objective is to create or refresh PRD + TECH_SPEC + ACTION_PLAN + the task checklist before editing code or docs, capture a brief translation of the user’s request in the PRD for context retention, and keep task mirrors and review evidence in sync as understanding evolves.
Global Adoption Defaults
For shipped CO usage, default to this command path unless task constraints say otherwise:
codex-orchestrator flow --task <task-id>
codex-orchestrator doctor --usage --window-days 30 --task <task-id>
codex-orchestrator rlm --multi-agent auto "<goal>"
Workflow
Draft or refresh PRD + TECH_SPEC + ACTION_PLAN
PRD: capture intent and user-request translation (use .agent/task/templates/prd-template.md).
TECH_SPEC: capture technical requirements (use .agent/task/templates/tech-spec-template.md; stored under tasks/specs/<id>-<slug>.md).
TECH_SPEC linked in task registry and mirrors updated.
Docs-review evidence captured before implementation.
Related docs
docs/AGENTS.md
docs/guides/instructions.md
Related skills
delegation-usage: for task-scoped delegated research/review streams after docs scaffolding.
standalone-review: for pre-implementation approval and implementation checkpoints.
elegance-review: for post-implementation minimality pass before handoff.
agent-first-adoption-steering: for non-blocking advanced-feature steering and option framing.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: kbediako-co-docs-first3description: Docs-First (Spec-Driven)4---56# Docs-First (Spec-Driven)78## Overview910Use this skill when a task needs a spec-driven workflow. The objective is to create or refresh PRD + TECH_SPEC + ACTION_PLAN + the task checklist before editing code or docs, capture a brief translation of the user’s request in the PRD for context retention, and keep task mirrors and review evidence in sync as understanding evolves.1112## Global Adoption Defaults1314For shipped CO usage, default to this command path unless task constraints say otherwise:15- `codex-orchestrator flow --task <task-id>`16- `codex-orchestrator doctor --usage --window-days 30 --task <task-id>`17- `codex-orchestrator rlm --multi-agent auto "<goal>"`1819## Workflow20211) Draft or refresh PRD + TECH_SPEC + ACTION_PLAN22- PRD: capture intent and user-request translation (use `.agent/task/templates/prd-template.md`).23- TECH_SPEC: capture technical requirements (use `.agent/task/templates/tech-spec-template.md`; stored under `tasks/specs/<id>-<slug>.md`).24- ACTION_PLAN: capture sequencing/milestones (use `.agent/task/templates/action-plan-template.md`).25- Depth scales with scope, but all three docs are required.26- For low-risk tiny edits, follow the bounded shortcut in `docs/micro-task-path.md` instead of long-form rewrites (still requires task/spec evidence).27282) Register the TECH_SPEC and task29- Add the TECH_SPEC to `tasks/index.json` (including `last_review`).30- Create/refresh the task checklist (`tasks/tasks-*.md`) and mirror to `.agent/task/`.31- Update `docs/TASKS.md` with the snapshot entry.32- When you need machine-readable artifacts, use a consistent template or structured output format.33343) Run docs-review before implementation35- `npx codex-orchestrator start docs-review --format json --no-interactive --task <task-id>`36- If running in cloud mode, ensure the branch exists on remote. For local-only branches, set `CODEX_CLOUD_BRANCH=main` (or another pushed branch).37- Link the manifest path in the checklists.38394) Implement and validate40- Keep PRD/TECH_SPEC/ACTION_PLAN, checklists, and manifests aligned.41- Update PRD/TECH_SPEC/ACTION_PLAN when new constraints, risks, or scope changes are discovered during implementation.42- If docs are missing or stale, stop and request approval before proceeding.4344## Output expectations45- PRD + TECH_SPEC + ACTION_PLAN + task checklist created/refreshed.46- TECH_SPEC linked in task registry and mirrors updated.47- Docs-review evidence captured before implementation.4849## Related docs50- `docs/AGENTS.md`51- `docs/guides/instructions.md`5253## Related skills54- `delegation-usage`: for task-scoped delegated research/review streams after docs scaffolding.55- `standalone-review`: for pre-implementation approval and implementation checkpoints.56- `elegance-review`: for post-implementation minimality pass before handoff.57- `agent-first-adoption-steering`: for non-blocking advanced-feature steering and option framing.5859---60> Converted and distributed by [TomeVault](https://tomevault.io/claim/kbediako) — claim your Tome and manage your conversions.61<!-- tomevault:4.0:skill_md:2026-04-13 -->
Run npx skillmds@latest add tomevault-io/kbediako-co-docs-first in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Docs-First (Spec-Driven) It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.