RalphX AGENTS.md

Project instructions for RalphX, a Mac desktop application for autonomous software development. They describe its Rust/Tauri backend, React frontend, documentation, testing, delegation, and runtime conventions.

In plain words
What is it for?
Use them when developing RalphX, especially for backend or frontend work, AI-agent delegation, runtime paths, prompt documentation, ideation verification, and tests.
Why use it?
They give coding agents the project-specific rules and file locations they need to make consistent changes. This reduces guesswork in a large codebase.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/aigentive/ralphx/agents-md
Clone the repo
git clone --depth 1 https://github.com/aigentive/RalphX

Made for: Codex, OpenCode.

Per session 4,046 This file is loaded in full into every session.
When invoked 4,046 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.04046 $0.04046
Opus 5 $0.02023 $0.02023
Sonnet 5 $0.00809 $0.00809
Haiku 4.5 $0.00405 $0.00405

Measured 2d ago against content hash e934aa6f306d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

RalphX AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 128 lines

How it starts

The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Maintainer note: Keep this file compact. Prefer one-line rules, links to source docs, and explicit non-negotiables over prose.

AGENTS.md

Project

RalphX — native Mac GUI for autonomous AI development with Rust/Tauri backend and React frontend.

Primary project docs:

  • CLAUDE.md
  • frontend/CLAUDE.md
  • src-tauri/CLAUDE.md
  • .claude/rules/*.md
  • .claude/rules/openai-gpt-5-prompting.md for target-model prompt-guide routing across supported GPT-5 families
  • docs/ai-docs/openai/README.md for GPT-5.4, GPT-5.5, and GPT-5.6 family guides plus official-source links
  • .claude/rules/ideation-verification-architecture.md for the ideation verification feature map: parent-vs-child ownership, runtime flow, UI surfaces, debugging, and tests
  • .claude/rules/delegation-topology.md for canonical delegation allowlists, auto-injected delegation guidance, and MCP visibility/enforcement rules
  • .claude/rules/runtime-root-vs-target-project.md for the contract between RalphX-owned runtime/plugin/log roots and the user’s active target project checkout
  • .claude/rules/production-cli-resolution.md for Finder/Homebrew-safe CLI binary resolution in installed app runtime paths
  • .claude/rules/codeql-path-safety.md for CodeQL-safe filesystem sink validation when paths are influenced by env vars, settings, HTTP/MCP payloads, DB state, agent metadata, or repo contents
  • .claude/rules/multi-harness.md for provider-neutral runtime/config/event rules and documentation sync requirements
  • .claude/rules/agent-thinking-capture.md and docs/architecture/agent-thinking-capture.md for cross-harness reasoning capture, capability probing, event/persistence ownership, failure edges, and focused proofs
  • .claude/rules/agent-mcp-tools.md for multi-layer agent MCP/tool alignment across canonical agent metadata, harness runtime config, prompt contracts, and MCP registration
  • .claude/rules/agent-workspace-review-modes.md for the non-interchangeable local Workspace Review gate and remote GitHub Review PR workflow
  • .claude/rules/merge-recovery-consistency.md for the coupled merge-failure behavior across merge outcome handling, manual retry, reconciliation, startup recovery, and MergeIncomplete UI
  • .claude/rules/stateful-workflow-review.md for false-success review of completion/cache/retry/recovery/state-machine changes
  • .claude/rules/task-state-machine.md for the 28 internal task statuses, the transition table, and the validated transition API contract
  • .claude/rules/big-pr-review-checklist.md for the recurring failure classes big PRs ship here and the 12 falsifiable pre-merge checks that catch them
  • .claude/rules/rust-test-execution.md for selective Rust test commands, the standard Rust test stack, shared SQLite fixtures/builders, and the no-broad-fmt rule
  • .claude/rules/wkwebview-css-vars.md for Tauri (WKWebView) CSS custom-property inheritance rules — theme tokens for bg/text/border MUST be literals, not chained var() references
  • .claude/rules/release-script-validation.md for safe validation of release proposal/wrapper scripts without triggering real publish steps
  • .claude/rules/icon-only-buttons.md for accessible tooltip requirements on icon-only controls
  • .claude/rules/frontend-interaction-performance.md for non-negotiable lazy loading, first-paint-safe UI transitions, deferred hydration/teardown, and decoupled panel/drawer interactions
  • .claude/rules/visual-testing.md for Playwright-first visual QA, scoped dev-server use, and the explicit-request-only Computer Use boundary
  • .claude/rules/pr-descriptions.md for reviewer-focused PR bodies: context, impact, decisions, risks; validation logs stay secondary

Read the full file on GitHub · 128 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 128 lines · 4,046 tokens per session scan A e934aa6f306d

Subscribe to this mod's changes

RalphX AGENTS.md is an instructions file published in the GitHub repository aigentive/RalphX (5 stars, last pushed 2d ago), licensed Apache-2.0. It adds 4,046 tokens to every session, about $0.0202 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

buildNext

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

next.js AGENTS.md

Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

spec-kit AGENTS.md

Instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,040 tokens

langchain AGENTS.md

Instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,345 tokens