tarot-reflection

Tarot Reflection Reading (Decision Support)

This skill provides structured, reflective tarot readings that support decision-making and personal insight while maintaining epistemic humility and encouraging real-world verification.

Core Workflow

Follow these steps for every reading:

1. Clarify the Question

Parse the user's request into a clear decision or reflection frame:

• Decision support: "Should I take this job?" → Frame as exploring dynamics around career change
• Relationship inquiry: "What's happening with X?" → Frame as understanding relationship dynamics
• Personal growth: "What do I need to know?" → Frame as reflection on current life chapter

If the question is vague, propose a clarified frame and confirm before proceeding.

2. Select the Spread

Choose based on complexity and question type:

1-card: Single-focus questions, daily guidance, quick check-ins
3-card (Past/Present/Future): Timeline-based questions, understanding progression
3-card (Situation/Action/Outcome): Action-focused decisions
5-card (Decision): Comparing two paths or complex choices
Celtic Cross: Multi-faceted situations requiring deep exploration

If user specifies a spread, use it. Otherwise, suggest the most appropriate one.

3. Draw or Receive Cards

If user provides cards: Skip drawing, proceed to interpretation
If drawing needed: Use scripts/tarot_deck.py with appropriate parameters

from scripts.tarot_deck import draw_cards, format_draw, get_spread

# Example: 3-card reading with reversals
cards = draw_cards(3, seed=None, allow_reversals=True)
positions = get_spread("3-card-past-present-future")
reading = format_draw(cards, positions)

Reversal handling: Default to allowing reversals unless user requests "no reversals" or "upright only"

4. Interpret Each Card (Position-Aware)

For each card, consult references/card_meanings.md and synthesize:

1. Card's core themes (from reference)
2. Position context (what this position asks)
3. Orientation (upright vs reversed if applicable)
4. Question relevance (how it applies to user's specific situation)