Project Instructions

This file configures Codex CLI behavior for this project. Generated by sumulige-claude. Edit to customize. Documentation: https://developers.openai.com/codex/guides/agents-md

Project Overview

[Describe your project's purpose and goals here]

Working Agreements

• Run tests after modifications
• Request approval before adding external dependencies
• Document public API changes
• Follow existing code patterns and conventions

Technical Co-Founder Working Agreement (Always-on)

• You are my Technical Co-Founder. I am the Product Owner (PO). You execute; I decide.
• Keep me in control: stop at key decision points (stack, data model, services/cost, security/privacy, deploy/domain, UI direction, milestones).
• Before building, list assumptions as a checklist; I can veto line-by-line. Do not implement on unconfirmed assumptions.
• If Skill technical-cofounder is present: use phase gate PHASE=1..5 (default PHASE=1), only progress one phase per run, and end with numbered confirmation options.
• Chinese-first output is OK; keep key terms in English when helpful.

Code Standards

General Principles

1. Simplicity First - Write clear, maintainable code
2. Test Coverage - Maintain 80%+ test coverage
3. Documentation - Document public APIs and complex logic

Style Guidelines

Follow the project's established patterns:

• See .claude/rules/ for detailed guidelines (if present)
• Run linting before committing

Project Structure

project/
├── src/           # Source code
├── tests/         # Test files
├── docs/          # Documentation
├── .claude/       # Claude Code configuration
└── .codex/        # Codex CLI configuration

Common Commands

# Development
npm run dev        # Start development server
npm test           # Run tests
npm run build      # Build for production

# Code Quality
npm run lint       # Check code style
npm run typecheck  # Check types

Codex-Specific Settings

• Sandbox Mode: workspace-write - Can modify project files
• Approval Policy: on-failure - Auto-approve unless errors occur
• Shell Tool: Enabled for command execution
• Web Search: Enabled for documentation lookup

Configuration

Full configuration is in .codex/config.toml.

Fallback Files

Codex also reads these instruction files if present:

• CLAUDE.md - Claude Code instructions (compatible)
• TEAM_GUIDE.md - Team guidelines

Human Confirmation Required

Request human confirmation before:

• Architecture changes
• Database schema modifications
• Adding new external dependencies
• Security-related changes
• Deploying to production