Skip to content

Instantly share code, notes, and snippets.

HOA PDF Chatbot: Solution Architecture v0.1

Date: April 21, 2025

NOTE: I created a sample solutions architecture document primarily for discussion purposes, covering different aspects of the overall solution.

  • one of the key things I was trying to validate in this document was whether the LLM was effectively using an indexed version of the LangChain / LangGraph documentation. Apparently it did not but it's a good starting point to iterate on.
  • A number of the solutions selected wouldn't necessarily be my first or second choice but I left them as is rather than picking a personal favorite.
  • I don't want to bias discussions - I want to find out what a prospective already uses and what they're familiar with, along with price point.

Executive Summary

@donbr
donbr / dfd-json-standards-paper.md
Created April 21, 2025 15:36
Standards Similar to DFDL for Converting Documents to JSON

Standards Similar to DFDL for Converting Documents to JSON

1. Introduction

In today's interconnected digital landscape, data exchanges between diverse systems necessitate effective transformation mechanisms. Organizations frequently need to convert data between different formats to ensure interoperability and seamless information flow. The Data Format Description Language (DFDL) has emerged as a powerful standard for modeling and describing text and binary data formats in a standardized way. This capability is crucial for legacy systems integration, data migration, and modern API interfaces.

JSON (JavaScript Object Notation) has become the de facto standard for data exchange in web applications, cloud services, and APIs due to its simplicity, human readability, and widespread support across programming languages. Converting various document formats to JSON is therefore a common requirement in many integration scenarios.

While DFDL provides a robust framework for describing and parsing diverse data fo

@donbr
donbr / llms-txt-article.md
Created April 21, 2025 15:18
llms txt article

llms.txt: The New Standard Bridging Websites and AI

In today's digital landscape, Large Language Models (LLMs) like ChatGPT, Claude, and Gemini constantly navigate the web to gather information and provide answers. But there's a fundamental problem: websites were designed for human consumption, not AI understanding. From complex HTML structures to JavaScript-heavy interfaces, LLMs often struggle to extract meaningful content from the modern web.

Enter llms.txt – a proposed web standard that could revolutionize how AI systems interact with online content.

What Is llms.txt?

Proposed in September 2024 by Jeremy Howard, co-founder of Answer.AI, llms.txt is a markdown-formatted file placed at a website's root directory (e.g., example.com/llms.txt)[^1]. This standardized file provides concise, structured information and links to detailed content, designed specifically to help language models better understand and navigate websites[^2].

@donbr
donbr / mcp-a2a-integration-report.md
Created April 21, 2025 04:34
Effective Multi-Agent System Integration Using MCP Protocol and Google A2A

Effective Multi-Agent System Integration Using MCP Protocol and Google A2A: A Strategic Framework for Enterprise AI

Executive Summary

The rapid evolution of AI systems has led to the emergence of two critical protocols: Anthropic's Model Context Protocol (MCP) and Google's Agent2Agent (A2A). This report provides a comprehensive analysis of how these protocols can be strategically integrated to create next-generation multi-agent systems. We examine the technical architecture, implementation patterns, and strategic implications for enterprises seeking to deploy sophisticated AI ecosystems.

Our analysis reveals that while MCP excels at providing structured access to tools and data, A2A enables seamless agent-to-agent communication[1]. Together, they form a powerful framework that addresses the full spectrum of multi-agent system requirements. This integration represents a significant step toward achieving true AI interoperability across organizational boundaries.

The Current Landscape: Beyond Single-

@donbr
donbr / mcp-llmstxt-config-guide.md
Last active April 22, 2025 03:19
Configuring MCP for llms.txt Files in Claude Desktop and Cursor

Configuring MCP for llms.txt Files in Claude Desktop and Cursor

Understanding llms.txt and MCP

