Terra-Official-Plugins: Instructions file for Codex

AGENTS.md

Terra-Official-Plugins AGENTS.md is an instructions file for Codex, OpenCode from juno-fx/Terra-Official-Plugins. It costs 10,481 tokens per session, scanned A, original, MIT.

Repository instructions for working on Terra’s official plugin catalogue. The plugins are Helm charts, which package Kubernetes applications for installation into clusters.

In plain words
What is it for?
Use them when developing or reviewing plugins in the Terra repository, especially when deciding a plugin’s type and required file location.
Why use it?
They reduce mistakes when adding or changing plugins by explaining where plugins belong, what types exist, and how Terra, ArgoCD, Genesis, and Kuiper work together.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

This is juno-fx/Terra-Official-Plugins's own configuration. It tells Codex and OpenCode how to work on Terra-Official-Plugins itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything Terra-Official-Plugins configures →

Reuse

Borrowing it

Nothing to install: this file belongs to juno-fx/Terra-Official-Plugins. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/juno-fx/Terra-Official-Plugins

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for Terra-Official-Plugins AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/juno-fx/terra-official-plugins/agents-md/github.svg)](https://agentmods.dev/instructions/juno-fx/terra-official-plugins/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/juno-fx/terra-official-plugins/agents-md"><img src="https://agentmods.dev/badge/instructions/juno-fx/terra-official-plugins/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for Terra-Official-Plugins AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/juno-fx/terra-official-plugins/agents-md"><img src="https://agentmods.dev/badge/instructions/juno-fx/terra-official-plugins/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 10,481 This file is loaded in full into every session.
When invoked 10,481 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.10481 $0.10481
Opus 5.5 $0.04192 $0.04192
Sonnet 5.5 $0.02096 $0.02096
Haiku 4.5 $0.01048 $0.01048

Measured 10d ago against content hash 099763c78aa9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

Terra-Official-Plugins 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 10d 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 · 744 lines

How it starts

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

AGENTS.md — Terra Official Plugins

This file provides authoritative guidance for AI agents and automated tools working in this repository. Read this before making any changes to plugins or tooling.

Agent reading order — navigate by priority, not sequence: (1) Critical Rules → (2) Plugin Authoring — Probe First → (3) "Adding a New Plugin — Checklist" — creation tasks start there, it sequences probe → scaffold → files → check → package → verify → (4) Concept Routing — consult only the concept file a probe or task hits. The reference tables below (Kuiper Annotations, Field Types, terra.yaml properties, values keys, Make Targets) are consult-on-demand only — do not pre-read them. AGENTS.md tables are authoritative; concepts/ and docs/ mirror them. A small-context model needs only this preamble + Critical Rules + the checklist + one routed concept.


Repository Purpose

This repository is the official plugin catalog for the Juno platform (Terra/Genesis/Kuiper/ArgoCD stack). Plugins are Helm charts that Terra installs into Kubernetes clusters via ArgoCD Application resources.

Platform component roles:

Component Role
Terra Plugin marketplace — installs plugins as ArgoCD Applications
ArgoCD GitOps engine — syncs Helm charts from this repo into the cluster
Genesis Workload template catalog — reads workload template schemas from ConfigMaps
Kuiper Workload launcher — renders embedded Helm charts at workload launch time

All plugins live in plugins/<plugin-name>/. Do not create plugins outside this directory.

Logo and icon placement — logo/icon files live at the plugin root in assets/ (plugins/<plugin-name>/assets/logo.png), as a sibling of scripts/. Never put images inside scripts/: the entire scripts/ directory is gzip-compressed, base64-encoded, and shipped inside the packaged scripts ConfigMap, so images there consume the 1MiB ConfigMap budget for no benefit. terra.yaml's icon field and any README badges reference the root asset path (https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/<plugin-name>/assets/logo.png).

Read the full file on GitHub · 744 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. 10d ago Changed · +20 lines · +417 tokens per session 099763c78aa9
  2. 25d ago Changed · +5 lines · +101 tokens per session 43b1d868d65c
  3. 1mo ago Changed · +97 lines · +2,203 tokens per session 12f461484e06
  4. 2mo ago First seen · 622 lines · 7,760 tokens per session scan A e69081c5a9e1

Subscribe to this mod's changes

Terra-Official-Plugins AGENTS.md is an instructions file published in the GitHub repository juno-fx/Terra-Official-Plugins (2 stars, last pushed today), licensed MIT. It adds 10,481 tokens to every session, about $0.0419 per session on Opus 5.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

Terra-Official-Plugins AGENTS.md compared with instructions from other repositories

Terra-Official-Plugins AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
Terra-Official-Plugins AGENTS.mdjuno-fx/Terra-Official-PluginsInstructions file2todayMITA10,481Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,649GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA2,022GitHub Copilot