knowledge-platform/CODEX_START_HERE.md

753 B
Raw Permalink Blame History

Codex Start Here

Do not ask Codex to build all of V1 in one task.

Recommended first prompt:

You are taking over the Enterprise Knowledge Platform repository. Do not modify code yet. Read AGENTS.md and the product, architecture, API/MCP, execution-plan, task and Definition-of-Done documents it references. Inspect the repository. Then output: (1) current implementation status, (2) gap analysis against V1, (3) top five technical risks, (4) next 1–3 recommended Task IDs, and (5) blockers. Do not redesign accepted ADRs.

Preferred cadence:

  1. Plan one task.
  2. Review the plan.
  3. Implement one task.
  4. Run validation.
  5. Self-review as a PR.
  6. Commit / open PR.
  7. Move to the next task.

One Task = one branch = one PR whenever possible.