outl copilot-instructions.md

Copilot instructions for outlmd/outl, covering copilot review instructions — outl, 0. read these first, where the rest of this lives, why a change was made: read the rfc and 1. gate the pr before reviewing code.

Instructions file for GitHub Copilot

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/outlmd/outl/copilot-instructions
Clone the repo
git clone --depth 1 https://github.com/outlmd/outl

Made for: GitHub Copilot.

Per session 2,539 This file is loaded in full into every session.
When invoked 2,539 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.02539 $0.02539
Opus 5 $0.01269 $0.01269
Sonnet 5 $0.00508 $0.00508
Haiku 4.5 $0.00254 $0.00254

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

Security

Grade A, and why

outl copilot-instructions.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 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.

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.

.github/copilot-instructions.md · 210 lines

How it starts

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

Copilot review instructions — outl

You are reviewing a pull request in outl, a local-first outliner with a CRDT-based tree sync engine, written in Rust. Read this whole file before commenting. Your job is not a style pass — fmt, clippy, and CI already enforce style. Your job is the review a Staff/Principal engineer would give: catch correctness, architecture, and scalability problems that humans miss, and only speak when it matters.

If you cannot map a finding to a concrete, real-world consequence, stay silent. Noise costs reviewer attention; a single sharp comment earns trust.


0. Read these first

  • Root CLAUDE.md — project-wide invariants and conventions.
  • The CLAUDE.md inside the crate(s) the PR touches (e.g. crates/outl-core/CLAUDE.md).
  • CONTRIBUTING.md — the merge bar and "decisions you don't get to revisit".
  • docs/contributing.md — the review policy this file mirrors.
  • docs/development.md — the engineer onramp (build / run / test / debug / CI / release). Load it when the PR touches CI workflows, slash commands, hooks, agents, or anything else a contributor's first 30 minutes depend on.
  • docs/architecture.md, docs/crdt.md, docs/markdown-format.md — load the relevant one when the PR touches that area.
  • The PR description and any linked issue.

Treat the per-crate CLAUDE.md as authoritative over generic Rust opinions. If your suggestion contradicts it, drop the suggestion.



Where the rest of this lives

This file is deliberately short — GitHub recommends repository-wide instructions stay within about two pages, and everything below applies only to certain paths. Copilot loads these in addition to this file whenever a changed file matches their applyTo glob, so a Rust PR gets the Rust bar without a Solid PR paying for it.

File applyTo Carries
instructions/rust.instructions.md **/*.rs Rust quality bar, hot-path performance rules, testing bar
instructions/shared-primitives.instructions.md crates/** The shared primitives catalog — check before approving any new helper
instructions/architecture.instructions.md crates/** Reuse-first violations, documentation-drift blocking
instructions/markdown.instructions.md **/*.md Semantic line breaks, one owner per fact

Read the full file on GitHub · 210 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 · 210 lines · 2,539 tokens per session scan A 05990554557a

Subscribe to this mod's changes

outl copilot-instructions.md is an instructions file published in the GitHub repository outlmd/outl (161 stars, last pushed yesterday), licensed MIT. It adds 2,539 tokens to every session, about $0.0127 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-09-01.