codex-conventions

Defines Codex-specific conventions for plan delivery, sandbox escalation, and subagent delegation.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/hyvanmielenpelit/SharedAgentSkills --skill codex-conventions-hyvanmielenpelit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-conventions
Source: https://github.com/hyvanmielenpelit/SharedAgentSkills/tree/main/skills-codex/codex-conventions
Command: npx skills add https://github.com/hyvanmielenpelit/SharedAgentSkills --skill codex-conventions-hyvanmielenpelit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with OpenAI Codex on shared repositories requires consistent rules for where plans are stored, how sandbox escalations are requested, and when subagents may be spawned. Without these conventions, plans end up in the wrong location, protected-path writes fail silently, and delegation happens without explicit authorization. ## Core Features & Use Cases - Plan Delivery and Storage Tiers: Delivers plans through a three-tier storage model (shared plans repository, gitignored .plans/ fallback, or conversation only) with commit-and-push escalation for tier 1. - Sandbox Escalation and Protected Paths: Requests require_escalated approval for writes to .git, .agents, and .codex paths, and reports refused escalations instead of bypassing the sandbox. - Subagent Tier and Role Resolution: Resolves deep/standard/mechanical/inherit capability tiers against the models available in the current session and spawns subagents only on explicit request. - Use Case: When implementing an approved plan in Codex on Windows, read the latest versioned plan from the shared plans repository, request an escalation before committing it, and link every document with an absolute forward-slash Markdown path. ## Quick Start Ask Codex to deliver the implementation plan for this repository task following the codex-conventions storage tiers and escalation rules.

Frequently Asked Questions about codex-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deliver an implementation plan in Codex default mode?

Decide the storage tier first, finish the canonical plan at that tier, then commit and push tier 1 plans in the plans repository through an approved sandbox escalation. Report every document as a clickable absolute-path link, request approval, and stop before mutating project files.

How do I request a sandbox escalation in Codex for protected paths?

Use Codex's require_escalated execution path, which triggers a user-facing approval prompt, for writes to .git, .agents, or .codex such as plans-repository commits and pushes. Request the escalation immediately before the operation; if refused, stop and report the blocked operation.

When can Codex spawn subagents for a task?

Codex spawns subagents only when the user, an applicable AGENTS.md, or a loaded skill explicitly requests delegation or parallel agent work. An approved plan counts only when its Subagent Use section explicitly states that approval authorizes the named assignments.

What happens if a plans repository push fails in Codex?

A failed commit or push after writing to tier 1 is not a fallback condition. Describe the exact state, report the document as not shared, and do not move it to the repository's .plans/ directory as a substitute.

Why does apply_patch leave mixed line endings on Windows?

On Windows, apply_patch can convert only the edited lines of a CRLF file to LF, leaving mixed endings. After patching, normalize every changed Markdown and PowerShell file to CRLF and verify raw CR/LF byte counts, preserving documented LF-only exceptions.