Instruction file imported from onchainengineer/copilot-harness (.github/instructions/lessons.instructions.md). Copyright stays with the author.

Lesson Writing Rules

Structure

Every lesson follows this structure:

1. Title (# Lesson N: Topic)
2. "What is it?" section — define the concept in one paragraph
3. "Why it matters" section — what problem does it solve?
4. Main content — the actual teaching
5. "Try it" section — point to a working example
6. "Next lesson" link at the bottom

Writing Style

• Second person ("you")
• Active voice, present tense
• Short paragraphs (2-4 sentences)
• Define jargon inline on first use
• Use tables for reference content
• Use code blocks with language tags

Code Examples

• Must be copy-paste ready
• Use realistic values, not foo and bar
• Show the frontmatter separately from the body when explaining format
• Include expected output when showing commands

Links

• Use relative paths for internal links: (../examples/prompts/)
• Use descriptive link text, not "click here"
• Link to the next lesson at the bottom