Add AI development tools guide

artificial-intelligence/README.md

@@ -0,0 +1,133 @@
+This guide exists to save time by showing which AI tools are being used and how, so everyone can learn from collective experience rather than starting from scratch.
+
+AI is evolving quickly, and people at thoughtbot are experimenting with different tools in their work. Instead of everyone spending time evaluating tools on their own, this guide brings together our shared experiences so we can learn from each other and make faster, better-informed choices.
+
+This makes the guide a living resource, updated regularly to reflect how our use of AI is changing. It is not a fixed set of rules, but a practical reference that saves time, helps people get started more quickly, and ensures our decisions are built on collective experience.
+
+Here’s how it works:
+	•	Survey and gather input: Once a quarter, we ask everyone what AI tools they are using, how they are using them, and what has or hasn’t worked.
+	•	Create a shared guide: The survey responses are collected here to give visibility into what people are actually using. This lets everyone see the range of tools in play, learn from others’ experiences, and decide what they’d like to experiment with themselves.
+
+# AI in Development Survey Q3 2025 – Summary
+
+## 1. Frequency of AI Usage
+| Frequency | Count |
+|-----------|-------|
+| Daily | 12 |
+| A few times a week | 2 |
+| Occasionally | 3 |
+| Rarely | 1 |
+| Never | 1 |
+
+> **Insight:** Most developers in the survey use AI daily in their work.
+
+---
+
+## 2. AI Models Used
+| AI Model | Count |
+|----------|-------|
+| OpenAI (GPT-3, GPT-4, DALL-E) | 12 |
+| Anthropic (Claude) | 11 |
+| Google AI (Gemini, LaMDA, PaLM) | 2 |
+| Open Source Models | 1 |
+| CodeRabbit | 1 |
+
+> **Insight:** OpenAI and Anthropic are the dominant AI models among respondents.
+
+---
+
+## 3. AI Tools / Software Used
+| Tool / Software | Count |
+|----------------|-------|
+| ChatGPT | 12 |
+| GitHub Copilot | 7 |
+| Claude Code | 6 |
+| Cursor | 3 |
+| Roo Code | 1 |
+| gptel in Emacs | 1 |
+| Other | 4 |
+
+> **Insight:** ChatGPT is the most commonly used AI tool, followed by Copilot and Claude Code.
+
+---
+
+## 4. Where AI is Used
+| Location | Count |
+|---------|-------|
+| Inside the code editor | 12 |
+| In the browser | 8 |
+| In the terminal | 5 |
+| Native apps | 2 |
+| ChatGPT software/app | 2 |
+| Sometimes in desktop apps | 1 |
+
+> **Insight:** Developers mostly use AI integrated into their code editor, with secondary use in browsers or terminals.
+
+---
+
+## 5. Tasks AI is Used For
+| Task | Count |
+|------|-------|
+| Writing code | 14 |
+| Debugging code | 11 |
+| Writing tests | 8 |
+| Explaining unfamiliar code | 11 |
+| Planning features / architecture | 8 |
+| Writing commit messages | 2 |
+| Generating documentation | 3 |
+| Reminders / recalling knowledge | 1 |
+| Autocomplete | 1 |
+| Finding best practices / options | 1 |
+
+> **Insight:** Core programming tasks like writing code, debugging, and understanding code are the most common AI applications.
+
+---
+
+## 6. Prompting Strategies
+| Prompt Strategy | Count |
+|----------------|-------|
+| No specific strategy | 5 |
+| Zero-shot prompting | 4 |
+| Few-shot prompting | 5 |
+| Chain-of-thought prompting | 2 |
+| Persona-based prompting | 3 |
+| Constraint-based prompting | 5 |
+| Iterative prompting | 8 |
+| Asking clarifying questions | 7 |
+| Using templates / pre-defined prompts | 2 |
+| Giving hard constraints (e.g., tests must pass) | 1 |
+
+> **Insight:** Iterative prompting and asking clarifying questions are highly used strategies. Many developers combine multiple strategies.
+
+---
+
+## 7. Agentic AI Usage
+| Usage | Count |
+|-------|-------|
+| Yes, frequently | 3 |
+| Yes, occasionally | 3 |
+| No, not yet | 10 |
+| Never | 1 |
+
+**Agentic AI Tasks:**
+- Automated refactoring across multiple files
+- Generating end-to-end features from a high-level description
+- Automated testing and bug fixing workflows
+- Intelligent code migration/upgrades
+- Research and exploration of new technologies
+
+> **Insight:** Most developers are **not yet using agentic AI**, but those who do focus on automation and feature generation.
+
+---
+
+## 8. AI Tools by Task
+| Task | Tools |
+|------|-------|
+| **Writing Code** | ChatGPT, Copilot, Claude, Cursor, Other |
+| **Debugging** | ChatGPT, Copilot, Claude, Cursor, Other |
+| **Writing Tests** | Copilot, Claude, Cursor, Other |
+| **Code Review** | Copilot, Claude, Other |
+| **Planning & Architecture** | ChatGPT, Claude, Other |
+| **Researching** | ChatGPT, Cursor, Other |
+
+> **Insight:** ChatGPT and Copilot dominate coding and debugging, while Claude is frequently used for planning, testing, and research.