Skip to content

Fix internal inconsistencies in the escape room course#2

Open
matthewwilson wants to merge 1 commit into
mainfrom
fix/course-internal-consistency
Open

Fix internal inconsistencies in the escape room course#2
matthewwilson wants to merge 1 commit into
mainfrom
fix/course-internal-consistency

Conversation

@matthewwilson

Copy link
Copy Markdown
Contributor

While reviewing the IOA escape room slides against this course, three places where the course contradicted itself (or the actual repo layout) came to light. This fixes them so the course is internally consistent.

Changes

  1. Act 2 name. The README.md and the lesson 0 welcome table called Act 2 "The Sea Trials", but lessons 4-7 and copilot-instructions.md call it "The Wireless Room". Settled on The Wireless Room - it is the dominant name and the historically correct setting for the 14 April voyage (the sea trials were 2 April).

  2. Stale paths. Several lessons referenced .github/copilot/agents/, .github/copilot/hooks/ and .github/copilot/.mcp.json, and copilot-instructions.md referenced .github/.mcp.json. The real layout is .github/agents/, .github/hooks/ and a root .mcp.json. Lesson 4's config sample also showed args: ["../../server/index.js"]; corrected to ["server/index.js"] with "cwd": "." to match the shipped .mcp.json.

  3. Act 1 dispatch command. Lesson 2 suggested /fleet … for an exercise that lesson 1 and copilot-instructions.md frame as a task-tool subagent exercise. /fleet is the Act 3 concept; using it in Act 1 blurs the subagents → MCP → fleet arc. Replaced with natural-language task-tool dispatch of three background researcher subagents (the hints already pointed at run_in_background: true).

Related

Companion PR on the slide-decks repo aligns the IOA slides with the implemented course: instil/slide-decks#3

🤖 Generated with Claude Code

Three places where the course contradicted itself or the actual repo
layout:

- Act 2 name: README and lesson 0 called it "The Sea Trials", but
  lessons 4-7 and copilot-instructions.md call it "The Wireless Room".
  Settled on The Wireless Room (also the correct 14 April setting).
- Stale paths: lessons referenced .github/copilot/agents,
  .github/copilot/hooks and .github/copilot/.mcp.json, and
  copilot-instructions.md referenced .github/.mcp.json. The real layout
  is .github/agents/, .github/hooks/ and a root .mcp.json. Lesson 4's
  config sample also showed args ["../../server/index.js"]; corrected to
  ["server/index.js"] with cwd "." to match the shipped .mcp.json.
- Act 1 dispatch: lesson 2 suggested /fleet for what lesson 1 and
  copilot-instructions.md frame as a task-tool subagent exercise. /fleet
  is the Act 3 concept; replaced with natural-language task-tool dispatch
  of three background researcher subagents.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant