Use this adjunct skill to distill conversation artifacts into a clear frame that can feed pragma planning.
Source And Adaptation Note
Adopted from rjs/shaping-skills (framing-doc) and adapted for this repository.
Modifications:
- Namespaced as
pragma:shaping-*to avoid routing ambiguity - Explicit pragma re-entry requirements
- Authority boundaries aligned to
docs/shape-pragma-integration.md
When To Use
- Inputs are transcripts, call notes, or scattered stakeholder messages
- The team agrees a problem exists but cannot state it crisply yet
- You need an evidence-backed "why now" before capsule/card work
When Not To Use
- You already have a stable capsule and clear next slice
- The task is implementation-ready and only needs
/pragma:card
Procedure
- Collect source inputs and confirm ordering when chronology matters.
- Extract direct evidence and separate it from synthesis.
- Produce a frame with Problem, Outcome, and boundaries.
- Identify what changed in understanding and what remains uncertain.
- Define the pragma re-entry step.
Required Output
## Frame
[evidence-backed problem and outcome]
## Handoff To Pragma
- Capsule impacts: [terms/invariants to add or revise]
- Candidate cards: [1-3 candidate slice behaviors]
- Open uncertainty: [items requiring `/pragma:spike`]
- Next command: [`/pragma:capsule` or `/pragma:card`]
Constraints
- Do not prescribe implementation details.
- Do not replace capsule authority over vocabulary and invariants.
- Do not route directly to
/pragma:slice.
Lifecycle
- State:
discovery - Next:
/pragma:capsule(default) or/pragma:card(if capsule is stable) - Loop:
/pragma:consult