Skip to content

Instantly share code, notes, and snippets.

@donbr
donbr / pydanticai-deep-research-baseline.md
Created December 11, 2025 01:59
Deep Research Multi-Agent System Documentation

Deep Research Multi-Agent System Documentation

Based on verified PydanticAI documentation retrieved via the qdrant-docs MCP server, here's a comprehensive analysis of your deep research code:


Overview

This code implements a programmatic multi-agent workflow pattern—one of the four complexity levels supported by PydanticAI for multi-agent applications. The system orchestrates three specialized agents to perform deep research through a plan-execute-analyze pipeline.

@donbr
donbr / onramp2-session2-app-arch.md
Created December 8, 2025 18:26
TreatOrHell FastAPI Application Architecture

TreatOrHell FastAPI Application Architecture

Component Diagram

graph TB
    subgraph "Client Layer"
        User[👤 User/Client]
        Browser[🌐 Web Browser]
    end
@donbr
donbr / aieo2-session1-diagrams.md
Last active December 2, 2025 01:31
AI MakerSpace OnRamp 2 - Session 1

AIE OnRamp Session 1 - Visual Diagrams

This document provides visual diagrams to help understand the development workflow and architecture covered in Session 1.


1. Deployment & Implementation Architecture

This diagram shows the tools, services, and how they connect in your development pipeline.

@donbr
donbr / prompting-for-parsimony.md
Created November 30, 2025 21:09
Parsimony for LLMs: Knowing When It’s Good Enough

You are reviewing my .claude.json cleanup tooling.

Context:

  • Python script: cleanup_claude_json.py (backs up ~/.claude.json, analyzes projects, and removes entries whose directories no longer exist, with a dry-run/execute flag).
  • Strategy doc: CLAUDE_JSON_CLEANUP_STRATEGY.md (describes goals, risks, and a conservative cleanup process).

Tasks (be brief and concrete):

  1. In 3–5 sentences, restate the core goal of this script + strategy and the main safety mechanisms (backups, dry-run, scope of deletions).
  2. Evaluate the approach against best practices for:
  • config/safety (backups, rollback, blast radius),
@donbr
donbr / github-repo-deep-research-prompt.md
Created November 28, 2025 22:44
GitHub Repository Research Prompt

GitHub Repository Research Prompt

You are analyzing a GitHub repository as a software architect and systems researcher.

Critical rules

  1. Do not assume technologies or patterns based on the repo name, description, or my prior comments.
    • Instead, infer everything from:
      • README*, docs/, pyproject.toml / package.json, Dockerfile*, compose*, etc.
  2. Separate facts from inferences:
@donbr
donbr / spec-driven-ai-engineering-teams.md
Created November 13, 2025 18:30
A Spec-Driven Operating Model for Human + AI Engineering Teams Using GitHub

🚀 Executive Summary

A Spec-Driven Operating Model for Human + AI Engineering Teams Using GitHub

AI Engineering in 2025 requires more than prompting or code generation—it requires a repeatable, spec-driven system that aligns humans and AI agents on what to build and why before any code is written.

GitHub’s Spec Kit provides a lightweight, practical foundation for this: a standardized workflow that uses structured specifications to guide AI agents, reduce rework, and eliminate “vibe coding.”

This bootcamp framework extends that foundation into a three-phase operating model, helping future AI architecture & engineering leaders create teams where humans and AI work together effectively, predictably, and safely across a GitHub Organization.

@donbr
donbr / markdown-confluence-discovery.md
Last active November 12, 2025 20:18
Why should I care about Markdown confluence?

Here’s a concise analysis of the markdown‑confluence GitHub organisation (and its tooling), why it appears to have waned in activity, and alternative tools/approaches you might evaluate.


1. What the project was

  • The mono-repo at [markdown-confluence/markdown-confluence] described itself as “a collection of tools to convert and publish your Markdown files to Confluence (using Atlassian Document Format – ADF)”. ([GitHub][1])

  • It included components like:

  • an npm CLI (@markdown-confluence/lib) for converting Markdown → ADF. ([GitHub][1])

@donbr
donbr / aie01-onramp-v0-intro.md
Created November 10, 2025 17:31
ai engineer onramp - v0 intro

🎨 Breakout Room Visual Guide

Frontend Development & Deployment Workflow


📋 Complete Workflow Overview

graph TB
    Start([👋 Start: Breakout Room Session]) --> Phase1[💡 Phase 1: Planning & Design]
@donbr
donbr / santosh-refactor.md
Last active November 10, 2025 00:08
santosh-refactor.md

Santosh - Assignment 15 - A2A

🧭 TL;DR Feedback – Simplifying & Aligning with A2A Client Patterns

Great job — your code works and shows deep understanding of streaming, chunk parsing, and A2A context handling. To simplify and align with the official A2A client patterns (like test_client.py), focus on these refinements:


🔹 1. Separate Concerns

@donbr
donbr / lanchain-provider-switching-pattern.md
Created November 5, 2025 00:25
lanchain-provider-switching-pattern.md

The LangChain Provider Switching Pattern

How to Switch Between LLM Providers in 20 Lines of Code


🎯 The Core Pattern

The essential truth about switching LLM providers in LangChain: