Files
PDFToMD/.codex/commands/start-agent-work.md
T
2026-05-14 10:16:59 +09:00

2.1 KiB

description, argument-hint, allowed-tools
description argument-hint allowed-tools
Start a project task by loading shared plan and progress context
agent-or-task
Read
Glob
Grep
Bash
Edit

/start-agent-work

Start work in this repository with the project coordination protocol.

Arguments

The user invoked this command with: $ARGUMENTS

Workflow

  1. Read PLAN.md and PROGRESS.md.
  2. State the current goal, the next action, and any blocker that matters for the task.
  3. Read docs/WORKARCHIVE.md when historical completed-work context, previous verification, or sample conversion evidence is needed.
  4. Read only the additional source documents needed for the requested work.
  5. If subagents are useful and the user explicitly asked for delegated agent work, choose the smallest set of .codex/agents/*.toml roles that covers the task.
  6. For substantial implementation work, use the harness sequence: harness-planner-agent drafts the plan and contract, feature-generator-agent implements one agreed chunk, and evaluation-agent reviews the contract and completed work.
  7. Do not implement converter code unless the user explicitly requests implementation.
  8. After meaningful changes, update PROGRESS.md; update PLAN.md only when sequencing, decisions, ownership, or blockers change.
  9. Archive completed work in docs/WORKARCHIVE.md when it no longer needs to stay in PROGRESS.md.
  10. Run the smallest useful verification, check git status, and commit project changes while excluding samples/, outputs/, build/, dist/, generated installers, wheels, models, and other local payload artifacts.

Guardrails

  • Keep MinerU 3.1.0 as the only conversion engine.
  • Allow MinerU 3.1.0's CLI-internal temporary local mineru-api, but prohibit --api-url, remote APIs, router mode, HTTP client backends, and remote OpenAI-compatible backends.
  • Keep runtime processing local-only.
  • Keep samples/ out of commits unless the user explicitly requests otherwise.
  • Keep generated packaging, UI build, conversion output, wheelhouse, and model artifacts out of commits.
  • Prefer official sources for changing facts about Codex, MinerU, Python, uv, CUDA, or licenses.