# Activity Update Instructions

Plain-language guide for editing everything in this portfolio. No coding background
needed — you'll use a web browser and a text editor (Notepad, TextEdit, or VS Code).

---

## How to update the Jeopardy game

The game ships as a **blank template** with placeholder clues. Everything you edit
lives in one clearly marked section.

1. Right-click `jeopardy-training-game.html` → **Open with** → a text editor.
2. Scroll to the banner that says `* EDIT YOUR GAME HERE *` (near the top of the code).
3. Set `GAME_TITLE` — the heading shown above the board.
4. Fill in `BOARD`. There are five blocks, one per **category (column)**, left to right.
   In each block:
   - `category` — the column title across the top.
   - `clues` — five entries that fill the column **top to bottom**: the 1st is the
     $100 row, the 2nd is $200, and so on through $500. For each:
       - `clue` — what players see on screen.
       - `answer` — the correct response, revealed after they guess.
5. Fill in `FINAL_JEOPARDY` — its `category`, `clue`, and `answer` (the bonus round
   that appears after the whole board is cleared).
6. **Save**, then open the file in a browser to play.

**Tips**
- Keep 5 categories and 5 clues each so the 5×5 board stays full.
- Keep every clue and answer inside its `"quotes"`.
- Need a line break inside an answer? Type `\n` where the break should go.
- Need a quote mark inside text? Type `\"` — e.g. `"the \"Mult\" code"`.
- The placeholders are labeled by position (e.g. `[ Category 1 · $100 clue ]`), so it's
  easy to see which board square you're editing while you test.

The game also includes a team scoreboard (up to 10 teams), an on-screen timer, and
live scoring — none of which you need to edit; they just work.

---

## How to update the Wheel of Names

No file editing needed.
1. Open `wheel-of-names.html` in a browser.
2. Type or paste your roster into the box (one name per line) and click **Update Wheel**.
3. Click **Spin** to pick someone. It can auto-remove a name once it's picked, and
   **Save** stores your current list in that browser for next time.

---

## How to update the Match Game

The game ships as a template with light, generic prompts you can keep or replace.

1. Right-click `match-game.html` → **Open with** → a text editor.
2. Scroll to the banner `* EDIT YOUR PROMPTS HERE *`.
3. Each line is one fill-in-the-blank prompt. Use `______` for the blank players fill in.
   - Keep each prompt inside its `"quotes"`; separate them with commas.
   - Add or remove lines freely.
4. **Save**, then open the file in a browser.

You can also edit prompts live inside the game (add, edit, or remove them on the Prompts
panel) and click **Restore Defaults** to start over. To run it: paste participant names,
click **Divide Teams**, then **Start Game**.

---

## How to update the Family Feud questions

The game ships as a template with generic survey questions.

1. Right-click `family-feud.html` → **Open with** → a text editor.
2. Scroll to the banner `* EDIT YOUR QUESTIONS HERE *`.
3. Each entry is one question:
   - `q` — the question players see.
   - `answers` — each answer has `t` (the text) and `p` (its points).
   - The points for all answers in a question should total about **100**.
   - List answers from highest points to lowest.
4. Keep text inside `"quotes"`; separate entries with commas. Add or remove questions freely.
5. **Save**, then open the file in a browser. Set up teams, and click **Open Audience
   Window** to show the game board on a shared screen while you run it.

---

## How to update the Training Agenda workbook

1. Open `training-agenda-and-class-organizer.xlsx` in Excel or Google Sheets.
2. The workbook has separate sheets: a roster/agent list, agent details, attendance,
   one sheet per training week, and a proposed-schedule sheet.
3. Fill in the weekly agenda, roster, and attendance. The **“Select”** cells are
   dropdowns — pick from the list to keep entries consistent.
4. The sheets ship with placeholder rows (e.g. *Name 1*, *Agent (Last, First)*,
   *Date Here*). Replace them with your own cohort's details.
5. **Save** when done. Keep a clean copy as your master template.

---

## How to customize the prompt library

1. Open `ai-trainer-prompt-library.md` in a text editor.
2. Replace the **[bracketed]** parts with your real topics, roles, and content.
3. Add your own prompts by copying the format of an existing one.
4. Save. Open the file again to read your updated version.

---

## How to duplicate templates

1. Select the file (for example `facilitator-activity-builder.md`).
2. Copy and paste it in the same folder.
3. Rename the copy to match the class (for example `activity-onboarding-week1.md`).
4. Edit the **copy** and leave the original as a clean master.

---

## How to review AI-generated material

Before any AI-drafted content reaches a learner, check that it's:
- **Accurate** — every fact and step verified against the official source.
- **Complete** — nothing important dropped while simplifying.
- **Compliant** — matches current policy; flag anything uncertain for an SME.
- **Clear** — a new hire could follow it without extra help.
- **Tested** — read it out loud once and fix anything that trips you up.

Treat AI output as a first draft. You are the editor and the final check.

---

## How to prepare a template for classroom use

1. Replace all sample content with your real content.
2. Fact-check against the current process or policy.
3. Do a dry run: open the tool / read the activity start to finish.
4. Confirm timing fits your session.
5. Save a clean master copy before the day of class.

---

## How to add future documents and links to the portfolio

1. Put files in the right folder:
   - Resume PDF → `documents/`
   - Screenshots → `assets/screenshots/`
2. Open `portfolio/data.js` in a text editor.
3. Update the values between the quotes (resume path, LinkedIn, live site, supporting docs, screenshots).
4. Save and refresh the portfolio. You never need to edit `index.html`.

---

*Keep this guide with the package so anyone can maintain the tools.*