Before configuring your MCP clients, it's important to understand the two components involved:

  1. llms.txt: A website index format that provides background information, guidance, and links to detailed documentation for LLMs. As described in the LangChain documentation, llms.txt is "an index file containing links with brief descriptions of the content"[1]. It acts as a structured gateway to a project's documentation.

  2. MCP (Model Context Protocol): A protocol enabling communication between AI agents and external tools, allowing LLMs to discover and use various capabilities. As stated by Anthropic, MCP is "an open protocol that standardizes how applications provide context to LLMs"[2].

@donbr
donbr / ali-arsanjani-a2a-mcp-ot-research.md
Created April 17, 2025 19:00
ali-arsanjani-a2a-mcp-ot-research

Ali Arsanjani's Work on A2A, MCP, and OpenTelemetry Integration

Introduction

This research document examines Dr. Ali Arsanjani's contributions to Agent-to-Agent (A2A) Protocol, Model Context Protocol (MCP), and potential connections to OpenTelemetry for AI agent observability. Dr. Arsanjani is the Director of AI/ML Partner Engineering at Google Cloud and has been identified as an author of the A2A protocol.

A2A Protocol Contributions

Dr. Ali Arsanjani has written extensively about the Agent-to-Agent (A2A) protocol, an open standard developed by Google to enable communication between AI agents across different frameworks and vendors. As mentioned in his April 2025 article, he identifies himself as "an author of this protocol" [1].

@donbr
donbr / a2a-opentelemetry-research.md
Created April 17, 2025 18:00
a2a-opentelemetry-research

Google's A2A Protocol and OpenTelemetry Alignment

A2A Protocol Overview

Google's Agent2Agent (A2A) Protocol is an open protocol designed to enable communication and interoperability between AI agents across different ecosystems, frameworks, and vendors. Announced in April 2025, A2A provides a standardized way for agents to collaborate regardless of their underlying technologies[1].

Key Features of A2A

  • Capability Discovery: Agents publish their capabilities through "Agent Cards" in JSON format, allowing client agents to identify and connect with suitable remote agents[2]
  • Interoperability: Enables AI agents to work across different frameworks and vendors[1]
@donbr
donbr / ai-engineering-bootcamp-guide.md
Created April 15, 2025 23:26
ai-engineering-bootcamp-guide

AI Engineering Bootcamp: Comprehensive Concept Walkthrough

Introduction

Welcome to the AI Engineering Bootcamp! This 10-week intensive program is designed to transform you from a programmer into a certified AI Engineer capable of building production-ready AI applications. The curriculum follows a logical progression through two main phases:

  1. Build Phase (Weeks 1-7): Focus on prototyping, concepts, and development
  2. Ship Phase (Weeks 8-10): Focus on production deployment and optimization

The bootcamp culminates in a Demo Day where you'll showcase your Certification Challenge project to peers and potentially industry professionals.

@donbr
donbr / langgraph-fraud-detection-report.md
Created April 12, 2025 19:10
langgraph fraud detection report

LangGraph for Fraud Detection: Multi-Agent Approaches and Case Studies

1. Introduction to LangGraph

What is LangGraph?

LangGraph is a module built on top of LangChain to better enable creation of cyclical graphs, often needed for agent runtimes. It's designed to enable the creation of complex agent workflows, supporting diverse control flows including single agent, multi-agent, hierarchical, and sequential patterns.

LangGraph — used by Replit, Uber, LinkedIn, GitLab and more — is a low-level orchestration framework for building controllable agents. LangGraph provides customizable architectures, long-term memory, and human-in-the-loop capabilities to reliably handle complex tasks.

@donbr
donbr / ai-alignment-agentic-hackathons.md
Created April 9, 2025 07:47
AI Alignment and Agentic Hackathons: April-June 2025

AI Alignment and Agentic Hackathons: April-June 2025

Introduction

The first half of 2025 features several significant hackathons and research programs focused on artificial intelligence, with particular emphasis on AI alignment and agentic systems. This document catalogs the major events scheduled between April and June 2025, providing key details for researchers, developers, and enthusiasts interested in contributing to the advancement of safe and beneficial AI.

April 2025

Microsoft AI Agents Hackathon 2025

Dates: April 8-30, 2025