routa AGENTS.md

A repository instruction set for Routa.js, a platform with web and desktop applications that coordinate software agents. It defines coding, testing, debugging, validation, Git, and commit rules.

In plain words
What is it for?
Use it when changing Routa.js code, consulting its architecture and design decisions, validating behavior across backends, or making small disciplined commits.
Why use it?
It keeps the web and desktop versions aligned and gives contributors clear project-specific checks and boundaries.

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/phodal/routa/agents-md
Clone the repo
git clone --depth 1 https://github.com/phodal/routa

Made for: Codex, OpenCode.

Per session 1,834 This file is loaded in full into every session.
When invoked 1,834 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.01834 $0.01834
Opus 5 $0.00917 $0.00917
Sonnet 5 $0.00367 $0.00367
Haiku 4.5 $0.00183 $0.00183

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

Security

Grade A, and why

routa 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 3d 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 · 121 lines

How it starts

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

Routa.js — Multi-agent coordination platform with dual-backend architecture (Next.js + Rust/Axum).

Routa.js is a workspace-first multi-agent coordination platform with two runtime surfaces:

  • Web: Next.js app and API in src/
  • Desktop: Tauri app in apps/desktop/ backed by Axum in crates/routa-server/

The project is intentionally not "two separate products". Web and desktop differ in deployment model and storage, but they are expected to preserve the same domain semantics, API shape, and agent-coordination behavior.

  • docs/ARCHITECTURE.md: Canonical architecture boundaries, domain model, protocol stack, and cross-backend invariants.
  • docs/adr/: Durable architectural decisions. Start here for "why".
  • docs/design-docs/: Human-reviewed design intent and normalized decisions migrated from .kiro/specs/.

Coding Standards

  • General coding style guidance lives in docs/coding-style.md; keep this file focused on routing and repo-level guardrails.
  • Source of truth for executable gates is docs/fitness/ + entrix; do not restate tool-level checks here.
  • Frontend and desktop API calls in src/app and src/client should use resolveApiPath + desktopAwareFetch for统一的后端路径组装:
    • resolveApiPathsrc/client/config/backend.ts):统一补全 /api 前缀并在需要时拼接后端 base URL。
    • desktopAwareFetchsrc/client/utils/diagnostics.ts):在 Tauri 桌面静态运行时自动落到 http://127.0.0.1:3210 或配置的后端地址。
    • 避免在前端/桌面再次直接写 fetch('/api/...')
  • For long behavior-heavy files, prefer orchestration shell + domain hooks over UI-only slicing.
  • Apply the same pattern to oversized API routes: thin top-level route, extract workflow branches (session creation, streaming, provider dispatch, etc.).
  • Split route refactors by workflow branch before shared helpers; avoid premature generic utils.
  • Before large behavior refactors, add or extend characterization tests that lock routing/lifecycle/persistence/recovery behavior.
  • All UI-facing strings must go through the i18n system (e.g., t('key')). Do not hardcode English or Chinese literals in components.

Read the full file on GitHub · 121 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. 3d ago First seen · 121 lines · 1,834 tokens per session scan A 0d9a551bc71e

Subscribe to this mod's changes

routa AGENTS.md is an instructions file published in the GitHub repository phodal/routa (1,808 stars, last pushed 20d ago), licensed MIT. It adds 1,834 tokens to every session, about $0.0092 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-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

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

spec-kit AGENTS.md

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,104 tokens

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

langchain AGENTS.md

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

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

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