A comprehensive 45-minute hands-on workshop designed to teach developers how to effectively use Bob, an AI-powered coding assistant.
Duration: 45 minutes
Level: Intermediate developers
Format: Hands-on exercises with live coding
- Navigate Bob's different modes (Plan, Code, Advanced, Ask, Orchestrator)
- Communicate effectively with an AI coding assistant
- Generate production-quality code with tests and documentation
- Debug and refactor code using AI assistance
- Build complete multi-file applications
-
workshop-guide.md - Main workshop guide with all exercises
- Complete timeline and instructions
- 4 progressive hands-on exercises
- Best practices and tips
- Q&A section
-
quick-reference.md - Quick reference card
- Bob's modes and when to use them
- Common commands and patterns
- Request templates
- Troubleshooting tips
-
sample-files-guide.md - Sample files documentation
- Buggy calculator for debugging exercise
- Sample data for web app exercise
- Setup instructions
-
facilitator-guide.md - Comprehensive facilitator guide
- Pre-workshop checklist
- Detailed delivery instructions for each exercise
- Teaching points and discussion topics
- Troubleshooting guide
- Post-workshop activities
-
assessment-rubric.md - Assessment criteria
- Success criteria for each exercise
- Skill level determination
- Competency matrix
- Feedback collection tools
Introduction (5 min)
β
Exercise 1: Quick Start (8 min)
- Learn Bob's modes
- Create first file
- Ask questions
β
Exercise 2: Code Generation (10 min)
- Build password validator
- Write unit tests
- Create documentation
β
Exercise 3: Debugging & Refactoring (10 min)
- Fix buggy code
- Refactor to best practices
- Optimize performance
β
Exercise 4: Multi-file Web App (10 min)
- Plan application
- Build Quote of the Day app
- Test and enhance
β
Wrap-up & Q&A (2 min)
-
Required:
- Bob AI assistant access
- Basic programming knowledge
- Internet connection
- Code editor of your choice
-
Recommended:
- Familiarity with JavaScript
- Understanding of web development basics
- Git installed (for version control)
-
Access Bob
- Ensure you have Bob AI assistant available
- Familiarize yourself with the interface
-
Verify Access
- Open Bob interface
- Test switching between modes
- Ensure you can send requests
-
Download Workshop Materials
- Clone or download this repository
- Open the workshop folder in your code editor
- Review the workshop-guide.md
- Read through
workshop-guide.md - Complete exercises in order
- Use
quick-reference.mdfor help - Check your progress with
assessment-rubric.md - Practice with bonus challenges
- Review
facilitator-guide.mdthoroughly - Complete the pre-workshop checklist
- Prepare sample files from
sample-files-guide.md - Follow the delivery guide during the workshop
- Use
assessment-rubric.mdto evaluate participants - Collect feedback for continuous improvement
- Arrive with prerequisites installed
- Follow along with
workshop-guide.md - Keep
quick-reference.mdopen for reference - Ask questions anytime
- Complete the exercises at your own pace
- Experiment and explore beyond the exercises
By the end of this workshop, participants will be able to:
β Understand Bob's Capabilities
- Know when to use each mode
- Understand Bob's strengths and limitations
- Navigate the interface confidently
β Communicate Effectively
- Write clear, specific requests
- Provide appropriate context
- Iterate on results
β Generate Quality Code
- Create well-structured functions
- Write comprehensive tests
- Produce professional documentation
β Debug and Refactor
- Identify bugs with AI assistance
- Apply best practices
- Optimize code quality
β Build Complete Applications
- Plan before coding
- Work with multiple files
- Create functional web applications
Goal: Learn Bob's modes and basic interactions
Tasks:
- Create a utility function in Code mode
- Ask for explanations in Ask mode
- Generate a project plan in Plan mode
Skills: Mode navigation, basic requests, understanding outputs
Goal: Build a complete module with tests and documentation
Tasks:
- Create a password validator with validation rules
- Generate comprehensive unit tests
- Write professional documentation
Skills: Code generation, testing, documentation, code review
Goal: Fix bugs and improve code quality
Tasks:
- Debug intentionally buggy calculator code
- Refactor to follow best practices
- Optimize for performance
Skills: Debugging, refactoring, best practices, code quality
Goal: Build a complete web application
Tasks:
- Plan a "Quote of the Day" application
- Implement HTML, CSS, and JavaScript
- Test and add bonus features
Skills: Project planning, multi-file development, full-stack basics
The workshop includes sample files for hands-on practice:
Intentionally buggy code for Exercise 3 with:
- Division by zero issues
- Missing return statements
- Type coercion problems
- Logic errors
- Naming inconsistencies
Sample quote data for Exercise 4 with:
- 10 quotes across 3 categories
- Structured JSON format
- Ready for web app integration
See sample-files-guide.md for complete details and setup instructions.
-
Start with Planning
- Use Plan mode for complex tasks
- Break down large projects
- Review plans before coding
-
Be Specific
- Provide clear requirements
- Include relevant context
- Specify technologies and patterns
-
Iterate and Refine
- Review all generated code
- Request improvements
- Build incrementally
-
Use the Right Mode
- Plan (π) - Design and strategy
- Code (π») - Fast implementation
- Advanced (π οΈ) - Complex tasks
- Ask (β) - Learning and analysis
- Orchestrator (π) - Multi-phase projects
-
Always Review
- Test generated code
- Understand what Bob creates
- Ask questions when unclear
Minimum Success:
- Complete 3 out of 4 exercises
- Understand Bob's modes
- Create working code
Full Success:
- Complete all 4 exercises
- Produce quality code
- Apply best practices
Excellence:
- Complete bonus challenges
- Help other participants
- Demonstrate mastery
Indicators:
- 80%+ completion rate
- Positive participant feedback
- Increased confidence with Bob
- Post-workshop usage
- Ask facilitator questions
- Help fellow participants
- Use quick reference card
- Experiment freely
- Review workshop materials
- Practice with personal projects
- Join Bob community
- Share your experiences
- Bob documentation
- Community forums
- Video tutorials
- Example projects
This workshop is continuously improved based on:
- Participant feedback
- Facilitator observations
- Industry best practices
- New Bob features
- Share feedback
- Suggest improvements
- Report issues
- Submit examples
This workshop is designed for educational purposes. Feel free to:
- Use for training sessions
- Adapt for your organization
- Share with colleagues
- Modify exercises
Please maintain attribution and share improvements back to the community.
Created for developers learning to work effectively with AI coding assistants. Special thanks to all workshop participants whose feedback has helped refine these materials.
For questions, feedback, or support:
- Workshop issues: [Create an issue]
- General questions: [Contact information]
- Community: [Forum/Discord link]
Ready to master Bob? Start with workshop-guide.md and begin your journey to AI-assisted development! π