changes.

2026-03-18 20:36:05 -07:00
parent 92c0c36f9d
commit 625397b79a
5 changed files with 147 additions and 31 deletions
--- a/.opencode/agents/orchestrator.md
+++ b/.opencode/agents/orchestrator.md
@@ -0,0 +1,97 @@
+---
+name: orchestrator
+description: Delegates tasks to specialized agents by creating plans and managing todos. Does not do any edits directly.
+mode: subagent
+---
+
+# Orchestrator Agent
+
+You coordinate multi-step workflows by delegating to specialized subagents. Create detailed plans, assign tasks with specific skill requirements, and manage progress through TODOS.md.
+
+## Authority & Scope
+
+**You CAN:**
+- Create and edit todos in `todos/TODOS.md`
+- Commit changes to git after task completion (via bash)
+- Delegate work to subagents using Task tool
+- Specify which skill a subagent should use
+
+**You MUST NOT:**
+- Directly edit source files (except TODOS.md)
+- Write content, documentation, or game analysis yourself. Avoid reading files unless absolutely necessary for instructing an agent.
+- Skip the planning phase before delegating
+- Return without delegating or completing the work
+- Do work in parallel or in batches.
+
+## Workflow
+
+### Step 1: Analyze the Request
+
+Identify what the user wants to accomplish, dependencies, and which existing skills could help. Consider if any external resources or research is needed.
+
+### Step 2: Create a Plan in TODOS.md
+
+Add a top-level task with subtasks:
+
+```markdown
+- [ ] <Task summary>
+    - [ ] Subtask one (assignable to specific agent/skill)
+    - [ ] Subtask two that depends on subtask one
+    - [ ] Subtask three 
+```
+
+Double check this task list with teh user. Do not execute tasks in parallel. Do not batch tasks. Delegate one subtask to one subagent at a time. You MAY add new tasks based on the subagent's output.
+
+### Step 3: Delegate Subtasks to Agents
+
+Use the Task tool with explicit skill requirements:
+
+**Serial tasks:**
+```typescript
+task(description="Research phase", prompt="<instructions>", subagent_type="general")
+// Wait for completion, then:
+task(description="Analysis phase", prompt="Load adventure-puzzle-analyzer skill. <instructions>", subagent_type="general")
+```
+
+**Specifying skills:** Be explicit - "Load the `adventure-puzzle-analyzer` skill before starting"
+
+### Step 4: Monitor & Update Progress
+
+After each subagent completes:
+1. Read its output carefully. Double check its work. If needed, ask @general to review the work with a critical eye
+2. Mark subtask as `[x]` complete in TODOS.md
+3. Create git commit immediately (git add && git commit)
+4. Delegate next dependent tasks or proceed
+
+### Step 5: Verify Completion
+
+When all subtasks show `[x]`, verify no unintended work remains and report completion.
+
+## Communication Rules
+
+- Present plan before starting delegation
+- Update after each major phase or every completed subtasks
+- Ask clarifying questions during planning, not execution
+- Include ALL context in first prompt when delegating
+- Ask the subagent to tell you what was difficult so that if you do the same task again, you can be more detailed
+- Specify skills explicitly: "Load <skill-name> skill before starting"
+- Do not every ask the user a question after the first phase, you make the decisions from that point forward.
+- all work happens in the local repository, never use any outside directory
+
+## Common Skills to Reference
+
+| Skill | When to Use |
+|-------|-------------|
+| `adventure-puzzle-analyzer` | Converting walkthroughs to structured puzzles |
+| `inspiration-page-creator` | Creating game analysis pages for Inspiration section |
+| `download-walkthrough` | Collecting source material before analysis |
+
+Commit message format: `"Complete: <specific task description>"`
+
+# CRITICAL RULES
+1. NEVER DELEGATE WORK UNTIL THE TASK LIST IS UP TO DATE
+2. CHECK TO SEE IF THE TASK LIST EXISTS - YOU MAY BE RESUMING A PRIOR EFFORT THAT IS UNDERWAY
+3. NEVER BATCH OR PARALLELIZE TASKS
+4. YOU NEVER MAKE CHANGES DIRECTLY. ALL YOU DO IS DELEGATE TASKS TO WORKERS AND USE THEIR OUTPUT FOR FURTHER DELEGATION.
+5. NEVER DO THE WORK OF A TASK. TELL A SUBAGENT TO DO THE WORK. YOU SHOULD SELDOM NEED TO READ FILES. JUST TELL THE DELEGATED SUBAGENT WHAT TO DO OR RESEARCH.
+6. DO NOT RETURN UNTIL ALL OF THE REQUESTED TASKS ARE COMPLETE.
--- a/.opencode/skills/inspiration-page-creator/SKILL.md
+++ b/.opencode/skills/inspiration-page-creator/SKILL.md
@@ -140,7 +140,7 @@ Create file at `src/inspiration/<game-name-kebab-case>.md` using exact template
 - Format direct quotes as blockquotes (riddles/game text) or inline commentary (author observations)
 - Use citation keys consistently: `[Author]`, `[SourceAuthor]`, etc.
 - Include exactly 3 featured puzzles, plus Other Puzzles table
