Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Inherits from:simulation/ — all simulation properties plus adventure-specific state.
[!TIP]
This is a general pattern. Text adventure is the reference implementation, but the same architecture powers city sims, cloud management tools, board games — anything where deterministic transforms meet creative narration.
[!TIP]
Perfect for codebase archaeology. "Find where the auth bug was introduced" — that's a quest!
The Premise
An adventure creates a player with state, places them in a room, and the LLM dungeon masters them around.
# characters/├──alice.yml# Human player 1├──bob.yml# Human player 2 ├──merchant.yml# NPC (DM-controlled)├──guard-bot.yml# Autonomous bot (action queue)└──oracle.yml# LLM agent with own goals
Character types:
Type
Controlled By
Example
Player Character
Human via chat
Alice exploring the dungeon
NPC
DM (LLM) responds when addressed
Merchant sells items
Bot
Action queue runs autonomously
Guard patrols on schedule
Agent
LLM with own goals & initiative
Oracle pursues prophecies
All coexist in the same world:
# library/ROOM.ymloccupants:-alice# Player exploring-bob# Another player-librarian# NPC who answers questions-dust-sprite# Bot that cleans autonomously
Selection: Current Character or Swarm (Sims/Populous tradition)
Like The Sims and Populous, you have a selection — who you're controlling right now:
selection:mode:single# or: group, swarmcurrent:alice# commands go to Alice# Or control multiple at once:selection:mode:groupcurrent: [alice, bob, charlie] # "go north" moves all three# Or a whole swarm (Populous/Dungeon Keeper style):selection:mode:swarmfilter: { type:imp, location:mines }
Selection commands:
Command
Effect
SELECT alice
Control Alice
SELECT alice, bob
Control both
SELECT ALL imps
Swarm control
CYCLE
Next character in rotation
Commands apply to selection:
> SELECT alice, bob, charlie
> go north
Alice goes north.
Bob goes north.
Charlie goes north.
adventure:quest:"Find the authentication bug"status:in_progresscurrent_room:"src/auth/"rooms_explored:5clues_found:3hypothesis:"Session cookie not being set"confidence:0.7
LOG.md
# Adventure Log## Day 1: Entering the Auth Dungeon
I stepped into `src/auth/` — a maze of middleware.
**Clues found:**-`session.ts` — handles cookie creation
-`middleware.ts` — checks auth state
**Suspicion:** The cookie is created but never sent...
Commands
Command
Action
GO [direction]
Navigate
LOOK
Describe current room
EXAMINE [object]
Study a file
TAKE [object]
Add to inventory
TALK TO [npc]
Start conversation
COLLECT [clue]
Add to evidence
DEDUCE
Form/update hypothesis
MAP
Show visited rooms
INVENTORY
List held items
DEBUG / DEBUG-ON
Enable debug mode
DEBUG-OFF
Disable debug mode
Debug Mode
Toggle technical output with DEBUG-ON and DEBUG-OFF.
When debug is ON, logs include collapsible sections showing:
File operations (creates, edits, deletes, moves)
State changes with before/after values
YAML data islands with abbreviated data
Markdown links to all referenced files
Technical narrative explaining HOW and WHY
Example debug output:
<detailsopen><summary>📂 <strong>Editing CHARACTER.yml to update player location from start/ to coatroom/</strong></summary>
```yaml
# State change (CHARACTER.yml is canonical)
player:
location: start/ → coatroom/ # Character owns their location
The character file owns location state. ADVENTURE.yml mirrors it for convenience.
identity:classic_adventure:name:Grimappearance:"Weathered human, salt-and-pepper beard..."space_cantina:name:Z-4RTappearance:"Multi-armed service droid..."cyberpunk_bar:name:Nyxappearance:"Chrome-implanted bartender..."
Themeable Rooms (pub/ROOM.yml):
theme:current:classic_adventurethemes:classic_adventure:name:"The Gezelligheid Grotto"bartender:"Grim, a weathered human"menu: ["Ale (1 gold)", "Mystery meat pie (3 gold)"]
space_cantina:name:"The Rusty Hyperdrive"bartender:"Z-4RT, a droid with too many arms"menu: ["Blue milk (1 credit)", "Bantha burger"]
framing:mode: [performance, celebration, tribute]
tribute_protocol:invocation:"Before they arrive, acknowledge we're summoning them"performance:"Depicting them as we imagine their best selves"acknowledgment:"After they depart, note this was a tribute"
