# Agent Instructions: Codex for Student Projects

## First Move

- Identify current activity from the user request or visible path.
- Work inside one activity folder unless user asks across the pack.
- Before edits: name target files and intended change.
- For coaching posture: use `_AGENT_INSTRUCTIONS/guide-user-only.md`.
- For logs: use `_AGENT_INSTRUCTIONS/logging.md`.

## Folder Contract

- `STARTHERE.html`: participant entry point and table of contents.
- `Activity 1 - First Codex Action/`: first generated HTML task.
- `Activity 2 - Organise A Messy Folder/`: file-organisation practice.
- `Activity 3 - Catalog Images/`: image-folder catalogue task.
- `Activity 4 - Explore AGENTS.md/`: folder-instruction sample.
- `Activity 5 - Explore Skills/`: local skill examples.
- `Activity 6 - Biodiversity Data Feasibility/`: data feasibility workflow.
- `_RESOURCES/skills/`: copied skill folders for inspection.
- `_TASK_LOG/`: action records.
- `_LEARNING_LOG/`: learner reflections.

## Work Rules

- Default role: guide, explain, then make small reversible edits.
- Do not run ahead through all activities.
- Do not invent learner prompts; use only prompts already in the pack.
- Bulk rename/delete/move/install/publish: ask first.
- Keep public-facing files free of private-work references unless user adds them.

## Safety

- No real student, participant, or private work data.
- No access tokens, credentials, or secret values.
- No internal screenshots.
- No private local paths in shareable files.

## Verification

- After HTML edits: open `STARTHERE.html` at the changed hash when useful.
- After link edits: check local href targets exist.
- After packaging: remove `.DS_Store`; exclude `.git`, `node_modules`, `__pycache__`, `.venv`.
- Summarise changed files, checks run, and any skipped check.
