CLAUDE.md

Lab authoring conventions

Full reference: instructors/context/conventions/lab.md

When editing lab/tasks/

Read before making changes:

• instructors/context/conventions/common.md — writing conventions (formatting, links, alerts, etc.)
• instructors/context/conventions/tasks.md — task structure and design principles

When editing wiki/

Read before making changes:

• instructors/context/conventions/common.md — writing conventions (formatting, links, alerts, etc.)
• instructors/context/conventions/wiki.md — wiki file structure and section patterns

When creating or restructuring a lab

Read before making changes:

• instructors/context/conventions/lab.md — repo structure, README, setup, git-workflow, GitHub templates, VS Code config, task runner, narrative, Docker, CONTRIBUTORS, checklist, security

When editing code (backend/, frontend/)

Read and follow:

• docs/design/architecture.md — C4 architecture, domain model, container layout, component structure, and design decisions
• docs/contributing/conventions/code.md — naming, comments, type safety, linting, shift-left testing, security

When editing instructors/context/conventions/

Read before making changes:

• instructors/context/conventions/conventions.md — conventions for writing conventions

Other files

Do NOT apply task/wiki conventions to files under instructors/ (internal design notes).