The Complete Guide to AI-Driven and Spec-Driven Software Development

Live Demo GitHub Pages Built with Docusaurus

Visit the book online: https://ibrahim4594.github.io/ai-driven-book/

This comprehensive interactive book teaches modern software development using AI-powered tools and Specification-Driven Development (SDD) methodology. Learn how to leverage Large Language Models (LLMs) like GPT-4, Claude, and Gemini to build production-ready applications faster and more efficiently.

• Chapter 1: LLM Foundations
• Chapter 2: AI-Driven Development Introduction
• Chapter 3: AI Tool Landscape
• Chapter 4: Markdown, Prompts & Context Engineering
• Chapter 5: SDD Fundamentals
• Chapter 6: Spec-Driven Methodology
• Chapter 7: Building RAG-Based Chatbots
• Chapter 8: Implementation Guide

• ✅ 40 MCQ Questions - 5 questions per chapter to test your knowledge
• 🎴 Flashcards - Quick review cards for key concepts
• 📊 Beautiful Diagrams - Flowcharts optimized for light/dark mode
• 📈 Reading Progress Bar - Track your progress through the book

• Supports OpenAI (GPT-4o, GPT-4o-mini, GPT-4-Turbo, o1-preview, o1-mini)
• Supports Google Gemini 1.5 Flash
• Context-aware responses from selected text
• Privacy-first: Uses your own API keys

• Responsive mobile-first design
• Dark/Light mode support
• Smooth animations and transitions
• Professional glassmorphism effects

• Framework: Docusaurus v3.9.2
• Frontend: React 19, TypeScript
• Backend: FastAPI (Python)
• Styling: CSS Modules
• Diagrams: Mermaid.js
• Code Editor: Sandpack by CodeSandbox
• Deployment: GitHub Pages

• Node.js 20.0 or higher
• npm or yarn

# Clone the repository
git clone https://github.com/Ibrahim4594/ai-driven-book.git
cd ai-driven-book
# Install dependencies
npm install

# Start development server (default port 3000)
npm start
# Start on custom port
npm start -- --port 5656

Visit http://localhost:3000/ai-driven-book/ (or your custom port)

# Create optimized production build
npm run build
# Test production build locally
npm run serve

# Build and deploy
npm run build
npm run deploy

The chatbot requires a backend server for CORS-free API calls.

1. Start Backend:

   cd backend
   double-click start-chatbot-backend.bat

2. Start Frontend:

   npm start

3. Use Chatbot:

   • Click the chat icon in the bottom right
   • Enter your OpenAI or Gemini API key
   • Start chatting!

For detailed setup, see CHATBOT_SETUP.md

ai-driven-book/
├── docs/ # Book content (Markdown)
│ ├── chapters/ # 8 chapters
│ ├── resources.md # AI tools & resources
│ └── 00-preface.md # Book preface
├── src/
│ ├── components/ # React components
│ │ ├── Chatbot/ # AI chatbot
│ │ ├── MCQ/ # Quiz component
│ │ ├── Flashcards/ # Flashcard component
│ │ └── DeveloperFooter/ # Footer with credentials
│ ├── pages/ # Landing page
│ └── css/ # Global styles
├── static/ # Static assets (images, etc.)
├── backend/ # FastAPI backend for chatbot
└── docusaurus.config.ts # Docusaurus configuration

1. Read the Preface - Understand the book's philosophy
2. Complete Chapter 1-4 - Build foundations in AI & LLMs
3. Study Chapter 5-6 - Master Spec-Driven Development
4. Build Projects (Chapter 7-8) - Apply your knowledge
5. Take Chapter Quizzes - Test your understanding
6. Review Flashcards - Reinforce key concepts

• Panaversity GitHub: https://github.com/panaversity
  • Agentic AI Learning
  • Generative AI Courses
  • Prompt Engineering Guide
• Resources Page: View all AI tools and learning materials

Ibrahim Samad

Full-Stack Developer | AI Specialist | Educator

• 🏆 HBL P@SHA Winner
• 🥇 Eastern Michigan University - 1st Prize
• 🎖️ NED University - D2D Program
• 👨‍🏫 Sr. Instructor
• 🎓 UTech Ambassador
• 🚀 NASA Ambassador

Agentic AI | Robotic AI | Gen AI | Python | DevOps | Ethical Hacking | Data Science | Machine Learning | Kubernetes | MCP | Docker | Flutter

• GitHub: Ibrahim4594
• This Project: ai-driven-book

Copyright © 2025 Ibrahim Samad. All rights reserved.

This is a personal educational project. If you find any issues or have suggestions, feel free to open an issue!

• Built with Docusaurus
• AI-powered development with Claude Code
• Learning materials inspired by Panaversity
• Community support from AI development communities

Ready to start your AI-driven development journey?

👉 Visit the Book | 📖 Read the Preface | 🚀 Get Started