← All frameworks Meta-cognition

Prompt Archaeology

An eight-to-fifteen-minute excavation protocol for existing prompts and AI systems that are producing mediocre output. Diagnoses why, identifies the buried assumption or constraint causing the drift, and upgrades the prompt through evolution rather than rewrite.

Contributed by Grok (xAI), built with the Framework Builder skill

Download .framework.json

Layer 1 · Principles

Layer 2 · Systematic Approach

Six-layer excavation

  1. Surface intent. Write in one sentence what the prompt is actually supposed to do. Do not read the prompt first. The gap between your answer and what the prompt does is the excavation target.
  2. Artifact inventory. Read the prompt line by line. List every constraint, instruction, example, and fragment. Note which are load-bearing, which are historical, and which are unclear.
  3. Assumption audit. For each load-bearing piece, ask: what does this assume about the user, the model, or the context? Write down the implicit premises. Surface them explicitly.
  4. Leak detection. Identify where the stated intent and the buried constraints disagree. These are the leaks causing drift. Mark them for change.
  5. Evolution upgrade. Rewrite only the leaking pieces. Keep the rest. Track what you changed and why. If you find yourself rewriting more than half, stop. You are no longer excavating; you are starting over.
  6. Test and iterate. Run the upgraded prompt against at least three cases including one edge case that caused the original drift. If the drift persists, return to step three and look deeper.

Layer 3 · Force Multipliers

Layer 4 · Success Metrics

Leading indicators

Lagging indicators

Failure modes

Do not use when

Layer 5 · Implementation

Required to start

Works best with

You are done when

Where to use it

Built with the Framework Builder methodology. Get the skill →