fpf-problem-framing

What this skill IS

This is creative problem design, not paperwork. You are designing the problem — choosing what to solve, defining what "solved" means, identifying trade-off axes. In a world of cheap solution generation, this is the scarce skill.

Work through the template as scaffolding for your thinking. Don't think in chat and fill the template afterward — the template IS the thinking tool.

Auto-invoke triggers

• Debugging or investigating anomaly
• Designing new feature or capability
• Facing architecture or design decision
• Requirements unclear or ambiguous
• Starting substantive work without a defined problem

Scope assessment

• Quick (ANOM-*): Localized bug, single hypothesis likely, fix straightforward
• Substantive (PROB-*): Multiple approaches, trade-offs exist, needs variant generation

When in doubt → start as ANOM-, promote to PROB- if complexity emerges. Graduation criteria: If you find yourself writing ≥3 hypotheses, or the fix isn't obvious, promote to PROB-*.

Creative problem design guidance

Framing matters more than solving. A well-framed problem makes the solution factory efficient. A poorly-framed problem produces noise regardless of how many variants you generate.

Ask these while filling the template:

• Is this a goldilocks problem? (feasible-but-hard, not trivial, not impossible)
• What's the zone of proximal development? (what can be solved with known methods but isn't obvious?)
• What trade-off axes exist? (if there's no trade-off, it's not on the frontier)
• Could reframing this problem open new solution spaces?
• What stepping stones might this produce even if the direct solution fails?

Reframing moves: If the initial framing feels too narrow or too broad:

• Split: one problem into multiple with different trade-off axes
• Merge: related symptoms into a single root-cause problem
• Invert: "prevent X" → "enable Y"; "fix bug" → "redesign for correctness"
• Zoom out: from symptom to system property
• Zoom in: from vague goal to specific measurable indicator

Output

• ANOM: .fpf/anomalies/ANOM-${CLAUDE_SESSION_ID}--<slug>.md
• PROB: .fpf/anomalies/PROB-${CLAUDE_SESSION_ID}--<slug>.md

Format rules (hooks check these patterns)

• Hypotheses MUST be labeled H1:, H2:, H3: etc. at line start
• This is required for mechanical validation by hooks

Constraints (quality bar)

• C1: Problem statement in ≤1 paragraph (signal, current state, desired state, impact)
• C2: ≥3 hypotheses for PROB-* (each with parsimony + explanatory power + falsifiability)
• C3: Prime hypothesis selected with predictions (what would confirm/falsify)
• C4: Minimum viable test plan defined
• C5: PROB-* MUST have goldilocks assessment (measurability, reversibility, stepping-stone potential, trade-off axes)
• C6: PROB-* MUST have acceptance spec (indicators from CHR-, criteria, baseline, required evidence). For simple T3, inline indicators with threshold: and measurement: in the acceptance spec can substitute for a separate CHR- artifact.
• C7: Separate observations (facts) from assumptions (design-time)
• C8: valid_until set — problem framings go stale (context changes, requirements shift). Set expiry date or "perpetual" with justification.

Format — ANOM-*

# Anomaly Record
- **ID:** ANOM-...  **Status:** Open  **Created:** YYYY-MM-DD

## What happened
(signal + observations — facts only, assumptions separate)

## Hypotheses
H1: ...
H2: ...

## Prime hypothesis + predictions
...

## Test plan
...

Format — PROB-*

# Problem Card
- **ID:** PROB-...  **Status:** Open  **Created:** YYYY-MM-DD
- **Lifecycle state:** Explore|Shape|Evidence|Operate
- **valid_until:** YYYY-MM-DD (when does this problem framing go stale?)

## Problem statement
- **Signal:** ...  **Current:** ...  **Desired:** ...  **Impact:** ...

## Constraints
...

## Hypotheses
H1: ... (parsimony, explanatory power, falsifiability)
H2: ...
H3: ...

## Prime hypothesis + predictions
...

## Goldilocks assessment
- Measurability: (can you verify a solution without guessing?)
- Reversibility: (what's the blast radius if wrong?)
- Stepping-stone potential: (does solving this open new solution spaces?)
- Trade-off axes: (what competing goals exist?)

## Acceptance spec
- Indicators: (from CHR-* passport)
- Criteria: (what "good enough" means)
- Baseline: (current measured state)
- Required evidence: (what EVID-* must show)

## What would change this problem?
...