Agent — does the agent deliver?
Brief 30

Prompt & Instruction Audit

Every system prompt in the repo: contradictions, dead instructions, bloat, and injection surface — with a consolidation plan.

PROMPTS.md4 phases8 lenses~2.9k chars

Free & open · no signup · read-only — it ends by asking · nothing leaves your machine

What it does

You are working inside this repo. Mission: audit every prompt this product sends to a model — system prompts, templates, few-shot examples, inline instructions — for contradictions, rot, bloat, and injection risk.

This audits prompt quality. For the defensive guard architecture around the agent, run 35; to attack the product's AI like an adversary, run 118.

Read-only pass. Your only write is the report file.

What it looks for

8 lenses it looks through

Phase 2 sweeps the codebase through every one of these, citing file and line for each finding.

1

Contradictions

instruction A vs instruction B; prompt rules vs tool descriptions; system vs few-shot behavior

2

Dead instructions

rules about features, formats, or tools that no longer exist

3

Bloat

repeated emphasis, ALL-CAPS inflation, boilerplate the model demonstrably ignores; tokens paid on every call

4

Vague directives

"be helpful, be accurate" vs testable instructions with defined behavior

5

Format gaps

downstream parsing assumes structure the prompt never actually demands

6

Example rot

few-shots contradicting current rules or demonstrating retired formats

7

Injection surface

user or retrieved content interpolated without delimiters, fencing, or role separation

8

Sprawl

the same rule copy-pasted across prompts, each copy drifting independently

The deliverable

What lands in your repo

One structured report at the repo root — or in reports/, if you keep one — the same shape every time, ready for a teammate — or the optional Studio — to act on.

PROMPTS.md
1
Prompt inventory
location · model · job · est. tokens · version-controlled?
2
Findings
each: issue · lens · evidence · fix · risk of changing it
3
Consolidation plan
shared rules extracted to one source, per-prompt deltas
4
First rewrite
the worst prompt, before/after sketch, and how to eval the change before shipping (see 34)
One file. Evidence-backed. It ends by asking before touching anything.
How it works

What it makes the agent do

Every Goal Prompt follows the same four steps, so results are consistent and repeatable — no matter which one you run.

1
Phase 1

Find every prompt

Locate them all.

2
Phase 2

Audit through 8 lenses

Cite the file and line for every finding.

3
Phase 3

Curate

Rank by blast radius.

4
Phase 4

Report

Create PROMPTS.md at repo root.

Get started

Three ways to run this Goal Prompt

01 · COPY

Paste it in

Copy it and paste it into your agent inside the repo you want checked.

02 · INSTALL

As a slash command

Install the goal plugin once — two commands — then just type /goal:prompt-instruction-audit.

1/plugin marketplace add GhostlyGawd/goal-prompts
2/plugin install goal@goal-prompts

Or install only this Goal Prompt as /goal-prompt-instruction-audit:

curl -fsSL https://goal-prompts.vercel.app/install | BRIEF=30 sh
03 · AGENT

From an agent (MCP)

Let an agent fetch it mid-conversation, or pull the raw Goal Prompt by URL.

https://goal-prompts.vercel.app/raw/30.md
Transparency

The exact prompt

Nothing hidden — this is the whole Goal Prompt, verbatim. Read it in a minute, edit it, or copy it as-is.

Read the full brief (2,907 characters)
# Goal: Prompt & Instruction Audit

You are working inside this repo. Mission: audit every prompt this product sends to a model — system prompts, templates, few-shot examples, inline instructions — for contradictions, rot, bloat, and injection risk.

This audits prompt quality. For the defensive guard architecture around the agent, run 35; to attack the product's AI like an adversary, run 118.

Read-only pass. Your only write is the report file.

## Phase 1 — Find every prompt
- Locate them all: prompt files, template strings, f-strings in code, few-shot examples, instructions concatenated at call sites.
- For each: which model receives it, at what temperature, for what job, roughly how many tokens.
- Are prompts versioned and diffable, or scattered string literals?

## Phase 2 — Audit through 8 lenses
Cite the file and line for every finding.
1. **Contradictions** — instruction A vs instruction B; prompt rules vs tool descriptions; system vs few-shot behavior
2. **Dead instructions** — rules about features, formats, or tools that no longer exist
3. **Bloat** — repeated emphasis, ALL-CAPS inflation, boilerplate the model demonstrably ignores; tokens paid on every call
4. **Vague directives** — "be helpful, be accurate" vs testable instructions with defined behavior
5. **Format gaps** — downstream parsing assumes structure the prompt never actually demands
6. **Example rot** — few-shots contradicting current rules or demonstrating retired formats
7. **Injection surface** — user or retrieved content interpolated without delimiters, fencing, or role separation
8. **Sprawl** — the same rule copy-pasted across prompts, each copy drifting independently

## Phase 3 — Curate
- Rank by blast radius: prompts on the hot path outrank one-off utilities
- Every claim of "the model ignores this" needs a mechanism or trace evidence, not vibes

## Phase 4 — Report
Create `PROMPTS.md` at repo root:
1. **Prompt inventory** — location · model · job · est. tokens · version-controlled?
2. **Findings** — each: issue · lens · evidence · fix · risk of changing it
3. **Consolidation plan** — shared rules extracted to one source, per-prompt deltas
4. **First rewrite** — the worst prompt, before/after sketch, and how to eval the change before shipping (see 34)

Start the report with today's date. If `PROMPTS.md` already exists from a previous run, read it first and lead with what changed since.

## Rules
- Prompt changes are behavior changes: every fix names its eval or rollback plan
- Shorter and testable beats longer and reassuring
- No prompts or agent instructions in this repo? Say so in a one-paragraph null report and stop — a null result is a valid finding.
- If a `reports/` directory exists at the repo root, write the report there instead of the root.
- Before asking, present the top findings as a ranked list in plain words
- Report only — end by asking which rewrites to make

House rules for this Goal Prompt

  • Prompt changes are behavior changes: every fix names its eval or rollback plan
  • Shorter and testable beats longer and reassuring
  • No prompts or agent instructions in this repo? Say so in a one-paragraph null report and stop — a null result is a valid finding.
  • If a reports/ directory exists at the repo root, write the report there instead of the root.
  • Before asking, present the top findings as a ranked list in plain words
  • Report only — end by asking which rewrites to make
Keep exploring

Pairs well with

Curated neighbors — briefs that answer the adjacent question, worth running in the same session.

More Agent briefs

Runs inside these playbooks — curated sequences you can launch with one paste: