@speedsol/codex-standards

SpeedSol Standards for Codex CLI — .NET enterprise governance embedded as AGENTS.md.

Equivalent to the standards-development Claude Code plugin, but designed for OpenAI Codex CLI. Does not affect Claude Code.

Installation

npm install -g @speedsol/codex-standards

Usage

In any project where you want Codex to apply SpeedSol standards:

cd my-dotnet-project
codex-standards init

This creates:

• AGENTS.md — loaded automatically by Codex CLI on every run
• memory/project-context.md — accumulated project knowledge
• memory/team-log.md — team audit trail

Commands

| Command | Description | |---|---| | codex-standards init | Copy AGENTS.md and memory templates to current project | | codex-standards validate | Check that all required files are present | | codex-standards update | Overwrite AGENTS.md with the latest package version |

What AGENTS.md Contains

The embedded system prompt enforces all SpeedSol company standards:

• .NET 9 tech stack — ASP.NET Core, EF Core, Serilog, xUnit, AutoMapper
• Architecture rules — Controller → Service → Repository → DB (non-negotiable)
• Naming conventions — PascalCase, camelCase, I-prefix interfaces, Async suffix
• Logging — ILogger mandatory, no Console.WriteLine
• Error handling — try/catch in Services only
• Security policy — no hardcoded secrets, parameterized SQL, JWT/Azure AD
• Code quality — max 50 lines/function, max 3 nesting levels, DRY

Agent Modes

Codex activates the right mode based on your prompt keywords:

| Trigger | Mode | |---|---| | "review", "revisar", "code quality" | REVIEW | | "security", "seguridad", "audit" | SECURITY | | "architecture", "arquitectura" | ARCHITECTURE | | "debug", "error", "exception", "fix" | DEBUG | | "workflow", "git", "branch", "PR" | WORKFLOW |

Memory Protocol

Codex appends significant findings to:

• memory/project-context.md — architecture decisions, recurring issues
• memory/team-log.md — audit trail per session

Keeping Standards Up to Date

When a new version is published:

npm update -g @speedsol/codex-standards
cd my-dotnet-project
codex-standards update

Difference from Claude Code Plugin

| | Claude Code | Codex CLI | |---|---|---| | Install | /plugin install standards-development | npm install -g @speedsol/codex-standards | | Activation | Plugin system (agents, commands, skills) | AGENTS.md in project root | | Memory hooks | PowerShell hooks auto-persist | Manual append by Codex | | Commands | /review, /security, /debug, etc. | Natural language triggers |

Author

Speed Solutions S.A.S. — [email protected]