{
  "@context":[
    "https://www.w3.org/ns/activitystreams",
    {"Hashtag":"as:Hashtag"}
  ],
  "published":"2025-07-24T17:41:45.086Z",
  "attributedTo":"https://k.matthias.org/actors/relistan",
  "to":["https://www.w3.org/ns/activitystreams#Public"],
  "cc":["https://k.matthias.org/actors/relistan/followers"],
  "content":"<p>I got two AI agents, Claude and Gemini, to help generate a doc for new developers on how to work with one of our services. In the end, I am quite pleased with what it did.</p><p>Example:<br><code># Developer's Guide to the User-Profile Service<br><br>Welcome! This document is the comprehensive guide for developers working on the<br>User-Profile service. It outlines our architecture, established patterns, and<br>development workflow. Adhering to these conventions is key to maintaining a<br>clean, consistent, and scalable codebase.<br><br>## Table of Contents<br><br>1.&nbsp; [**Getting Started: Your First 5 Minutes**](<a href=\"https://k.matthias.org/tags/getting-started-your-first-5-minutes\" class=\"hashtag\" rel=\"tag\">#getting-started-your-first-5-minutes</a>)<br>2.&nbsp; [**Core Architectural Principles**](<a href=\"https://k.matthias.org/tags/core-architectural-principles\" class=\"hashtag\" rel=\"tag\">#core-architectural-principles</a>)<br>3.&nbsp; [**Codebase Tour**](<a href=\"https://k.matthias.org/tags/codebase-tour\" class=\"hashtag\" rel=\"tag\">#codebase-tour</a>)<br>4.&nbsp; [**Quick Decision Guides**](<a href=\"https://k.matthias.org/tags/quick-decision-guides\" class=\"hashtag\" rel=\"tag\">#quick-decision-guides</a>)<br>5.&nbsp; [**The Golden Path: Adding a New Feature**](<a href=\"https://k.matthias.org/tags/the-golden-path-adding-a-new-feature\" class=\"hashtag\" rel=\"tag\">#the-golden-path-adding-a-new-feature</a>)<br>6.&nbsp; [**Deep Dive: Key Patterns &amp; Conventions**](<a href=\"https://k.matthias.org/tags/deep-dive-key-patterns--conventions\" class=\"hashtag\" rel=\"tag\">#deep-dive-key-patterns--conventions</a>)<br>&nbsp; &nbsp; - [The Data Layer (`stores/`)](<a href=\"https://k.matthias.org/tags/the-data-layer-stores\" class=\"hashtag\" rel=\"tag\">#the-data-layer-stores</a>)<br>&nbsp; &nbsp; - [Event Handling (`event_consumer/`)](<a href=\"https://k.matthias.org/tags/event-handling-event_consumer\" class=\"hashtag\" rel=\"tag\">#event-handling-event_consumer</a>)<br>&nbsp; &nbsp; - [Command Handling (`command_consumer/`)](<a href=\"https://k.matthias.org/tags/command-handling-command_consumer\" class=\"hashtag\" rel=\"tag\">#command-handling-command_consumer</a>)<br>&nbsp; &nbsp; - [The API Layer (`webapi/`)](<a href=\"https://k.matthias.org/tags/the-api-layer-webapi\" class=\"hashtag\" rel=\"tag\">#the-api-layer-webapi</a>)<br>&nbsp; &nbsp; - [Error Handling Patterns](<a href=\"https://k.matthias.org/tags/error-handling-patterns\" class=\"hashtag\" rel=\"tag\">#error-handling-patterns</a>)<br>&nbsp; &nbsp; - [Testing (`*_test.go`)](<a href=\"https://k.matthias.org/tags/testing-_testgo\" class=\"hashtag\" rel=\"tag\">#testing-_testgo</a>)<br>&nbsp; &nbsp; - [Long-Running Tasks (`temporal/`)](<a href=\"https://k.matthias.org/tags/long-running-tasks-temporal\" class=\"hashtag\" rel=\"tag\">#long-running-tasks-temporal</a>)<br>&nbsp; &nbsp; - [Observability Best Practices](<a href=\"https://k.matthias.org/tags/observability-best-practices\" class=\"hashtag\" rel=\"tag\">#observability-best-practices</a>)<br>&nbsp; &nbsp; - [Configuration Management](<a href=\"https://k.matthias.org/tags/configuration-management\" class=\"hashtag\" rel=\"tag\">#configuration-management</a>)<br>&nbsp; &nbsp; - [Performance Considerations](<a href=\"https://k.matthias.org/tags/performance-considerations\" class=\"hashtag\" rel=\"tag\">#performance-considerations</a>)<br>&nbsp; &nbsp; - [Cross-Cutting Concerns](<a href=\"https://k.matthias.org/tags/cross-cutting-concerns\" class=\"hashtag\" rel=\"tag\">#cross-cutting-concerns</a>)<br>7.&nbsp; [**Development Cheatsheet**](<a href=\"https://k.matthias.org/tags/development-cheatsheet\" class=\"hashtag\" rel=\"tag\">#development-cheatsheet</a>)<br>8.&nbsp; [**Glossary of Terms**](<a href=\"https://k.matthias.org/tags/glossary-of-terms\" class=\"hashtag\" rel=\"tag\">#glossary-of-terms</a>)</code></p>",
  "mediaType":"text/html",
  "attachment":[],
  "tag":[
      {"type":"Hashtag","name":"#getting-started-your-first-5-minutes","href":"https://k.matthias.org/tags/getting-started-your-first-5-minutes"},
      {"type":"Hashtag","name":"#core-architectural-principles","href":"https://k.matthias.org/tags/core-architectural-principles"},
      {"type":"Hashtag","name":"#codebase-tour","href":"https://k.matthias.org/tags/codebase-tour"},
      {"type":"Hashtag","name":"#quick-decision-guides","href":"https://k.matthias.org/tags/quick-decision-guides"},
      {"type":"Hashtag","name":"#the-golden-path-adding-a-new-feature","href":"https://k.matthias.org/tags/the-golden-path-adding-a-new-feature"},
      {"type":"Hashtag","name":"#deep-dive-key-patterns--conventions","href":"https://k.matthias.org/tags/deep-dive-key-patterns--conventions"},
      {"type":"Hashtag","name":"#the-data-layer-stores","href":"https://k.matthias.org/tags/the-data-layer-stores"},
      {"type":"Hashtag","name":"#event-handling-event_consumer","href":"https://k.matthias.org/tags/event-handling-event_consumer"},
      {"type":"Hashtag","name":"#command-handling-command_consumer","href":"https://k.matthias.org/tags/command-handling-command_consumer"},
      {"type":"Hashtag","name":"#the-api-layer-webapi","href":"https://k.matthias.org/tags/the-api-layer-webapi"},
      {"type":"Hashtag","name":"#error-handling-patterns","href":"https://k.matthias.org/tags/error-handling-patterns"},
      {"type":"Hashtag","name":"#testing-_testgo","href":"https://k.matthias.org/tags/testing-_testgo"},
      {"type":"Hashtag","name":"#long-running-tasks-temporal","href":"https://k.matthias.org/tags/long-running-tasks-temporal"},
      {"type":"Hashtag","name":"#observability-best-practices","href":"https://k.matthias.org/tags/observability-best-practices"},
      {"type":"Hashtag","name":"#configuration-management","href":"https://k.matthias.org/tags/configuration-management"},
      {"type":"Hashtag","name":"#performance-considerations","href":"https://k.matthias.org/tags/performance-considerations"},
      {"type":"Hashtag","name":"#cross-cutting-concerns","href":"https://k.matthias.org/tags/cross-cutting-concerns"},
      {"type":"Hashtag","name":"#development-cheatsheet","href":"https://k.matthias.org/tags/development-cheatsheet"},
      {"type":"Hashtag","name":"#glossary-of-terms","href":"https://k.matthias.org/tags/glossary-of-terms"}
  ],
  "type":"Note",
  "id":"https://k.matthias.org/objects/1wcZMty1Vak"
}