Back to .md Directory

CODEX.md

Configures an AI coding agent to read a project rules file first and always respond in Korean.

May 2, 2026
0 downloads
0 views
ai agent openai workflow
View source

What this file does

Configures an AI coding agent to read a project rules file first and always respond in Korean.

When to use it

  • You want to enforce a single source of truth for AI agent behavior
  • Your team communicates in a non-English language and needs agent replies in that language
  • You have auto-generated proto code that must not be hand-edited

Assumes this stack

TypeScriptNode.jsGogRPCOpenAI Codex

CODEX.md

This file provides guidance to Codex (OpenAI) when working with code in this repository.

πŸ€– Agent Configuration

{
    "auto_read_paths": [
        ".agents/context/careti-rules.json"
    ],
    "instruction": "Read .agents/context/careti-rules.json first. It contains the project rules and an index of workflows. Read specific workflow files ON DEMAND as needed. ALWAYS communicate with the user in Korean (ν•œκΈ€)."
}

⚠️ Critical Instruction

DO NOT rely on pre-trained knowledge or assumptions. ALWAYS read .agents/context/careti-rules.json at the start of the session. It is the SINGLE SOURCE OF TRUTH for:

  • Project Identity & Philosophy
  • Merge Strategy (Phase 0, Hybrid Pattern)
  • Architecture Rules (L1-L3 Levels)
  • Development Framework (Tech Stack, TDD)
  • AI Workflow & Forbidden Actions

🧬 Proto Generation Guidelines

  • TypeScript/Node generated μ½”λ“œλŠ” npm run protos (μ‹€μ œ 슀크립트: careti-scripts/build/build-proto.mjs)둜만 κ°±μ‹ ν•©λ‹ˆλ‹€. src/shared/proto/**, src/generated/**λŠ” 직접 μˆ˜μ •ν•˜μ§€ λ§ˆμ„Έμš”.
  • Go/CLI gRPC μŠ€ν…μ€ npm run protos-go (scripts/build-go-proto.mjs)κ°€ κ΄€λ¦¬ν•©λ‹ˆλ‹€. CLI ν…ŒμŠ€νŠΈ 전에 항상 μ΅œμ‹  μƒνƒœλ‘œ μž¬μƒμ„±ν•©λ‹ˆλ‹€.
  • proto μ •μ˜λ₯Ό μˆ˜μ •ν•˜κ±°λ‚˜ generated μ½”λ“œκ°€ λˆ„λ½λœ μƒνƒœλΌλ©΄ 두 λͺ…λ Ήμ˜ μ‹€ν–‰ 둜그λ₯Ό 남기고, attempt-2-master/κ΄€λ ¨ λ¬Έμ„œμ— μž¬μƒμ„± 사싀을 기둝해야 ν•©λ‹ˆλ‹€.

What's inside

Agent JSON config, critical instruction, and two proto generation guidelines

Change this for your project

  • Replace careti-rules.json with your own rules file path
  • Replace "Korean (ν•œκΈ€)" with your team's language
  • Replace careti-scripts/build/build-proto.mjs with your proto build script
  • Replace attempt-2-master with your branch or doc reference

Where it goes

Keep it in your repository where the agent or team that needs it will read it.

Related Documents