Skip to content

feat: expand tutorial with coding agents intro and self-paced module#37

Merged
stevenjmiklovic merged 15 commits into
mainfrom
feature/tutorial-expansion
Jul 13, 2026
Merged

feat: expand tutorial with coding agents intro and self-paced module#37
stevenjmiklovic merged 15 commits into
mainfrom
feature/tutorial-expansion

Conversation

@stevenjmiklovic

Copy link
Copy Markdown
Collaborator

This pull request was created by @kiro-agent on behalf of @stevenjmiklovic 👻

Comment with /kiro fix to address specific feedback or /kiro all to address everything.
Learn about Kiro Web


Summary

Expands the Kanon tutorial knowledge artifacts to serve as an introduction to coding agents, skills, and harnesses, and creates a standalone self-paced learning module.

Changes

  • 4 new conceptual lessons (Lessons 1–4) prepended to tutorial.md:
    • Lesson 1: What Are Coding Agents? — plain-language intro with before/after example
    • Lesson 2: Understanding Skills and Artifact Types — 8 types table, decision criteria, JHU scenarios
    • Lesson 3: How Harnesses Work — "author once, compile to many" with side-by-side comparison
    • Lesson 4: Getting Started with Skill Creation — bridge lesson with "I can…" readiness checklist
  • Existing 16 lessons renumbered to 5–20 with all navigation updated (ToC, Lesson Index, Next links)
  • New Self-paced Module (workflows/self-paced-module.md) with:
    • Abstract (95 words), Learning Outcomes (6, Bloom's taxonomy), Self-Assessment Checklist, Format section
    • 6 detailed module lessons from concepts through hands-on CLI exercises
  • knowledge.md updated with module reference and accurate 20-lesson tutorial description
  • Property-based validation tests (11 properties, 29 tests) — all passing

Testing

  • bun test tests/tutorial-expansion.property.test.ts — 29 tests pass covering structural integrity, content bounds, navigation chain, and format consistency

Notes

  • Lessons 1–4 contain zero code (no backticks, no CLI commands) per design constraint
  • The self-paced module complements but does not duplicate the tutorial's introductory lessons
  • Spec documents included at .kiro/specs/tutorial-expansion/

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary

This PR successfully expands the Kanon tutorial with 4 new conceptual lessons introducing coding agents, skills, and harnesses, creating a structured learning path from concepts to hands-on practice. All 29 property-based validation tests pass, confirming structural integrity and content quality.

Key Changes

  • ✅ 4 new conceptual lessons (1-4) with zero code examples as designed
  • ✅ Existing lessons renumbered to 5-20 with all navigation updated
  • ✅ New self-paced module with formal learning outcomes
  • ✅ Comprehensive test coverage validating content structure and constraints

The implementation is solid with no blocking issues identified.


You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

Comment thread kanon/tests/tutorial-expansion.property.test.ts Fixed
Comment thread kanon/tests/tutorial-expansion.property.test.ts Fixed
Comment thread kanon/tests/tutorial-expansion.property.test.ts Fixed
Comment thread kanon/tests/tutorial-expansion.property.test.ts Fixed
Comment thread kanon/tests/tutorial-expansion.property.test.ts Fixed
@codecov

codecov Bot commented Jul 9, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

kiro-agent and others added 10 commits July 10, 2026 09:37
- Add 4 new conceptual lessons (1-4) introducing coding agents, skills,
  artifact types, and harnesses in plain language (no code)
- Renumber existing 16 lessons to 5-20 with updated ToC, Lesson Index,
  and Next-link chain
- Create standalone Self-paced Module on Coding Agents and Skill Creation
  with abstract, learning outcomes, format, and 6 module lessons
- Update knowledge.md to reference new module and reflect 20-lesson tutorial
- Add property-based validation tests (11 properties, 29 tests)
- Add spec documents (requirements, design, tasks)

Co-authored-by: Steven J. Miklovic <smiklov1@jh.edu>
Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
- Update tutorial.md Lesson 5 with macOS/Linux, Windows PowerShell,
  package manager (npm, Scoop, WinGet), and WSL install options
- Update self-paced-module.md Lesson 4 'Before You Begin' with
  cross-platform Bun installation instructions
- Update self-paced-module.md Prerequisites to mention Windows shells
  and cross-platform Bun availability
- Add changelog fragment for the addition
…oordinator guide - Rewrite self-paced-module with accurate CLI exercises, safe practice content, formal assessments, and an answer key - Add curriculum-guide workflow with learning paths, facilitation notes, accessibility considerations, and production-readiness questions - Streamline tutorial lesson descriptions for clarity - Update knowledge.md steering table and set inclusion to manual
…ute exercise covering semantic-search retrieval, source verification, incremental reindexing, and safe index scope. Designed to follow the MCP and evaluation lessons.
…TATION.cff version, date, abstract, and keywords - Expand CONTRIBUTING.md with current curriculum, harness list, and Souk Compass workflow guidance
… - Add Rule 7: keep CITATION.cff version and date-released in sync - Add Step 3 to cut-release-cut workflow for CITATION.cff update - Update exit criteria to include CITATION.cff verification - Bump artifact version to 0.1.2
@stevenjmiklovic
stevenjmiklovic force-pushed the feature/tutorial-expansion branch from 671c07a to 02c5536 Compare July 10, 2026 14:37
…flow discovery and non-Markdown file support so imported skills retain progressive-disclosure layout and fixture files (CSV, TXT). Adapters receive the preserved relative path. ADR-0045 documents the decision and trade-offs.
…skills from eudaemon-ai/academic-ai-library-workshop: - facilitate-library-ai-workshop (learner coaching, 4-module course) - run-library-ai-workshop-cohort (cohort facilitation) - practice-library-reference-interview (fictional patron practice) - review-ai-research-output (evidence-focused research review) Includes course references, simulated practice data, and a library-ai-workshop collection manifest. Catalog regenerated.
…ery Plugin installs via git clone found 0 skills because dist/ is gitignored and the claude-code adapter only emits CLAUDE.md (not SKILL.md). Add scripts/generate-plugin-skills.ts (bun run build:skills) that renders discoverable SKILL.md files to kanon/skills/, committed alongside the bridge. Plugin.json now points at ./kanon/skills/. ADR-0046 documents the decision and its relationship to ADR-0020.
…y Change type from power to skill and add claude-code to harnesses so the kanon guide ships as a discoverable SKILL.md in the plugin. Update ADR index and CONTRIBUTING with library-ai-workshop guidance.
@stevenjmiklovic
stevenjmiklovic merged commit 1e76d7a into main Jul 13, 2026
10 of 12 checks passed
@stevenjmiklovic
stevenjmiklovic deleted the feature/tutorial-expansion branch July 13, 2026 18:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants