Backend Forge

A Codex skill for production-grade backend development.

Backend Forge turns AI-assisted backend work into a disciplined engineering workflow: inspect the project, detect the stack, choose the right mode, design the contract, check the risky backend edges, implement the smallest safe change, and verify with evidence.

Why This Exists

Most backend failures are not syntax failures. They are missing authorization checks, unsafe migrations, weak transaction boundaries, retry duplication, N+1 queries, unbounded reads, hidden config drift, and tests that only cover the happy path.

Backend Forge focuses Codex on those failure modes.

What It Helps With

• Add production-ready backend APIs and service logic
• Review backend changes for security, data, transaction, and concurrency bugs
• Design useful test matrices instead of shallow coverage
• Prepare risky changes for deployment and rollback
• Probe unfamiliar repositories before editing

Supported Stacks

Backend Forge is language-agnostic, with explicit guidance for:

• Java Spring Boot
• Node.js, NestJS, Express, Fastify
• Python FastAPI, Django, Flask
• Go Gin, Echo, Fiber, Chi, net/http

Repository Layout

skills/backend-forge/
|-- SKILL.md
|-- agents/
|   `-- openai.yaml
|-- references/
|   |-- backend-checklists.md
|   |-- framework-patterns.md
|   `-- testing-strategy.md
`-- scripts/
    `-- backend_probe.py

Install

Copy skills/backend-forge into your Codex skills directory.

Windows PowerShell example:

Copy-Item -Recurse .\skills\backend-forge "$env:USERPROFILE\.codex\skills\backend-forge"

macOS/Linux example:

cp -R skills/backend-forge ~/.codex/skills/backend-forge

Restart Codex after installing if the skill list does not refresh automatically.

Example Prompts

Use $backend-forge to add a production-ready POST /orders API with validation, idempotency, tests, and rollout checks.

Use $backend-forge to review this service for transaction, authorization, N+1, and concurrency risks.

Use $backend-forge to design a test matrix for this payment webhook consumer.

Use $backend-forge to check whether this migration is safe for a rolling deploy.

Probe Script

The skill includes a dependency-free read-only scanner:

python skills/backend-forge/scripts/backend_probe.py --root /path/to/backend-repo

It reports likely languages, frameworks, package managers, test commands, migration tools, API spec files, infra files, and risk signals.

Publish To GitHub

If you have GitHub CLI installed:

gh repo create backend-forge --public --source=. --remote=origin --push

Without GitHub CLI:

git remote add origin https://github.com/YOUR_NAME/backend-forge.git
git branch -M main
git push -u origin main

License

MIT