diff --git a/.opencode/agents/orchestrator.md b/.opencode/agents/orchestrator.md new file mode 100644 index 0000000..9377d1f --- /dev/null +++ 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 +- [ ] + - [ ] 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="", subagent_type="general") +// Wait for completion, then: +task(description="Analysis phase", prompt="Load adventure-puzzle-analyzer skill. ", 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 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: "` + +# 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. diff --git a/.opencode/skills/inspiration-page-creator/SKILL.md b/.opencode/skills/inspiration-page-creator/SKILL.md index e2c9ef9..fd72765 100644 --- 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/.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) diff --git a/.opencode/skills/inspiration-page-creator/references/template.md b/.opencode/skills/inspiration-page-creator/references/template.md index 1f5b0d5..53621be 100644 --- 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 + + [](../puzzles/.md) — [1 sentence explicitly connecting this example to the core mechanic of the pattern type, distinguishing from similar types]. --- diff --git a/src/inspiration/syberia.md b/src/inspiration/syberia.md index 9d9bb4b..a7f42ed 100644 --- 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. --- diff --git a/todos/TODOS.md b/todos/TODOS.md index 3b982f9..6656f00 100644 --- 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