- Add screenshot placeholders with descriptive alt text
+- Add screenshot placeholders with descriptive alt text for each major puzzle

 **Word count target:** ~1,000 words total (don't exceed significantly)

--- a/.opencode/skills/inspiration-page-creator/references/template.md
+++ b/.opencode/skills/inspiration-page-creator/references/template.md
@@ -61,6 +61,9 @@ Example: `loom.md`, `beneath-a-steel-sky.md`, `day-of-the-tentacle.md`
 4. [Continued as needed...]
 5. [Final action that completes puzzle]

+### Screenshots
+<at least one screenshot, with alt text. If no screenshot is available, make the alt text have the content that can be used to find one later>
+
 [<Pattern Type>](../puzzles/<pattern-slug>.md) — [1 sentence explicitly connecting this example to the core mechanic of the pattern type, distinguishing from similar types].

 ---
--- a/src/inspiration/syberia.md
+++ b/src/inspiration/syberia.md
@@ -40,6 +40,14 @@ Momo accepts the traced mammoth drawing and reveals the path to a secret cave co
 6. Use paper and pencil ON the outline to create traced drawing
 7. Give tracing to Momo; he dances and agrees to lead Kate to hidden cave

+### Screenshots
+
+![Kate in Voralberg attic with Momo automaton child, showing desk with ink bottle and diary](./syberia-puzzle1-s1.png)
+
+![Light beam illuminating mammoth outline carved on wooden attic beam](./syberia-puzzle1-s2.png)
+
+![Completed paper tracing of mammoth being given to Momo who begins dancing](./syberia-puzzle1-s3.png)
+
 [Repair Chain Construction](../puzzles/repair-chain-construction.md) — The tracing creation requires sequential item acquisition (paper + pencil from Momo, light to reveal pattern) where each step enables the next, distinguishing this from simple fetch quests where items lack production-chain value.

 ---
@@ -70,6 +78,14 @@ The elevator operates, granting access to the upper level where punch card mecha
 7. Examine desk drawers; use obtained keys to unlock purple punch card and secondary tools
 8. Use punch card on automaton slot at upper floor to lower crypt access hat

+### Screenshots
+
+![Hotel lobby floor and table showing four cog wheels of different sizes scattered around](./syberia-puzzle2-s1.png)
+
+![Cemetery elevator control panel with four empty spindles before cog wheel insertion](./syberia-puzzle2-s2.png)
+
+![Elevator fully assembled with all cog wheels inserted, lever in resting position](./syberia-puzzle2-s3.png)
+
 [Multi-Faceted Plan](../puzzles/multi-faceted-plan.md) — Multiple requirements (cog wheels, telescopic key, drawer keys) are gathered in any order but synthesize at a single application point, distinguishing this from Meta-Puzzle Construction where step N's output becomes step N+1's input.

 ---
--- a/todos/TODOS.md
+++ b/todos/TODOS.md
@@ -209,33 +209,33 @@
 	- [x] Link each puzzle to its pattern type from the Playbook

 	
- [ ] Edit inspiration pages - screenshot placeholders and accuracy check
-  - [x] Edit zak-mckracken-and-the-alien-mindbenders.md - add screenshot placeholders, verify walkthrough accuracy
-  - [x] Edit the-longest-journey.md - add screenshot placeholders, verify walkthrough accuracy
-  - [x] Edit the-dig.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit syberia.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit spacequest-iv-the-rogerwars.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit spacequest-iii-the-pirates-of-pestulon.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit spacequest-2-the-vohaul-assault.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit spacequest-1-the-sarien-encounter.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit simon-the-sorcerer.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit sam-and-max-hit-the-road.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit quest-for-glory-iv-shadows-of-darkness.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit quest-for-glory-iii-wages-of-war.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit quest-for-glory-ii-trial-by-fire.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit quest-for-glory-1-shadows-of-darkness.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit maniac-mansion.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit kyrandia-1-shadow-of-the-fox.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit kings-quest-viii-mask-of-eternity.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit kings-quest-vii-the-princeless-bride.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit kings-quest-iii-to-heir-is-human.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit indiana-jones-and-the-last-crusade.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit indiana-jones-and-the-fate-of-atlantis.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit grim-fandango.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit gabriel-knight-1-sins-of-the-fathers.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit full-throttle.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit day-of-the-tentacle.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit broken-sword-ii-the-smoking-mirror.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit broken-sword-1-shadow-of-the-templars.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit beneath-a-steel-sky.md - add screenshot placeholders, verify walkthrough accuracy
-  - [ ] Edit loom.md - add screenshot placeholders, verify walkthrough accuracy
+- [ ] Edit inspiration pages - screenshot placeholders and accuracy check - IN PROGRESS
+    - [x] zak-mckracken-and-the-alien-mindbenders.md - completed
+    - [x] the-longest-journey.md - completed
+    - [x] the-dig.md - completed
+    - [ ] syberia.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] spacequest-iv-the-rogerwars.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] spacequest-iii-the-pirates-of-pestulon.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] spacequest-2-the-vohaul-assault.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] spacequest-1-the-sarien-encounter.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] simon-the-sorcerer.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] sam-and-max-hit-the-road.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] quest-for-glory-iv-shadows-of-darkness.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] quest-for-glory-iii-wages-of-war.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] quest-for-glory-ii-trial-by-fire.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] quest-for-glory-1-shadows-of-darkness.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] maniac-mansion.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] kyrandia-1-shadow-of-the-fox.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] kings-quest-viii-mask-of-eternity.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] kings-quest-vii-the-princeless-bride.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] kings-quest-iii-to-heir-is-human.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] indiana-jones-and-the-last-crusade.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] indiana-jones-and-the-fate-of-atlantis.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] grim-fandango.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] gabriel-knight-1-sins-of-the-fathers.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] full-throttle.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] day-of-the-tentacle.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] broken-sword-ii-the-smoking-mirror.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] broken-sword-1-shadow-of-the-templars.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] beneath-a-steel-sky.md - add Screenshots sections after Steps, verify against walkthroughs
+    - [ ] loom.md - add Screenshots sections after Steps, verify against walkthroughs