All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- 🔧 Top troubleshooting section in README covering:
- Skill add/install issues
- Authentication and subscription problems
- Permission prompts explanation (Allow/Deny/Allow for session)
- File mention
@autocomplete issues - Windows shell gotchas
- 🛟 Lesson fallback handling in SKILL.md for early lessons (S1-S3):
- S1: Fallbacks for
/helpissues, authentication, and subscription problems - S2: Fallbacks for directory/file issues, permission confusion, and @-mention problems
- S3: Fallbacks for permission model confusion and accidental actions
- S1: Fallbacks for
- 🤝 Beginner-friendly troubleshooting with clarifying questions using
ask_user - ✅ Actionable next steps and safe commands in all fallback paths
- 🛤️ Dual-track learning paths (Developer 🧑💻 and Non-Developer 🎨)
- 🤝 CONTRIBUTING.md with local development setup guide
- 📜 CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
- 🧪 TESTING.md with conversation playbooks and QA checklist
- 📋 Issue templates (bug report, feature request, lesson idea)
- 📝 Pull request template
- 🔄 "Reset tutorial" support
- 📖 CLI glossary for non-technical users
- ⚡ Concise Q&A mode for direct technical questions
- 🛡️ Failure handling for offline docs, SQL errors, unclear intent
- 📦 Lesson 1 refactored from "install" to "verify & explore" (user is already running CLI)
- 📚 SKILL.md consolidated to single source of truth with symlink
- 📋 PRD updated with dual-track mermaid diagrams
- 📖 README updated with dual-track lesson tables and architecture diagram
- 🚀 Initial release
- 🎓 6 interactive tutorial lessons for beginners
- ❓ On-demand Q&A mode with live doc fetching
- 📊 SQL-based lesson progress tracking
- 📋 PRD with mermaid workflow diagrams
- 🔒 SECURITY.md with vulnerability reporting policy
- 📄 MIT License