Important
These materials have been almost entirely generated by AI to support learning how to use AI for software engineering tasks. They are primarily intended to showcase how AI-based tools can assist not only with coding, but also with software documentation. While we have run several fact-checking passes on the generated reports and documents, some hallucinations may still remain. Please be advised.
This repository contains documentation and references—primarily AI-generated using the Deep Research feature of Perplexity or Gemini—to support the knowledge base for a 2-hour course focused on AI coding tools and agentic IDEs such as Claude Code, Codex CLI and GitHub Copilot.
ai-coding-tools-course/
├── course-materials/ # Teaching and learning resources
│ ├── slides/ # PDF presentations
│ └── workflows/ # Practical workflow examples
├── research/ # Deep research reports (categorized)
│ ├── foundations/ # Core concepts and architectures
│ ├── tools/ # Tool-specific analyses
│ ├── risks/ # Security and limitations
│ ├── solutions/ # Alternative approaches
│ └── support/ # Supporting tools
├── prompts/ # Templates used to generate content
├── tools-workflows/ # Practical ecosystem guide
└── example-api/ # Code examples
- Slides - PDF presentations covering all major topics
- Workflows - Practical workflow examples (e.g., CRUD operations with Copilot)
Core concepts, architectures, and comparative analyses that form the theoretical foundation:
- Agentic Software Engineering - Technical foundations & enterprise governance frameworks
- Agentic IDE Tools Comparison - Comparative analysis (2021-2026)
- Model Context Protocol - MCP architecture and ecosystem
Detailed analyses of specific AI coding assistants:
- Claude Code - Terminal-native agentic coding tool
- Cursor IDE - AI-first code editor
- GitHub Copilot - AI-assisted pair programmer
Security vulnerabilities, limitations, and constraints:
- LLM Risks Research - Security vulnerabilities & reproducibility threats
- LLM Constraints - Technical & economic limitations
Alternative approaches and privacy-focused options:
- Sovereign Local LLM Ecosystems - Privacy-first systems
- Local-Only Setups - Hardware configurations
- Enhancement Ecosystem - Tools that extend AI coding assistants
Supporting tools and platforms:
- Documentation Tools - AI-powered documentation platforms
Templates used to generate the research content:
- Research Tool Prompt - Template for deep research using AI
- Slides Prompt - Guidelines for presentation generation
- tools-workflows/ - Comprehensive guide to AI coding tool ecosystems (Agent Skills, CodeRabbit, Ollama, Claude Code extensions, DeepWiki, MCP)
The following diagram illustrates how the different documents relate conceptually:
graph TB
%% Core Concepts
ASE[research/foundations/<br/>agentic-software-engineering-report.md]
COMP[research/foundations/<br/>agentic-ide-tools-comparison.md]
MCP[research/foundations/<br/>model-context-protocol.md]
%% Specific Tools
CLAUDE[research/tools/<br/>tool-claude-code.md]
CURSOR[research/tools/<br/>tool-cursor.md]
COPILOT[research/tools/<br/>tool-github-copilot.md]
%% Risks & Constraints
RISKS[research/risks/<br/>llm-risks-research.md]
CONSTRAINTS[research/risks/<br/>llm-constraints-software-engineering.md]
%% Solutions
SOVEREIGN[research/solutions/<br/>sovereign-local-llm-ecosystems.md]
LOCAL[research/solutions/<br/>local-only-setups.md]
ENHANCE[research/solutions/<br/>enhancement-ecosystem.md]
%% Support
DOCS[research/support/<br/>documentation-tools.md]
%% Course Materials
PROMPT[prompts/<br/>research-tool.md]
SLIDES_PROMPT[prompts/<br/>slides.md]
SLIDES[course-materials/slides/]
WORKFLOWS[course-materials/workflows/]
TOOLS_WF[tools-workflows/]
%% Relationships - Core to Tools
ASE -->|implements| CLAUDE
ASE -->|implements| CURSOR
ASE -->|implements| COPILOT
COMP -->|compares| CLAUDE
COMP -->|compares| CURSOR
COMP -->|compares| COPILOT
%% Relationships - Tools to Risks
CLAUDE -.->|has| RISKS
CURSOR -.->|has| RISKS
COPILOT -.->|has| RISKS
ASE -.->|faces| CONSTRAINTS
%% Relationships - Alternatives
RISKS -->|motivates| SOVEREIGN
CONSTRAINTS -->|motivates| SOVEREIGN
SOVEREIGN -->|requires| LOCAL
%% Relationships - Enhancement
CLAUDE -->|enhanced by| ENHANCE
CURSOR -->|enhanced by| ENHANCE
COPILOT -->|enhanced by| ENHANCE
ENHANCE -->|uses| MCP
ASE -->|benefits from| DOCS
%% Relationships - Course Support
PROMPT -->|generates| ASE
PROMPT -->|generates| CLAUDE
PROMPT -->|generates| CURSOR
PROMPT -->|generates| COPILOT
SLIDES_PROMPT -->|guides| SLIDES
ASE & COMP & RISKS & SOVEREIGN -->|presented in| SLIDES
TOOLS_WF -->|practical guide| ENHANCE
TOOLS_WF -->|practical guide| MCP
CLAUDE & CURSOR & COPILOT -->|workflows in| WORKFLOWS
%% Styling
classDef foundation fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
classDef tools fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef risks fill:#ffebee,stroke:#c62828,stroke-width:2px
classDef solutions fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
classDef support fill:#fff3e0,stroke:#ef6c00,stroke-width:2px
classDef course fill:#fce4ec,stroke:#c2185b,stroke-width:2px
class ASE,COMP,MCP foundation
class CLAUDE,CURSOR,COPILOT tools
class RISKS,CONSTRAINTS risks
class SOVEREIGN,LOCAL,ENHANCE solutions
class DOCS support
class PROMPT,SLIDES_PROMPT,SLIDES,WORKFLOWS,TOOLS_WF course
Legend:
- Blue (Foundation): Core concepts and architectures
- Purple (Tools): Specific tool implementations
- Red (Risks): Security and constraints
- Green (Solutions): Alternative approaches and enhancements
- Orange (Support): Documentation tools
- Pink (Course): Teaching materials and guides
Solid arrows show direct relationships; dashed arrows show concerns/motivations.
For newcomers to the repository:
- Start with course materials - Review slides for high-level overviews
- Explore research foundations - Understand core concepts
- Learn specific tools - Deep dive into tool-specific analyses
- Check practical guides - Review tools-workflows for ecosystem recommendations
- Understand tradeoffs - Read about risks and solutions