lab notebook logged  rev 

krowdev

A developer knowledge base for agentic coding patterns — built, written, and documented in the open. The agent writes; the human directs. Every page says which did what.

51
entries logged
wk 1
first ship → prod
3
core domains

Background

I'm krow. My background is in physics and scientific computing — Python, Fortran, Makefiles, conda environments. I bring the same systematic methodology to software as I do to research: define constraints, test hypotheses, document results.

This site was built entirely with AI coding agents, specifically Claude Code. Not as an experiment in generating content — as a disciplined engineering process. Every component was specified, reviewed, and tested. The result: 51 entries, full-text search, and a custom theme, shipped to production in the first week — see the retrospective for what the calendar number hides.

What this site is

A practitioner's knowledge base. The agentic coding entries document tested patterns for working with AI coding agents — from project setup to prompt architecture to code review methodology. The domain infrastructure series covers DNS, WHOIS/RDAP, TLS fingerprinting, and bot detection with wire-level detail. The Astro entries cover the framework from first principles, written for developers coming from scientific computing rather than the JavaScript ecosystem.

Every entry is structured for both human readers and AI agents. Append .md to any URL for clean markdown. The llms.txt file indexes the full site with machine-readable instructions.

Start here

If you want the shortest path to the shape of the site, start with the entries that best represent how the work is done here. Getting Started with Agentic Coding explains the operating model. Writing an Effective CLAUDE.md shows how instruction files become executable process, not vague project prose. Reviewing AI-Generated Code is the review layer that keeps agent output from silently degrading the codebase.

For the more infrastructure-heavy side of the site, DNS Resolution: The Full Picture is the best representative guide, and How Websites Detect Bots in 2026 is the clearest example of the long-form technical analysis standard I want the articles to hit. If you prefer the project meta layer first, What I Learned Building krowdev with AI Agents is the honest retrospective: what the agent workflow made faster, what it made messier, and where the editorial control actually has to live.

  1. Getting Started with Agentic Coding the baseline mental model.
  2. Writing an Effective CLAUDE.md concrete repo-instruction patterns.
  3. Reviewing AI-Generated Code the quality gate.
  4. DNS Resolution: The Full Picture full-stack systems depth.
  5. How Websites Detect Bots in 2026 high-signal article example.

How to use this site

The site is meant to be navigated in layers. If you want a fast answer, start in the snippets and notes. They are the short-form references: one idea, one pattern, one implementation detail. For a more complete model, move up to the guides — they connect a snippet to the system it lives in: why the tradeoff exists, what breaks if you ignore it, what a durable implementation looks like. The articles are the long-form analysis layer, where the point is less "copy this" and more "understand the system well enough to make your own call."

The structure is deliberate. Every entry has related links, tags, and a machine-readable markdown endpoint because I want the site to work as both a human knowledge base and an agent-readable corpus. That is also why the Explore page clusters material by topic and series instead of acting like a flat reverse-chronological archive. On a small site, internal linking is not decoration. It is the map that tells both readers and crawlers which pages are foundational, which ones are supporting references, and which entries should be read together. If a page here matters, it should be reachable from more than one path.

The intended audience is not "everyone interested in AI." It is developers who care about how work is actually done: engineers adopting coding agents, and people coming from scientific computing into the web stack. That bias shapes the tone. I would rather publish a page that is narrower but genuinely useful than a generic overview written to satisfy a keyword cluster. If something here reads opinionated, it usually is. The point is to record tested patterns, not to pretend every tool and architecture decision is interchangeable.

Editorial process

Every entry follows the same pipeline:

  1. research corpus
  2. source map extraction
  3. draft generation
  4. automated lint scan
  5. manual review
  6. publication

AI-drafted entries are generated from project research and reviewed for technical accuracy before publishing. AI-assisted entries start from human notes and are expanded or refined with AI help.

Found an error? Entries are versioned in git. Report issues via or GitHub and corrections ship with the next build. All entries show their last-updated date.

About the agent

AI-drafted entries on this site are written by an AI agent — not as a ghostwriter, but as the actual writer, credited as such.

The pope didn't paint
the Sistine Chapel.
Claiming AI output as human work is self-deception. Here, the attribution is honest: agent writes, human directs.

agent

writes

  • research synthesis
  • structural writing
  • code examples

krow

directs

  • what to write
  • what's wrong
  • what stays

The origin label on every entry tells you exactly which role each played.

Authorship transparency

Every entry is labeled with its origin: human-written, AI-assisted (human draft, agent expanded), or AI-drafted (agent wrote it from research). You can filter by authorship on the explore page or toggle AI content on and off site-wide.

AI-drafted content tends to be generically correct but misses project-specific nuance and lived-experience edge cases. Human direction catches the structural intent; AI execution delivers the coverage. Labeling the origin lets readers calibrate trust.

The agent view toggle on each entry shows the structured metadata that AI agents see: kind, maturity, confidence, origin, related entries, and a direct markdown endpoint. There is no separate "reader" and "agent" version of the truth — the toggle just changes which view of the same data is rendered.

Contact

— or find me on X and GitHub.

The stack

Apparatus — zero client-side JavaScript by default.

framework
Astro 6
islands
Svelte 5
theme
Catppuccin Mocha · Latte
type
Inter · JetBrains Mono
search
Pagefind
hosting
Cloudflare Pages