Hands-on Coding Assistants

AI coding tools can autocomplete your code, but that's the easy part. The hard part is staying in control: knowing when to delegate, what to review, and how to course-correct before bad suggestions compound.

This workshop teaches a repeatable framework — Plan → Delegate → Review → Correct (PDRC) — inspired by Deming's classic PDCA cycle, but adapted for a world where the one executing your plan is an AI agent, not you. Every module is hands-on: real repos, real tools, real trade-offs.

Module 00 — Foundations & Philosophy

Core concepts, the PDRC mental model, setup, and prompt engineering.

• Ch 1: Introduction & Overview
  Code assistants vs. code agents, tool landscape, where AI delivers proven value, and what AI does NOT do well.
• Ch 2: The Mental Model: Plan, Delegate, Review, Correct (PDRC)
  An adaptation of Deming's PDCA cycle for AI-assisted development — the operational framework for working with coding agents.
• Ch 3: Setup & Practical Integration
  Configuring Copilot/agents in the IDE, repository connection, custom instructions, MCP servers, and the new standalone Copilot CLI.
• Ch 4: Prompt Engineering for Code Assistants
  From basics to advanced prompt structures, context management, and strategies for complex tasks.

Module 01 — Agent Customization

Custom agents, AGENTS.md, repository instructions, and agent skills.

• Ch 5: Custom Agents & Sub-Agents
  Building specialized agents with .agent.md for testing, planning, documentation, and security review.
• Ch 6: AGENTS.md & Project Context
  Using AGENTS.md as a standard for guiding agents with build steps, conventions, and architecture.
• Ch 7: Repository Custom Instructions
  Repository-wide and path-specific instructions with copilot-instructions.md and .instructions.md files.
• Ch 8: Agent Skills & Modular Expertise
  Building and using Agent Skills with SKILL.md and scripts for conditional, modular agent capabilities.

Module 02 — AI in the Daily Development Cycle

Test generation, code review, debugging, refactoring, and documentation.

• Ch 9: Test Generation & Improvement with AI
  AI-assisted TDD, generating unit/integration/E2E tests, and coverage gap analysis.
• Ch 10: AI-Assisted Code Review
  Copilot Code Review, custom review instructions, automatic reviews on PRs, and implementation suggestions.
• Ch 11: Debugging, Refactoring & Iteration with AI
  AI-assisted debugging, legacy code refactoring, codebase onboarding, and iteration strategies.
• Ch 12: Automated Documentation
  Code documentation generation, API/schema docs, AI-assisted commit messages, and PR descriptions.

Module 03 — Extensibility & Integrations

MCP (Model Context Protocol), hooks, validation, and agent automation.

• Ch 13: MCP (Model Context Protocol)
  Open protocol for connecting AI to external systems — configuration, practical examples, and security.
• Ch 14: Hooks, Validation & Agent Automation
  Execute shell commands at key agent execution points, setup steps, and integration with project tools.

Module 04 — Security, Governance & Impact Measurement

AI-first security, governance, impact metrics, and final project.

• Ch 15: AI-First Security & Governance
  Risks, agent firewalls, separating agent access, testing/releasing custom agents, and IP considerations.
• Ch 16: Impact Measurement & Continuous Improvement
  Defining metrics, developer experience data, analyzing agent performance, and spec-driven development.
• Ch 17: End-to-End Final Project
  Complete challenge applying the full PDRC cycle with multi-agent collaboration on a real codebase.

---

License & Attribution
This workshop content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0) . You are free to share and adapt this material for any purpose, including commercial use, as long as you give appropriate credit.

Please cite as: "Hands-on Coding Assistants" by William Oliveira — woliveiras.com