feat: expand tutorial with coding agents intro and self-paced module#37
Merged
Conversation
There was a problem hiding this comment.
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.
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
- 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
force-pushed
the
feature/tutorial-expansion
branch
from
July 10, 2026 14:37
671c07a to
02c5536
Compare
…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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
tutorial.md:workflows/self-paced-module.md) with:Testing
bun test tests/tutorial-expansion.property.test.ts— 29 tests pass covering structural integrity, content bounds, navigation chain, and format consistencyNotes
.kiro/specs/tutorial-expansion/