plsql-intelligence AGENTS.md

Repository instructions for the plsql-intelligence project, a Rust workspace for working with PL/SQL, Oracle's programming language for database applications. They describe project rules, the development plan, and restrictions on private test material and irreversible changes.

In plain words
What is it for?
Use them when working in this repository, especially before editing code, consulting the project plan, handling private PL/SQL examples, or performing Git and filesystem operations.
Why use it?
They give coding agents the project context and safety rules they need before making substantive changes.

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/muhdur/plsql-intelligence/agents-md
Clone the repo
git clone --depth 1 https://github.com/MuhDur/plsql-intelligence

Made for: Codex, OpenCode.

Per session 3,723 This file is loaded in full into every session.
When invoked 3,723 The same file — it is already loaded in full.
Security scan C 1 finding. 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.03723 $0.03723
Opus 5 $0.01861 $0.01861
Sonnet 5 $0.00745 $0.00745
Haiku 4.5 $0.00372 $0.00372

Measured yesterday against content hash 4396006d91bd, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

plsql-intelligence AGENTS.md scanned grade C with 1 finding 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 yesterday.

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.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

- **C7 (operational, supersedes plan.md §3 literal text):** Agents may commit and push via the git skills below. Never run destructive ops (`git reset --hard`, `git clean -fd`, `git push --force`, branch deletion, `git s
AGENTS.md · 397 lines

How it starts

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

AGENTS.md — plsql-intelligence

Operating rules for agents working in this repository.

This is a greenfield Rust project now in active implementation. The working plan lives in plan.md; read it before doing anything substantive. If code and plan disagree, fix one or the other deliberately, never silently.

  • Project key (for beads, agent mail, cass-memory): plsql-intelligence
  • Repo name on disk: oracle/ (not the same as the project key)
  • Language: Rust (Cargo workspace). No JS/TS/Python in this repo.
  • Status: Pre-GA implementation. Foundational crates exist; higher layers are still in progress.
  • Web access: allowed. Use WebFetch / WebSearch for OSS docs, Oracle reference material, crate research, etc.

Founder constraints (plan.md §3, non-negotiable)

  • C1/C2: No ML training on private data; no private code through founder-owned inference infra.
  • C5/C6 + private estate: Private PL/SQL test material lives in the directory named by the PLSQL_PRIVATE_ESTATE environment variable. Strictly local-only. Never publish, copy, or git add anything from that path into this repo or any other git repository. Treat it as pattern reference only; test cases mirroring its patterns are re-synthesized from grammar + description, never copied.
  • C7 (operational, supersedes plan.md §3 literal text): Agents may commit and push via the git skills below. Never run destructive ops (git reset --hard, git clean -fd, git push --force, branch deletion, git stash drop, rm -rf on tracked paths) without explicit in-session approval.

If unsure whether an action would violate one of these, stop and ask.

Plan rules to internalize (plan.md §4)

  • R10 / R11: Every CLI ships --robot-json and a doctor subcommand.
  • R13: No uncertainty is silently dropped; every blind spot becomes a typed UnknownReason with provenance.
  • R17: No telemetry by default.
  • R20: Parser backend isolation is mandatory; no downstream crate depends on ANTLR-generated types.

Read the full file on GitHub · 397 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. yesterday First seen · 397 lines · 3,723 tokens per session scan C 4396006d91bd

Subscribe to this mod's changes

plsql-intelligence AGENTS.md is an instructions file published in the GitHub repository MuhDur/plsql-intelligence (2 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 3,723 tokens to every session, about $0.0186 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.