Skip to main content

Stage 1: AI Reality & Limitations

Understanding AI coding's capability boundaries and best practices

Why Is This Stage Important?

After experiencing the magic of AI tools, understanding their limitations is equally important. This stage helps you build realistic expectations and avoid common pitfalls.

This masterclass from Riley Brown will take you from beginner to expert. Learn how to write effective prompts, understand AI limitations, and build real projects with AI assistance.

Watch on YouTube

Learning Outcomes

In this stage, you will:

  • Understand AI coding limitations
  • Learn when to rely on AI and when to rely on yourself
  • Identify AI hallucinations and errors
  • Master better prompting techniques
  • Know when AI is helping and when it's causing problems

AI Strengths and Limitations

What AI Excels At

Task TypeExamplesReliability
Boilerplate codeGenerate CRUD functions, form validation⭐⭐⭐⭐⭐
Common patternsSQL queries, regex, Excel formulas⭐⭐⭐⭐⭐
Quick prototypesSmall tools, scripts, automation⭐⭐⭐⭐
Code explanationReading and explaining existing code⭐⭐⭐⭐
Format conversionJSON to CSV, data cleaning⭐⭐⭐⭐

What AI Struggles With

Task TypeWhy It's DifficultRecommended Approach
Complex architectureRequires global perspective and business understandingPlan yourself first, then have AI implement details
Novel problem solvingAI relies on patterns in training dataBreak down problems, verify step by step
Security-critical codeMay have hidden vulnerabilitiesManual review + security testing
Performance optimizationLacks runtime contextUse profiler, targeted optimization
Latest APIsTraining data may be outdatedVerify with official documentation

What is AI Hallucination?

Hallucination refers to AI confidently providing incorrect or fabricated information.

Common Types of Hallucinations

  1. Fabricated APIs/Functions

    # AI might generate non-existent functions
    import pandas as pd
    df.auto_clean_data() # This function doesn't exist!
  2. Outdated Information

    • Recommending deprecated library versions
    • Using removed syntax
    • Referencing documentation links that no longer exist
  3. Logically Seems Correct but Has Bugs

    # AI-generated code might have boundary condition issues
    def divide(a, b):
    return a / b # Doesn't handle b=0 case

How to Identify Hallucinations

  • Ask AI for sources: Have it provide reference links, then verify
  • Cross-validate: Check with search engines or official documentation
  • Run tests: Always test generated code
  • Stay skeptical: The more confident AI is, the more carefully you should verify

Best Practices for Office Scenarios

Excel/Data Processing

Good practices:

✅ Give AI specific data samples (first 5 rows)
✅ Clearly specify expected output format
✅ Test on small batch before processing all data
✅ Keep backup of original data

Avoid:

❌ Running AI-generated scripts directly on original files
❌ Assuming AI understands your business logic
❌ Skipping result verification

Report/Email Generation

Good practices:

✅ Provide specific background information
✅ Give style samples or templates
✅ Review sensitive information before sending
✅ Check data and fact accuracy

Avoid:

❌ Blindly copy-paste
❌ Including confidential information in AI prompts
❌ Not checking content before sending

Code/Script Generation

Good practices:

✅ Run in test environment first
✅ Understand what the code does (even roughly)
✅ Add error handling and logging
✅ Use version control (can rollback)

Avoid:

❌ Running directly in production
❌ Running code you don't understand
❌ Ignoring error messages

Understanding AI Coding Limitations

  1. Andrej Karpathy on AI Coding

    • Why recommended: Direct insights from a top AI researcher about the real capabilities and limitations of AI coding assistants
  2. Simon Willison: Things I learned about LLMs

    • Why recommended: Practical experience from someone who uses LLMs for coding daily
  3. The False Promise of AI Coding Assistants

    • Why recommended: Stack Overflow's realistic perspective on whether AI can replace software development

Best Practices

  1. GitHub Copilot Best Practices

    • Why recommended: Official guide from GitHub on effective AI coding practices
  2. OpenAI's Prompt Engineering Guide

    • Why recommended: Foundational techniques for getting better results from AI models

Critical Thinking

  1. The Danger of Trusting AI Code Blindly

    • Why recommended: Real case study about the risks of blindly accepting AI-generated code
  2. Testing AI-Generated Code

    • Why recommended: Martin Fowler's insights on validating AI-generated code

Practical Checklist

Before Using AI to Generate Code

  • Have I clearly described my requirements?
  • Have I provided enough context?
  • Do I know what output to expect?

After Receiving AI Output

  • Does the code run?
  • Are there obvious errors or bugs?
  • Are edge cases handled?
  • Do I understand what the code does?

Before Using/Deploying

  • Validated on test data?
  • Is there a backup/rollback plan?
  • Is sensitive information secure?

Next Steps

After completing this stage, you will:

  • ✓ Be able to identify AI's strengths and limitations
  • ✓ Know how to verify AI output
  • ✓ Master best practices for office scenarios
  • ✓ Be ready to learn Stage 2: Context & Architecture

Start Stage 2 →


Need help? Check out our Quick Start or Resources!