agentleFS
ratacatratacat/ratacats-skills/skills/pm-situation-framing/SKILL.md

pm-situation-framing

Skill9 starsChanged 4 months agoMITView on GitHub

Direct-invocation-only; never auto-load. Use only when explicitly named to create or update a PMKNB situation frame.

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. About 0 are common, 14 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈14

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Create a durable, isolated reasoning guide for a PMKNB situation.

    line 15
  2. Distinctive:

    Keep the frame separate from evidence.

    line 19
  3. Distinctive:

    Never turn unsourced interpretation into a claim about the world.

    line 20
  4. Distinctive:

    Prefer gates, keyholders, actors, incentives, clocks, constraints, and observables over narrative summary.

    line 23
  5. Distinctive:

    Use confidence for the frame's reasoning quality, not for the market outcome.

    line 24
  6. Distinctive:

    Keep the frame compact enough for later agents to reuse.

    line 26
  7. Distinctive:

    Write a falsifiable frame thesis: the current best model of what drives the situation.

    line 31
  8. Distinctive:

    Use these labels strictly:

    line 48
  9. Distinctive:

    Do not cite the frame as evidence.

    line 57
  10. Distinctive:

    Do not introduce factual claims unless they are sourced in the active evidence context.

    line 58
  11. Distinctive:

    Do not let actor-model language become factual language.

    line 59
  12. Distinctive:

    Do not write naked predictions.

    line 60
  13. Distinctive:

    Use only when relevant:

    line 132
  14. Distinctive:

    Formal announcement risk: check implementation gaps before treating announcements as execution.

    line 137

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

PM Situation Framing

Create a durable, isolated reasoning guide for a PMKNB situation. A situation frame is not evidence, not a forecast, and not a report. It is a structured model that helps later agents reason, research, and update without mixing facts with interpretation.

Core Rules

  • Keep the frame separate from evidence. Frame judgments are hypotheses until separately sourced.
  • Never turn unsourced interpretation into a claim about the world.
  • Label every material statement as Sourced fact, Frame judgment, Inference, or Speculation.
  • State what would change the frame, not merely what would support it.
  • Prefer gates, keyholders, actors, incentives, clocks, constraints, and observables over narrative summary.
  • Use confidence for the frame's reasoning quality, not for the market outcome.
  • Mark uncertainty explicitly. Do not hide cruxes behind smooth prose.
  • Keep the frame compact enough for later agents to reuse.

Build Process

  1. Define the frame boundary: what the frame covers and excludes.
  2. Write a falsifiable frame thesis: the current best model of what drives the situation.
  3. Identify resolution pathways: gates, choices, decisions, or facts that could resolve the market.
  4. Map actors:
    • actor model: wants, fears, beliefs, constraints, capacities, incentives, action menu.
    • power map: who can make, block, delay, force, legitimate, enforce, or route the outcome.
  5. Surface structure:
    • gates and keyholders
    • pressure points
    • choice points
    • clocks
    • implementation gaps
    • legibility gaps
  6. Identify cruxes, misread risks, observables, and tripwires.
  7. Set evidence standards and update rules.

Evidence Contamination Rules

Use these labels strictly:

  • Sourced fact: externally supported claim already present in the evidence context.
  • Frame judgment: analyst view of what matters or how structure fits together.
  • Inference: reasoning from sourced facts, labeled as reasoning.
  • Speculation: plausible but weakly supported possibility.

Rules:

  • Do not cite the frame as evidence.
  • Do not introduce factual claims unless they are sourced in the active evidence context.
  • Do not let actor-model language become factual language.
  • Do not write naked predictions. Mark them as frame judgments, inferences, or speculation.
  • For every important unsourced claim, replace the claim with Evidence needed.
  • Later agents must separately source any factual claim before using it in research, reports, forecasts, or market-resolution analysis.

Never write:

Actor X will block the outcome.

Prefer:

Frame judgment: Actor X is a likely blocker if its incentives remain aligned against the outcome. Evidence needed: public statement, filing, vote behavior, procedural action, or other observable opposition.

Output Template

# Situation Frame: [market/situation name]

## Frame Boundary
Covers:
Excludes:

## Frame Thesis
[1-3 sentences. Falsifiable. Label any judgment, inference, or speculation.]

## Resolution Pathways
1. [Pathway name]: [gates -> keyholders -> possible resolution route]
2. [Pathway name]: [gates -> keyholders -> possible resolution route]

## Actor / Power Map
| Actor | Wants / Fears | Constraints | Power Over Outcome | Likely Action Menu | Basis |
|---|---|---|---|---|---|
|  |  |  |  |  | Sourced fact / Frame judgment / Inference / Speculation |

## Gates, Clocks, and Pressure Points
| Item | Type | Keyholder | Why It Matters | Observable | Basis |
|---|---|---|---|---|---|
|  | gate / clock / pressure point |  |  |  | Sourced fact / Frame judgment / Inference / Speculation |

## Cruxes
1. [Uncertainty that would materially change the frame]
2. [Uncertainty that would materially change the frame]

## Misread Risks
- [Tempting but possibly wrong story, analogy, or causal model]
- [Source interpretation risk]

## Evidence Standard
What should count:
What should not count:
Evidence needed:

## Update Rules
- If [observable], update toward [frame change].
- If [observable], update away from [frame change].
- If [absence by clock/deadline], update by [rule].

## Tripwires
- [High-impact observable requiring immediate reframing or escalation]

## Research Posture
Best source classes:
Noisy / delayed / adversarial source classes:
Next research moves:

## Frame Confidence
[Low / Medium / High] - confidence in the frame structure, not the market outcome.
Reason:

Pressure Modes

Use only when relevant:

  • Fast-moving news: prioritize tripwires, clocks, and update rules over complete prose.
  • Thin evidence: make legibility gaps explicit; do not fill gaps with confident narrative.
  • Narrative capture: separate actor messaging from actor constraints.
  • Formal announcement risk: check implementation gaps before treating announcements as execution.
  • Procedural market: identify keyholders, gates, and deadlines before discussing incentives.

Quality Bar

A good situation frame:

  • Has a clear boundary and falsifiable thesis.
  • Names who can move, block, delay, force, or legitimate the outcome.
  • Identifies gates and keyholders instead of only summarizing events.
  • Includes observables that would actually update the frame.
  • Contains at least one misread risk.
  • Separates sourced facts, inferences, speculation, and frame judgments.
  • Avoids forecasting language unless explicitly labeled as a hypothesis.
  • Is reusable by a later agent without trust in hidden reasoning.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.