Skip to content

Instantly share code, notes, and snippets.

@johnlindquist
Created December 7, 2025 16:08
Show Gist options
  • Select an option

  • Save johnlindquist/309b4ca38b40bd8082e3c5059b7626b1 to your computer and use it in GitHub Desktop.

Select an option

Save johnlindquist/309b4ca38b40bd8082e3c5059b7626b1 to your computer and use it in GitHub Desktop.
Microsoft AI Dev Days Talk Outline: The Storyteller Perspective

The Last Developer Who Learned to Code

A Talk for Microsoft AI Dev Days

Duration: 15-20 minutes + demos Theme: Software is now instructions + tools. The shift is from learning how to use tools to learning how to create instructions.


Part 1: The Opening Story (3 minutes)

The Hook: "The Night Everything Changed"

[Dim lights, single spotlight]

"It's 2 AM. Sarah is debugging a production issue. She's been at it for four hours. The stack trace is meaningless, the logs are contradictory, and she's running out of ideas.

She types a desperate message into her terminal:

gh copilot explain "why is this service returning 503 errors"

Thirty seconds later, she has her answer. Not from Stack Overflow. Not from a senior engineer. From a conversation with her tools.

Sarah doesn't know it yet, but she just crossed a threshold. She's no longer debugging. She's directing."

The Revelation

Key line to deliver with weight:

"We've spent 50 years learning how to speak computer. We're now entering an era where computers learn to speak human. And that changes EVERYTHING about what it means to be a developer."


Part 2: The Old World vs. The New World (4 minutes)

Analogy: The Orchestra Conductor

"Imagine you wanted to create a symphony. In the old world, you had to:

  1. Learn to play every instrument
  2. Write every note by hand
  3. Perform it yourself

In the new world, you're the CONDUCTOR. You don't play the violin - you tell the violinist what emotion to evoke. You don't write individual notes - you describe the feeling you want the audience to experience.

The musicians are AI. Your baton is a markdown file."

The Tension Point

Build the problem:

"But here's what nobody tells you: GitHub Copilot, Claude, Gemini - they're incredible musicians. But they're sitting in their practice rooms, waiting for instructions. Most developers are still trying to play all the instruments themselves.

They don't realize they can just... conduct."


Part 3: Enter markdown-agent (5 minutes)

Demo 1: The Simplest Agent (2 min)

Setup the demo with story:

"Let me show you what conducting looks like."

Create a file: fix-typos.copilot.md

---
command: copilot
---
Find and fix typos in the README.md file.

Run: ma fix-typos.copilot.md

Narration during demo:

"That's it. That's an agent. A markdown file that tells an AI what to do. The filename says 'use Copilot'. The content is the instruction. Your job just shifted from 'how do I fix this' to 'what do I want fixed'."

Demo 2: The Escalation Pattern (3 min)

Build tension:

"But here's where it gets interesting. What if Copilot can't figure it out? What if the problem is too complex?"

Show the escalation agent: investigate.copilot.md

---
command: copilot
---
Analyze the error in the logs.

If you cannot determine the root cause, output:
ESCALATE: [description of what you found]

Your response will be piped to a more capable agent.

The reveal:

ma investigate.copilot.md | ma escalate-to-claude.md

"Your scripts just learned to ask for help. Think about that. We've built software for decades that fails silently or throws cryptic errors. Now your automation can recognize its own limitations and call in reinforcements."


Part 4: The Emotional Core (3 minutes)

Story: "The Junior Developer"

"I want to tell you about Marcus. He joined a team six months ago. Imposter syndrome. Afraid to ask questions. Worried he'd look stupid.

His senior developer showed him this pattern. 'Marcus, you're not alone anymore. You have a study buddy that never judges, never gets tired, and actually wants you to ask questions.'

Marcus now keeps a file called explain.copilot.md. When he doesn't understand something, he doesn't suffer in silence. He asks.

He went from afraid to ask to unable to stop asking.

That's not a productivity improvement. That's a transformation in how we learn."

The Deeper Truth

"We've been telling junior developers for years: 'Don't be afraid to ask questions.' But we built systems where asking questions is slow, interruptive, and socially risky.

Now we've built systems where asking questions is instant, private, and infinitely patient.

The barrier to curiosity just dropped to zero."


Part 5: The Vision (3 minutes)

Demo 3: The Intelligent Script

Setup:

"Let me show you where this is going."

Show a complete workflow: deploy-safely.md

---
command: copilot
---
Review the changes in the current branch.

1. If there are database migrations, output: REQUIRES_DBA_REVIEW
2. If there are security-sensitive changes, output: REQUIRES_SECURITY_REVIEW
3. If the changes are routine, output: SAFE_TO_DEPLOY

Be conservative. When in doubt, escalate.

Narration:

"This isn't just automation. This is judgment. Your CI/CD pipeline now has opinions. It can say 'I'm not sure about this one, let's get a human.'

We're not replacing developers. We're giving them a team of tireless assistants who know when to act and when to ask."

The Analogy: Raising Children

"Think about how we raise children. We don't give them a rule for every situation. We teach them judgment. We teach them to recognize when they're out of their depth and need to ask an adult.

That's what we're doing with AI now. We're not programming robots. We're raising digital children who can think, learn, and know their limits."


Part 6: The Call to Action (2 minutes)

The Challenge

"I have a challenge for you. Tonight - not next week, tonight - create one markdown file. Just one.

Pick the thing that annoys you most about your workflow. The repetitive task. The thing you always forget. The command you can never remember.

Write instructions for it. In plain English. Save it as a .copilot.md file. Run it with ma.

You'll spend 5 minutes writing it. You'll save hours over your career. But more importantly, you'll feel something shift.

You'll realize: I don't work FOR my tools anymore. My tools work for ME."

The Closing Line

[Pause. Make eye contact with the audience.]

"For fifty years, the question was: 'How do I tell the computer what to do?'

The new question is: 'What do I want?'

Welcome to the age of intention.

The best developers won't be the ones who type the fastest.

They'll be the ones who think the clearest.

And now... you have tools that can hear your thoughts."


Demo Script Summary

Demo Duration Purpose Emotional Beat
1. Simple Agent 2 min Show how easy it is "Wait, that's it?"
2. Escalation 3 min Show intelligence "It asks for help?!"
3. Deployment 2 min Show judgment "This changes everything"

Key Phrases to Memorize

  • "Software is now instructions + tools"
  • "You're not coding. You're conducting."
  • "Your scripts learned to ask for help"
  • "The barrier to curiosity dropped to zero"
  • "We're not replacing developers. We're multiplying them."
  • "Welcome to the age of intention"

Backup Stories (if running short/long)

If short: Add the story of the 3 AM oncall where the agent pages a human only when truly stuck

If long: Cut the "Junior Developer" story (but it's the emotional heart, so try to keep it)


Technical Requirements

  • Terminal with large font (24pt minimum)
  • Pre-created demo files (test them!)
  • ma installed and working
  • GitHub Copilot CLI configured
  • Backup: screenshots if live demo fails

Post-Talk Resources

Share these with attendees:

  • markdown-agent repo: github.com/johnlindquist/markdown-agent
  • Escalation pattern examples
  • Community templates

"The best time to plant a tree was 20 years ago. The second best time is now. The best time to start writing instructions instead of code was yesterday. The second best time is tonight."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment