Skip to content

dzwietering/bobshop

Repository files navigation

Bob Workshop: Mastering Your AI Coding Partner

A comprehensive 45-minute hands-on workshop designed to teach developers how to effectively use Bob, an AI-powered coding assistant.


πŸ“š Workshop Overview

Duration: 45 minutes
Level: Intermediate developers
Format: Hands-on exercises with live coding

What You'll Learn

  • 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 Materials

For Participants

  1. 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
  2. quick-reference.md - Quick reference card

    • Bob's modes and when to use them
    • Common commands and patterns
    • Request templates
    • Troubleshooting tips
  3. sample-files-guide.md - Sample files documentation

    • Buggy calculator for debugging exercise
    • Sample data for web app exercise
    • Setup instructions

For Facilitators

  1. 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
  2. assessment-rubric.md - Assessment criteria

    • Success criteria for each exercise
    • Skill level determination
    • Competency matrix
    • Feedback collection tools

🎯 Workshop Structure

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)

πŸš€ Getting Started

Prerequisites

  • 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)

Setup Instructions

  1. Access Bob

    • Ensure you have Bob AI assistant available
    • Familiarize yourself with the interface
  2. Verify Access

    • Open Bob interface
    • Test switching between modes
    • Ensure you can send requests
  3. Download Workshop Materials

    • Clone or download this repository
    • Open the workshop folder in your code editor
    • Review the workshop-guide.md

πŸ“– How to Use This Workshop

For Self-Paced Learning

  1. Read through workshop-guide.md
  2. Complete exercises in order
  3. Use quick-reference.md for help
  4. Check your progress with assessment-rubric.md
  5. Practice with bonus challenges

For Facilitators

  1. Review facilitator-guide.md thoroughly
  2. Complete the pre-workshop checklist
  3. Prepare sample files from sample-files-guide.md
  4. Follow the delivery guide during the workshop
  5. Use assessment-rubric.md to evaluate participants
  6. Collect feedback for continuous improvement

For Workshop Participants

  1. Arrive with prerequisites installed
  2. Follow along with workshop-guide.md
  3. Keep quick-reference.md open for reference
  4. Ask questions anytime
  5. Complete the exercises at your own pace
  6. Experiment and explore beyond the exercises

πŸŽ“ Learning Outcomes

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

πŸ“Š Workshop Exercises

Exercise 1: Quick Start (8 minutes)

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


Exercise 2: Code Generation & Testing (10 minutes)

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


Exercise 3: Debugging & Refactoring (10 minutes)

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


Exercise 4: Multi-file Web App (10 minutes)

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


πŸ› οΈ Sample Files

The workshop includes sample files for hands-on practice:

buggyCalculator.js

Intentionally buggy code for Exercise 3 with:

  • Division by zero issues
  • Missing return statements
  • Type coercion problems
  • Logic errors
  • Naming inconsistencies

quotes-data.json

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.


πŸ’‘ Best Practices

Working with Bob

  1. Start with Planning

    • Use Plan mode for complex tasks
    • Break down large projects
    • Review plans before coding
  2. Be Specific

    • Provide clear requirements
    • Include relevant context
    • Specify technologies and patterns
  3. Iterate and Refine

    • Review all generated code
    • Request improvements
    • Build incrementally
  4. Use the Right Mode

    • Plan (πŸ“) - Design and strategy
    • Code (πŸ’») - Fast implementation
    • Advanced (πŸ› οΈ) - Complex tasks
    • Ask (❓) - Learning and analysis
    • Orchestrator (πŸ”€) - Multi-phase projects
  5. Always Review

    • Test generated code
    • Understand what Bob creates
    • Ask questions when unclear

🎯 Success Metrics

Participant Success

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

Workshop Success

Indicators:

  • 80%+ completion rate
  • Positive participant feedback
  • Increased confidence with Bob
  • Post-workshop usage

πŸ“ž Support & Resources

During Workshop

  • Ask facilitator questions
  • Help fellow participants
  • Use quick reference card
  • Experiment freely

After Workshop

  • Review workshop materials
  • Practice with personal projects
  • Join Bob community
  • Share your experiences

Additional Resources

  • Bob documentation
  • Community forums
  • Video tutorials
  • Example projects

πŸ”„ Continuous Improvement

This workshop is continuously improved based on:

  • Participant feedback
  • Facilitator observations
  • Industry best practices
  • New Bob features

Contribute

  • Share feedback
  • Suggest improvements
  • Report issues
  • Submit examples

πŸ“ License & Usage

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.


πŸ™ Acknowledgments

Created for developers learning to work effectively with AI coding assistants. Special thanks to all workshop participants whose feedback has helped refine these materials.


πŸ“§ Contact

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! πŸš€

About

IBM bob workshop created by bob

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors