monopi: Instructions file for Codex

Agent Rules: monopi

monopi is a lockstep-versioned pnpm monorepo of pi extensions, themes, prompts, skills, agents, and TUI tooling.

Essentials

• Use pnpm for all workspace commands.

Use MDT through pnpm mdt ..., not a globally installed mdt binary. This keeps documentation reuse commands pinned to the repo's declared @ifi/mdt version and makes local runs, CI, and agent instructions consistent.

• Non-standard repo commands:
  • pnpm typecheck: type-checks the repo with tsgo (@typescript/native-preview)
  • pnpm build: runs every workspace package build script
• Every non-release change must include a changeset created with pnpm mc create; changeset frontmatter must use only monopi-group.

pnpm mdt list
pnpm mdt update
pnpm mdt check

Convenience wrappers remain available too:

pnpm docs:list
pnpm docs:update
pnpm docs:check

• Read only the detailed file that matches the current task:
  • Engineering rules
  • Packaging and release rules
  • Git and PR workflow

Performance Rules

These rules prevent performance regressions identified during the 2025-04 audit. Every change must comply.

1. Hoist regexes out of hot paths

Never create new RegExp(...) inside a function that runs repeatedly (event handlers, parsers, per-message processors). Instead, compile the regex once at module scope or in a lazy-init singleton.

// ❌ Slow: compiles on every call
function extractSections(output: string) {
	for (const section of sections) {
		const regex = new RegExp(`#{1,2} ${section}\\n([\\s\\S]*?)(?=\\n#{1,2} |$)`, "i");
		// ...
	}
}

// ✅ Fast: compile once at module scope
const SECTION_REGEXES = SECTIONS.map((s) => new RegExp(`#{1,2} ${s}\\n([\\s\\S]*?)(?=\\n#{1,2} |$)`, "i"));