RNR-Enhanced-Cognee: Instructions file for Codex

RNR Enhanced Cognee Implementation for Codex

Overview

This document is the Codex-facing counterpart to CLAUDE.md. Both files describe the same RNR Enhanced Cognee memory architecture; this one is tuned for the Codex CLI and uses ASCII-only formatting throughout (no emojis, no checkmarks) so it round-trips cleanly through Windows cp1252 consoles.

If you're Claude, read CLAUDE.md. If you're Codex, this file is yours.

---

CRITICAL REQUIREMENTS

1. ASCII-Only Output (NO Unicode Encoding)

All output must use ASCII characters ONLY. Do NOT use Unicode symbols.

Prohibited:

• Checkmarks / crosses (no Unicode tick, cross, or x-mark glyphs)
• Warning symbols (no Unicode warning sign)
• Emojis of any kind (no chart/wrench/agent/memory/rocket pictographs)
• Arrows (no Unicode left/right/up/down arrows -- use ->, <-, ^, v)
• Special symbols (no Unicode info, sparkle, bullet glyphs)

Use ASCII equivalents:

• Success -> OK or [OK]
• Warning -> WARN or [WARNING]
• Error -> ERR or [ERROR]
• Info -> INFO or [INFO]
• Document -> [DOC]
• Library -> [LIB]
• Agent -> [AGENT]
• Memory -> [MEM]

Why: Windows console (cp1252 encoding) cannot display Unicode characters. Using Unicode causes UnicodeEncodeError: 'charmap' codec can't encode character ... which kills any process that tries to print to stdout/stderr.

2. Dynamic Categories (NO Hardcoded Categories)

Do NOT use hardcoded categories like ATS/OMA/SMC in code.

WRONG -- hardcoded enum:

class MemoryCategory(Enum):
    ATS = "ats"
    OMA = "oma"
    SMC = "smc"

if category not in ["ats", "oma", "smc"]:
    raise ValueError(f"Invalid category: {category}")

CORRECT -- dynamic category loading from config:

config = EnhancedConfig()
categories = config.category_prefixes  # Loaded from .enhanced-cognee-config.json

def add_memory(agent_id: str, content: str, memory_category: str):
    # Categories are dynamic - accept any string
    # No validation against hardcoded list
    pass