index.qmd

# Preface {.unnumbered}

## Why This Book Exists

Most developers use AI to get code written faster. They prompt, they paste, they ship. That approach produces code, but it skips the thinking that makes a developer good at their job.

Programming with AI is not just about speed. It is about thinking differently about the development process itself. The developers who get the most from AI tools are not the ones who delegate the most. They are the ones who stay in the conversation: directing, questioning, understanding, and making the architectural decisions that the model cannot make for them.

This book teaches a structured methodology for that conversation. It calls the approach *intentional prompting* — using AI tools with precision and purpose while ensuring you remain the architect and decision-maker throughout.

## Who This Book Is For

- Software developers looking to integrate AI tools effectively into their workflow
- Educators teaching programming in an AI-assisted world
- Students learning to code alongside AI assistants
- Tech leaders developing best practices for AI-augmented development teams

You do not need to be an expert programmer. Basic familiarity with programming concepts will help you get the most from the examples, but the methodology applies at every level.

## What This Book Is Not

This is not a guide to specific AI tools. It does not teach you how to use GitHub Copilot, ChatGPT, Claude, or any particular platform. Interfaces change; the methodology here does not.

It is not a prompt cookbook. You will find prompts throughout, but they are starting points for conversation, not finished products. If you are looking for a library of copy-paste prompts that write your code for you, this is the wrong book.

It is not a book about replacing developers with AI. It argues the opposite: that AI is most powerful when a skilled developer is directing it, and that the skills which make you a good developer — decomposition, abstraction, critical evaluation, architectural judgement — are exactly the skills that make you good at working with AI.

And it is not a book that pretends AI always gets it right. A significant part of the methodology is about recognising when AI output is wrong, understanding why, and knowing how to fix it.

## If You Are Feeling Uncertain

You are not alone. Many developers experience a quiet anxiety: that everyone else has figured this out already, that they are falling behind, that their skills are becoming obsolete. That feeling is nearly universal and rarely admitted. You are not behind. The technology is genuinely new, and the developers who appear to have it all figured out are mostly just a few weeks ahead. This book meets you wherever you are.

## How This Book Is Structured

The book is divided into five parts:

1. **The Philosophy**: Why intentional prompting matters and how it connects to the broader methodology
2. **Foundations**: Core concepts of the human-AI partnership and the principles behind effective collaboration
3. **Methodology**: The six-step programming methodology adapted for AI collaboration
4. **Patterns & Practices**: Effective prompting patterns, debugging, refactoring, and practical case studies
5. **Advanced Topics**: Scaling to complex projects, teaching and learning contexts, and future directions

Each chapter includes practical examples, exercises, and reflections to help you apply these concepts in your own work.

## Conventions Used in This Book

Throughout the book, AI conversations appear as grey monospace blocks labelled **You:** (what you type into the AI) and **AI:** (what comes back). These look like what you would see on screen — plain text, no formatting.

**You:**

```text
This is what a human prompt looks like.
It includes any code you paste into the chat.
```

**AI:**

```text
This is what an AI response looks like.
Same monospace style, just a different label.
```

Narrative text between conversations provides commentary — explaining why the prompt was structured that way, what to notice in the response, and what principle is being demonstrated.

You will also encounter coloured callout boxes. Each serves a different purpose.

::: {.callout-tip title="Practical advice"}
**Green boxes** offer tips you can apply immediately — prompting strategies, workflow suggestions, things to try.
:::

::: {.callout-note title="Key concept"}
**Blue boxes** highlight important ideas worth pausing on — principles of intentional prompting, methodology insights, things to remember.
:::

::: {.callout-warning title="Watch out"}
**Yellow boxes** flag common mistakes or misconceptions — things that look right but lead to poor results.
:::

## The Companion Book

This book applies the methodology developed in *Conversation, Not Delegation: How to Think With AI, Not Just Use It* (Borck, 2025) to software development. That companion book covers the full framework in depth: the Conversation Loop, the VET framework for evaluating AI output, the average-versus-precise decision grid, and the principle of AI Last. If you want the underlying rationale for why the approaches in this book work, or you want to share a discipline-neutral version with non-developer colleagues, start there. Available at [https://michael-borck.github.io/conversation-not-delegation](https://michael-borck.github.io/conversation-not-delegation).

## Related Resources

This guide is part of a series designed to help you master modern software development in the AI era.

```{mermaid}
%%| fig-width: 4
flowchart TD
    CND["Conversation,<br/>Not Delegation<br/>(no code needed)"]
    Think["Think Python,<br/>Direct AI<br/>(complete beginners)"]
    CPPA["Converse Python,<br/>Partner AI<br/>(methodology)"]
    Code["Code Python,<br/>Consult AI"]
    Ship["Ship Python,<br/>Orchestrate AI"]
    Web["Build Web,<br/>Guide AI"]
    CND --> CPPA
    Think --> Code
    CPPA -. read alongside .-> Code
    Code --> Ship
    CND --> Web
    Think --> Web
```

Two ways in: start with *Conversation, Not Delegation* if you want the ideas before (or without) code, or start with *Think Python, Direct AI* if you want to code from your first page. The methodology in *Converse Python, Partner AI* enhances every path.

- **Conversation, Not Delegation** — the general methodology for working with AI across any discipline. No code required; the broadest entry point.
- **Think Python, Direct AI** — computational thinking for absolute beginners. The entry point if you want to code from the start.
- **Converse Python, Partner AI** (this book) — the intentional prompting methodology applied to software development. A companion you can read alongside any Python book.
- **Code Python, Consult AI** — focused Python fundamentals through AI conversation.
- **Ship Python, Orchestrate AI** — professional Python development practices and tooling.
- **Build Web, Guide AI** — web development with AI as your development partner.

All titles are available at [books.borck.education](https://books.borck.education).

## Ways to Engage with This Book

This book is available in several formats. Pick whichever fits how you work and learn.

- **Read it online.** The full book is freely available at the [companion website](https://michael-borck.github.io/converse-python-partner-ai), with dark mode, search, and navigation.
- **Read it on paper or e-reader.** Available as a paperback and ebook through Amazon KDP.
- **Converse with it.** The online edition includes a chatbot grounded in the book's content. Ask it questions about intentional prompting, the six-step methodology, or any concept in the book.
- **Feed it to your own AI.** The `llm.txt` file provides a clean text version of the entire book, ready to paste into ChatGPT, Claude, or any AI tool.
- **Run the code.** All code examples and supplementary materials are available on [GitHub](https://github.com/michael-borck/converse-python-partner-ai). [DeepWiki](https://deepwiki.com/michael-borck/converse-python-partner-ai) provides an AI-navigable view of the repository.
- **Browse all books.** This book is part of a series. See all titles at [books.borck.education](https://books.borck.education).

The online version is always the most current. The printed and ebook editions are updated periodically.

**Feedback and Errata**

Found an error? Have a suggestion?

- Open an issue: [github.com/michael-borck/converse-python-partner-ai/issues](https://github.com/michael-borck/converse-python-partner-ai/issues)
- Email: michael@borck.me