Note: Copilot organized and set up this README for me. I'm still going through everything, evaluating it, and making edits where needed. Feel free to check the linked screenshots for verification. Right now this is mostly a temporary template to help me organize the project.
This repository contains architecture documentation, prompt frameworks, and validation materials for an AI-assisted TCG analysis framework built around the UROE v2 and H.E. design architectures.
The framework is designed to improve analytical consistency through structured evaluation layers, verification rules, state tracking, and context re-anchoring mechanisms. Included materials document deck analysis testing , complex MTG interactions, and framework validation examples.
This is an active development project. Documentation, testing, and framework components continue to evolve as new scenarios are evaluated and refined.
**A structured reasoning framework for AI-assisted trading card game analysis. The framework uses layered evaluation, verification rules, state tracking, and context re-anchoring to reduce drift and improve analytical consistency. Future versions are intended to integrate external structured databases to further reduce hallucinations and improve reproducibility.
The framework is:
- ✅ Designed to operate with modern AI systems
- ✅ Tested on complex MTG interactions and deck analysis scenarios
- ✅ Built around deterministic workflows, verification rules, and re-anchoring mechanisms
- ✅ Open source (MIT License)
- ✅ Ready for implementation and expansion
4 validated test cases demonstrating UROE v2 functionality:
| Test | Result | Evidence |
|---|---|---|
| System Initialization | ✅ PASS | View Screenshot |
| MTG Game Profile Recognition | ✅ PASS | View Screenshot |
| Complex Engine Classification | ✅ PASS | View Screenshot |
| UROE v2 Edge Case Resolution | ✅ PASS | View Screenshot |
Additional validation screenshots:
- Extended Test Trace 1
- Extended Test Trace 2
- Gemini Session 2 - Part 1
- Gemini Session 2 - Part 2
- Gemini Session 2 - Part 3
- Gemini Session 2 - Part 4
- UROE v2 Resolution Engine — Deterministic resolution cycle: [S] → [N] → [I] → [M] → [W/V/T/B/H/C] → [STATE UPDATE]
- Core Layers Framework — R, A, C, N, M, Z, I, H, B, V, T framework
- Edge Case Library — Game-specific behavior patterns
- Chat Bot v1 — Universal card game model with resolution engine
- Chat Bot v2 — Enhanced analysis directives
- Dual Personality Framework — Analytical + Coaching AI modes
- Proof of Concept — Validated test results with Gemini
- Thinking Model
- Teaching Model
- Load the system directive from
prompts/chat-bot-v1.mdinto Claude, GPT, or Gemini - Provide a game state and card interaction query
- AI analyzes through UROE v2 cycle and returns layer-by-layer resolution
Example Use Case:
Query: "I have Brainstorm in hand with 1 Blue Mana. Opponent has Chains of
Mephistopheles in play. What happens if I cast Brainstorm?"
Framework Response: [Full UROE v2 cycle trace with exact [S] → [N] → [I] → [M]
sequence and impact on [Z], [H], [V], [C] layers]
The framework provides the architecture for building a full TCG analysis engine:
- Backend: Implement UROE v2 resolution logic in Python/TypeScript
- Game Profiles: Define MTG, Yu-Gi-Oh, Pokémon rules as structured data
- Database: Store card definitions and interaction patterns
- Frontend: Web app or Discord bot for player queries
✅ Multi-Game Support
- Magic: The Gathering (tested)
- Yu-Gi-Oh (architecture ready)
- Pokémon TCG (architecture ready)
- One Piece TCG (architecture ready)
✅ Advanced Resolution
- Stack/Chain handling
- Replacement effects
- Missed timing detection
- State-based effects
- Simultaneous triggers
✅ Teaching Modes
- 6-stage progression from Foundation → Meta Awareness
- Beginner-friendly explanations
- Advanced technical analysis
AI-PoweredTCGAnalysisFramework/
├── docs/
│ ├── proof-of-concept.md ← Test results (START HERE)
│ ├── assets/ ← Screenshots & evidence
│ └── [core specifications]
├── prompts/
│ ├── chat-bot-v1.md ← Universal framework
│ ├── chat-bot-v2.md ← Enhanced directives
│ ├── dual-personality-framework.md
│ └── stress-proof-edge-case-library-v5.md
├── README.md ← You are here
├── CONTRIBUTING.md
└── LICENSE (MIT)
This project is in active development. We're looking for:
- Backend implementation (Python/TypeScript)
- Game rule database architecture
- Frontend (web app / Discord bot)
- LLM integration & prompt optimization
- Game profile definitions (MTG, Yu-Gi-Oh, Pokémon, One Piece)
- Edge case validation
- Test case generation
- Rule accuracy review
- Test the framework with your favorite TCGs
- Report findings & edge cases
- Share use cases & ideas
See CONTRIBUTING.md for details.
Read: UROE v2 Overview
Read: Proof of Concept Test Results
Read: Chat Bot v1 - Complete Framework
- Load
prompts/chat-bot-v1.mdinto Claude/GPT/Gemini - Ask it to analyze a complex card interaction
- See the UROE v2 cycle trace
| Feature | Status | Details |
|---|---|---|
| Universal Framework | ✅ Complete | Works across all major TCGs |
| Deterministic Resolution | ✅ Validated | No hallucination, reproducible |
| Edge Case Handling | ✅ Tested | Handles complex interactions |
| AI Integration | ✅ Ready | Prompts provided for Claude/GPT/Gemini |
| Multi-Game Profiles | 🔄 In Progress | MTG complete, others architected |
| Backend Implementation | ❌ Needed | Seeking developer partner |
| Frontend UI | ❌ Planned | Web app / Discord bot |
MIT License — Free for personal, commercial, and research use.
- Technical questions? Open an issue or start a discussion
- Want to contribute? See CONTRIBUTING.md
- Looking to implement? Reach out — we're building a team
If you use this framework in your project, please reference:
TCG Analysis Framework (UROE v2)
Repository: [https://github.com/oKarismatic/TCGAnalysisFramework]
Framework: Universal Resolution Order Engine v2
License: MIT
(Original README content preserved. Last updated: 2026-06-05)