Codex Backend Handler Boundaries for Testable Service Rules
Keep transport decoding and response mapping at the handler boundary and put business decisions into separately testable services.
中文Install in Codex
Open the project using cpp-agentic-development-frame in Codex. Read AGENTS.md and apply the overlay with the base implementation skill.
- Review `.agents/skills/backend-guidance/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.agents/skills/backend-guidance/` in your project and save the reviewed file as `.agents/skills/backend-guidance/SKILL.md`.
- Start Codex from that project's root, then type `$backend-guidance` and select the matching skill.
Example task
Map responsibilities for this illustrative label preview endpoint.
{"route":"/label-preview","requestLabel":" Oak ","service":"normalizeLabel","expectedText":"Oak","handlerOwns":"JSON response"}What to check
Call `normalizeLabel` from the handler and let the handler return JSON. Assert `text=Oak` in a service test without starting a network service.
Original SKILL.md on GitHub · Updated
Frequently asked question
Does a formatting rule need the HTTP request object?
Pass only the values the service needs. Let the handler read the request and construct the response.