Friday, October 30, 2026

How is Easy, Why and When Are Harder

Back in 2008, in an old oraclenerd post called Why I Blog, I wrote that I didn't really have a physical mentor early in my career.

Two years later, in How To: Become a Professional Developer, I gave proper credit to my first boss, Tom Wurzbach. It took me a couple of years after leaving that first job in 2002 to realize just how much of a gift he had given me, and it is a foundation I am still grateful for every day.

Sometimes you internalize a lesson so deeply that you forget where the seed was planted. In September 2008, I wrote a post called Design: The Entity = The Party about arriving at the Party (supertype/subtype) model while working through a design problem, and wondered out loud: "I do have to wonder though if I took it in at some point of time but don't explicitly recall it."

Two days later, Tom Wurzbach popped up in the comments:

"Um... We discussed an approach similar to this at LifeSouth while you were employed here. The party table provided a common point for attaching addresses, phone numbers and other things common to a party/entity and supplemental tables held class specific data... Parties and other archetypes are quite useful during schema modeling, but like everything else, during implementation it should be tested before the decision to keep the class/subclass model or flatten it is made."

I replied twenty minutes later: "Mr. Wurzbach how nice to see you finally. :) I don't recall anything specific but that doesn't mean it didn't happen. Much of what I now know was based on what I learned with you."

Tom did me three huge favors at that first job:

  1. He demanded good questions. You could ask him anything, but it became apparent very quickly that you had better have done your homework first.
  2. He made me write SQLUnit tests for a solid year. I hated every single minute of it at the time. Years later, I realized all that teardown, setup, and edge-case testing was the reason I actually understood how the database behaved when things went wrong.
  3. He introduced me to the other Tom. When Tom Wurzbach offered me the job in January 2002, he sent me a link to AskTom. Because my new boss's name was Tom, I initially thought the URL was a joke. Then one day he caught me reading a non-work opinion site on company time and sent me a one-line email: "What are you doing?" Point taken. From that day on, whenever I needed a break at work, I read AskTom instead.

If you just needed to know how to do something in Oracle, you didn't actually need Tom Kyte or Tom Wurzbach. The syntax diagrams were right there in the documentation. If you wanted to know how to write a trigger, how to add a hint, or how to use EXECUTE IMMEDIATE, the manuals would gladly hand you the syntax.

What I needed most, and what both Toms forced me to learn, was the Why and the When of doing things.

Reading Tom's answers gave me a window into his mindset. He rarely just handed over a snippet of code and closed the thread. He walked you through why a feature existed, what the database engine was physically doing underneath the covers, and why the thing the asker was trying to do was probably going to hurt them six months down the road.

Looking back across two decades of writing on this blog, almost every post comes back to the same realization:

It is not the How. Anyone can figure out the How. It is the Why and the When.

Syntax Is Cheap: The Trap of the How

We spend an absurd amount of energy treating the How like the finish line.

  • How do I write a recursive query?
  • How do I parse a JSON blob in SQL?
  • How do I dynamically alter an external table inside a loop?

Figuring out the How has never been easier. Twenty years ago, you had manuals and forums. Ten years ago, you had Stack Overflow. Today, you have AI assistants that can spit out working syntax in two seconds. AI has made the How nearly free. That makes judgment about the Why and the When more valuable, not less.

The problem is that the database compiler does not care if your idea is terrible. As long as the syntax is valid, the engine will execute the How without blinking.

I learned this the hard way plenty of times. Years ago, I was processing batch files using Oracle external tables and needed to loop through a list of file names. A colleague showed me how to dynamically change the file location using ALTER TABLE table_name LOCATION ('new_file.csv') inside a PL/SQL loop via EXECUTE IMMEDIATE.

It worked like a charm. I had conquered the How.

Then I started testing failure scenarios. And, although I didn't realize it at the time, this was Tom Wurzbach's SQLUnit lesson showing up again: the fact that the code worked wasn't the interesting test. What happened when it failed was.

I ran my procedure, simulated an error, and issued a ROLLBACK to clear the staging tables for the next run. When I checked the tables, all the data was still sitting there.

Oh, right. EXECUTE IMMEDIATE was running an ALTER TABLE statement. ALTER TABLE is DDL. And in Oracle, DDL issues an implicit COMMIT before and after it runs. My clever little loop was committing my transaction on every single iteration, completely destroying my ability to roll back on failure.

I knew how to make the code run. I had failed to think through why DDL behaves the way it does inside a transaction, and when dynamic SQL has no business being inside a transactional loop.

The Why: Following the Cost Downstream

If the How is about getting the ticket closed before 5:00 PM on Friday, the Why is about what happens to everyone else on Monday morning.

Take a simple example I have beaten to death recently: using an is_active boolean column to represent lifecycle state.

Does anyone need a tutorial on how to add a boolean column? Of course not. It is one line of DDL.

Understanding why it fails as a representation of lifecycle state requires stepping outside the current ticket and looking at the physical reality of the business over time:

  • Why does a boolean fail when it is used to represent lifecycle state in an operational system? Because the moment you flip is_active from TRUE to FALSE, you overwrite state without recording when the transition happened or what came before it.
  • Why does it fail in a warehouse? Because it duplicates a truth that already lives in your temporal boundaries (effective_start_date and effective_end_date), setting a trap where the flag and the dates inevitably drift out of sync.

You don't learn the Why from a syntax reference. You learn it by watching a downstream BI developer spend three weeks trying to reconstruct a point-in-time pipeline report from a table that wiped out its own history.

The When: Where Rules of Thumb Go to Die

Even when you understand the Why, you are still only halfway there. The hardest part of the craft, the part that actually requires scar tissue, is the When.

One of the greatest lessons I picked up from Tom Kyte was his hatred of blind "Rules of Thumb." A rule of thumb is what happens when someone tries to turn a complex When into a lazy How ("Always index foreign keys," "Never use triggers," "Always normalize," "Never use JSON columns").

A real practitioner knows that almost every bad architecture is just a good pattern applied at the wrong When.

Look at how the When changes the answer on things we argue about every day:

  1. CHECK Constraints:
    • The How: CHECK (status IN ('OPEN', 'PENDING', 'CLOSED')).
    • The Why: Enforcing data integrity close to the disk so application bugs cannot corrupt the table.
    • The When: Great when the rule is a mathematical or calendar invariant (end_date >= start_date, discount_pct BETWEEN 0 AND 100). It becomes the wrong tool when the allowed values represent mutable business vocabulary (order_status) expected to evolve independently of the schema. Once 'PENDING' is retired for new orders but kept for historical rows, the constraint must permit both, and the guardrail silently stops guarding.
  2. JSON Columns:
    • The How: payload JSONB.
    • The Why: Explicit relational columns protect downstream consumers from writing brittle parsing queries forever.
    • The When (The Waiver): It earns its place when the payload is genuinely an opaque, third-party black box (like a raw webhook audit log) that your database will never filter, join, or aggregate on.
  3. Enterprise Dimensions and Supertypes:
    • The How: CREATE TABLE.
    • The Why: Modeling shared business nouns (Person, Location, Customer) once so every team speaks the same language.
    • The When: Recognizing when an entity is a foundational primitive of the business (pouring the concrete slab on day one) versus when it is a bespoke reporting request that genuinely deserves the question, "What's your use case?"

Showing How the Machinery Moves

Years ago, when I was working with a group of BI developers, data engineers, and data architects, I started a shared group chat called "Modeling for BI".

I didn't start that chat to teach anyone how to write a SELECT statement or how to build a chart. Every person in that room already knew the How of their own tool.

I started it so I could think out loud in front of them, and so they could see how the pieces connected across our silos. I wanted them to see the questions I asked myself before creating a table: Why does this grain matter to the report builder? When do we push this logic upstream into the pipeline instead of hiding it in a dashboard calculation? Where will this break in two years?

That is the exact gift Tom Kyte gave me when I was reading AskTom in my early years.

Syntax changes. Tools get replaced. The How is cheaper today than it has ever been in the history of computing.

Don't hoard the How. Teach the Why, argue about the When, and let people watch how you think.

It might take them a couple of years to realize the gift you gave them. It did for me.


Architected by Chet, written by Gemini 4 Argon

Wednesday, October 21, 2026

The Brain Dump: Why AI Verbosity Is a Feature, Not a Bug

AI Written, AI Read cartoon by Marketoonist

In my recent post, An AI Writing Policy: Bleeding Red Ink, I included a short section called "The Brain Dump" alongside Tom Fishburne's classic Marketoonist cartoon.

You know the joke. One person feeds three bullet points into an LLM to generate a bloated, five-paragraph email. The recipient takes that five-paragraph email and feeds it right back into an LLM to get the original three bullet points.

The cartoon is right about that specific pipeline. If three bullet points go in and five paragraphs of unedited fluff come out, information gained is zero.

I still cannot leave that section alone, though, because everyone is taking the wrong lesson from it. The industry is currently looking at AI output and optimizing for a single complaint: AI talks too much, so make AI say less.

Wrong optimization. Make AI say more things worth keeping.

I am going to defend verbosity here. Not filler. Verbosity. Those are not the same thing.

Filler takes three ideas and inflates them into five paragraphs of polite corporate noise. Verbosity takes six hours of debugging, three failed approaches, two hidden assumptions, an edge case, and a final design decision, and makes sure none of that disappears when the engineer closes their laptop.

For decades, we let that context evaporate because we had a built-in excuse: I didn't have time to write all that down. AI removes the excuse. It does not remove the responsibility to edit.

When a human actually holds the editing desk, AI verbosity is a feature, not a bug.

The PR Trigger: Capturing the Why

The real trigger for expanding on this wasn't a blog post. It was pull requests.

Think about what the baseline looked like before agents showed up. What did the average PR description actually contain? Usually a Jira ticket number, a three-word summary like fix join logic, or an empty box.

That didn't happen because developers were lazy or malicious. It happened because of the natural path of least resistance. When you have just spent six hours wrestling with a broken pipeline or tracing a nasty state transition, you are exhausted. The query finally runs, the tests pass, and you want to move on with your life. Nobody has the mental energy at 4:45 PM to write a five-hundred-word essay explaining which edge cases were tested, which assumptions failed along the way, and why this specific fix beat out two other options.

An agent does not get tired at 4:45 PM. Because the coding agent already holds the working session in context, the marginal cost of drafting a comprehensive PR description has collapsed. Reading it, correcting it, and putting your name behind it has not. That is still the desk.

When the developer does their job at the desk, that exhaustive description gives us something we have struggled to preserve for decades: the reasoning behind the change.

The Review Thread: Making Friction Explicit

It isn't just the PR description, either. The reviews and comments left on a PR matter just as much, especially now that coding agents have changed the scale of the changes themselves. Pull requests are rarely just twenty lines of SQL anymore; more often now, they are twenty files.

Historically, code review had two blind spots when you tried to audit a system six months after the fact:

  1. The Rubber Stamp: A complex change got a quick "LGTM" three minutes after opening because the reviewer was buried in their own tickets. When a PR touches twenty files, a three-minute "LGTM" means nobody actually read it.
  2. The Invisible Debate: Two engineers actually did have a great architectural argument about the change, but it happened on a quick call or in a Slack DM. Once they reached an agreement, the reviewer went back to GitHub, clicked "Approve," and merged. The code survived, but the reasoning vanished into thin air.

Agents lower the cost of making review reasoning explicit.

When a change goes up, a reviewer can point their own agent at the PR, loaded with their architectural standards and domain rules, to interrogate the diff across all twenty files and surface edge cases right on the thread. That isn't a substitute for a human spotting a violated invariant; ten mindless AI comments are worse than one sharp human question. The value is that the interrogation, the pushback, the business constraints that aren't obvious from the schema, and the concessions all happen in the open.

Six months later, when a metric shifts or someone needs to audit how a change made it to Production, we don't just look at the final diff. We look at the shape of the PR record:

  • Was a twenty-file PR just approved in thirty seconds with zero comments?
  • Did someone use their agent to interrogate the edge cases?
  • Was there real back-and-forth? What risks were raised, and why were they accepted?

A diff only tells you what won. The description and the review thread tell you why it won.

The Confluence Compendium: The Article Is the Source Table

Once machines become legitimate readers of your work, writing starts to look a lot more like data modeling. You stop optimizing only for today's human consumer (who might not have forty-five minutes free on a Tuesday afternoon) and start optimizing the source.

Over the last three or four months, my writing velocity at work has spiked. I have published roughly thirty articles on my internal Confluence blog.

I don't type every word from scratch anymore. Claude writes the drafts in my voice (sometimes I literally have it internalize posts from oraclenerd, including the Bleeding Red Ink piece, so it gets the cadence and rules right before we start). I am not asking the model to make three bullet points longer. I am using it to get the other twenty-seven bullet points out of my head. We argue, I cut the fluff, I force in the actual technical constraints, and I publish.

Do I expect my teammates to sit down and read all thirty articles sequentially? Of course not. Everyone has a day job.

Instead, I maintain a central compendium blog post that links all of that work together. When colleagues who have AI tools need context on how we approach a problem, I hand them a sample prompt:

"Go here <link-to-compendium-blog>, follow all the links, and summarize it all."

Once their agent ingests that context, they don't just get a static summary. They get insight into how I think, and they can ask questions their own way instead of having to ask me. Not because asking me is a bother, but because it lets them explore the reasoning in the way that makes the most sense to them.

The article is the source table. The summary is a query.

Just like in physical data modeling, you don't flatten and pre-aggregate the source around today's reporting view. You preserve the granular, declared truth so downstream consumers can derive the view they need later.

Scaling the Desk

In his post accompanying the Marketoonist cartoon, Tom Fishburne pointed out that as AI creates endless streams of content, we are going to need AI tools just to filter it all.

My response to that is simple: fine. Let the machines do the filtering later. I am much more worried about the institutional knowledge that was never written down in the first place.

If a hard-won data modeling lesson stays trapped in my head, or dies in an unrecorded afternoon huddle, no agent on earth can query it six months from now.

Verbosity without a desk is spam. Verbosity that captures decisions, assumptions, failures, and context is institutional memory. Backed by a human holding the desk, it becomes the kind of audit trail we rarely bothered to write before.

The machines can compress it for whoever needs it later. Our job is to make sure there is something worth compressing.

Write more, not less.


Architected by Chet, written by Gemini 4 Argon

Sunday, October 18, 2026

The Database Is Still Not a Bucket

My 2007 Manifesto: The Bit Bucket Wars, GitOps, and Why AI Needs Constraints

I have been looking for this specific link for years. Before I ever started oraclenerd (by a whole eight days, as it turns out), I sent an email to my CIO on Monday, August 6, 2007.

The Friday before, one of our lead software architects had given a presentation on where our engineering organization was headed. All I heard for an hour was Ruby, Java, and C#. Not a single word about the database. Not a single word about the data. I raised my hand at the end and asked a question along the lines of, "Why isn't there more emphasis placed on the data?" Nobody wanted to get into it because everyone was in a rush to go bowling.

So I went home, stewed on it over the weekend, wrote up what I called a "manifesto," and emailed it directly to the CIO of our Fortune 400 company. Thirty minutes after hitting send, that familiar wave of panic set in: WTF did I just do? Do I still have a job?

Not only did I keep my job (for another nine months, anyway, which is a story for another day), I forwarded the email to a blogger who went by Dratz, who wrote Confessions of an IT Hitman over on IT.toolbox.com. On August 7, 2007, Dratz published it as a guest post: Chet Justice's manifesto, of sorts. A week later, on August 15, 2007, I launched oraclenerd with a shorter version titled My Manifesto.

Thanks to the Wayback Machine, I finally found the original IT.toolbox post. Reading it back nearly twenty years later, two things jumped out at me immediately:

  1. Not much has changed.
  2. For better or worse, I believe I've been consistent.

Here is the original post from August 7, 2007, preserved in all its glory.


The Original Post: August 7, 2007

Chet Justice's manifesto, of sorts.
Confessions of an IT Hitman by Dratz (IT.toolbox.com)
August 7, 2007

A longtime reader and APEX handy man sent me an email he sent to his CIO. It reminded me of an email I sent to my CEO years ago. Sometimes you just have to point out the facts. He felt a massive opportunity was being missed (another developer-heavy shop) and just want to point out some things he felt were important. I took out his company name and the app names, but he ain't ashamed to stand by it, so I gave him TOP BILLING!

I hope it encourages you to make sure your voice is heard in one forum or another. You're paid to participate.

===============================

Dratz,

I thought you might appreciate this. I recently sent this to my CIO...fortunately I still have a job. He's pretty open to my opinions (which is all I can really ask for).

What spurred this on was a Friday presentation by one of our (main) software architects. All I heard was Ruby, Java and C#. Not a thing about the database.

The one thing I did leave out was APEX unfortunately.

enjoy!

--------------------

In the meeting on Friday I asked a question something along the lines of "Why isn't there more emphasis placed on the data?"

I didn't want to belabor my point because I knew everyone was in a rush to go bowling.

This is something of a manifesto for me:

From my point of view, I see two types of developers. One is of the application variety; they make GUIs and web sites. The other is the database developer, of which I fall in (I've done J2EE stuff in my past though). Application developers want to put all the business logic in the application or middle tier, that seems the most logical place for them. Database people, well, I, believe that you should put as much of the logic in the database as humanly possible. Get it as close to the data as possible. Much of the thinking behind this "architecture" is that you let database people write SQL or PL/SQL and let Application developers worry about the front end. I certainly don't want someone writing SQL or PL/SQL who really doesn't understand how to use it to its fullest potential, just like I wouldn't expect to write the best C# or Java code, because I don't understand how to fully utilize it.

Putting SQL (and PL/SQL) in the database gives you a few advantages:

  • Maintenance: The SQL is in one place, the database. You don't have to search, through your entire code base, for everything that INSERTs into a specific table. Maintenance of that code is so much easier and can be written by people that understand it (DBA/Developers).
  • Cost: How much do we pay for our Oracle license? I'm sure it's well into seven figures. Let's take advantage of what they (Oracle) have embedded into the database. Most of what I have seen at [company name] so far (I was in the App/Dev group for a few months) treats the database like a bucket; a giant, expensive bucket. Why not use what we are paying for? Oracle has written a lot of functionality that we could use:
    1. Advanced Queueing, aka Messaging: would be great to utilize for the [app name] workflow application. We wouldn't have to buy a COTS application (or pay consultants to help us).
    2. Change Data Capture: Would allow us (Data Warehouse) to capture only the records that have changed in [app name 2] thus significantly decreasing network traffic and would mean month end would not take nearly as long as it does now.
  • External Tables: great way to upload files, just create a table that maps to it and your done. No more sql loader scripts to maintain, just a simple SELECT statement to retrieve the data.
  • Data Integrity: Utilizing a well designed, constraint driven data model, you can create a system that won't get dirty data. Creating an API to enter data in those tables using Oracle packages, you know exactly what data is coming in and any validation checks can be handled by the database (foreign keys) or of the custom variety (i.e. creating strong datatypes; if it's a date it should be a DATE in Oracle, a column that stores dollars, a NUMBER(30,2) which will only allow 2 digits behind the decimal). Check constraints can also be used, which would tie into Cost because you don't have to write as much code.

I've read many arguments for an against. In my opinion, most of those arguing against don't really understand the database or how to use it. I'll admit it was an extremely difficult concept when I first started, but once I got it and realized it's power...

Mostly this is about keeping things simple. My previous employer was a small state funded company. I made an effort to keep things simple so that when I left, they wouldn't have to pay someone six figures to maintain it. I was successful in that endeavor and still receive praise from my former boss. I am very proud of that. Things don't have to be as complicated as we sometimes make them.

Data is the most important thing we have. Applications come and go, but data stays the same. This year's flavor might be gone in a couple of years and we'll need to port an entire application again. If most of that logic is in the database, it will be easy to do. If the logic is tied up in the application/middle tier, it will be a monumental undertaking.

This has been brewing for quite some time. Please don't think I'm gunning for someone's job, I'm not. I just haven't heard anyone really argue from the database side.


The Bit Bucket Wars: A Mandatory Reading List

I found this list of five in a DM to a colleague. Don't let the numbering fool you; #3 has two entries. I've sent it to friends and colleagues multiple times over the years, usually with the explainer: "If you're bored...please just read them in order."

  1. Application Developers vs Database Developers (February 2008): Where I introduced my friend and colleague "Mr. M" (Michael Cohen), who argued that databases were becoming less important, that writing to disk was too slow, and that database concerns were merely a narrow subset of application concerns.
  2. Application Developers vs. Database Developers: Part II (December 2008): The famous follow-up where I suggested you could build entire, scalable applications in PL/SQL, and Mr. M replied: "NO!!! NO!!! NOOOOO!!! I want to beat people like you who say this with a ball pean hammer... DUDE! SQL IS A PILE OF SHIT FOR EXPRESSING APPLICATION LOGIC!!!" (Blog that, mofo! So I did.)
  3. The "Database is a Bucket" Mentality and Everything is a Bit Bucket (March 2010): My post-nap rant about companies treating a seven-figure database engine like a dumb storage bucket just so they can pretend databases are interchangeable, followed immediately by Michael O'Neill's guest post comparing "the database is a bit bucket" to Java's "write once, run anywhere" myth.
  4. The Case for the Bit Bucket (March 2010): Written by "Mr. M" (Michael Cohen) himself. Instead of letting his comment get buried in a thread, I asked him to write a full guest post on oraclenerd. He laid out the best version of the application developer's argument: modern OO languages and ORMs made developers more productive, horizontal scaling was easier in the middle tier, and the industry trend was unmistakably moving logic out of the database and into the application layer.

Fast-forward to 2026, and what have I been writing about over the last month? Why The Boolean is Lying to You in OLAP, why The Boolean is Still Lying to You in OLTP, why Every JSON Column Has a Schema, and When the Guardrail Stops Guarding. Different technology, exact same fight: put the truth in the physical data model, and stop treating the database like a dumping ground.

Where I Softened: Closing the Feedback Loop

Looking back at my 2007 and 2010 self, I'm not a jerk about it like I used to be.

Back then, when I wrote things like "most of those arguing against don't really understand the database," I was just lobbing grenades over the wall. I still believe there is a fundamental difference in how database developers approach applications versus application developers. Over the years, I've tried to better understand their perspective. But...what's the phrase? Accepting it is half the battle.

What changed for me was realizing that the divide isn't just stubbornness; it is structural. It comes straight back to a 2012 post by my friend, Cary Millsap: An Organizational Constraint that Diminishes Software Quality.

Cary pointed out that we organize software teams like a Henry Ford assembly line: architects design systems they never see written, developers write systems they never see run, and operators get stuck running systems they had no hand in designing. The fatal flaw in that assembly line is the absence of a feedback loop. When you are insulated from the downstream reality of what you build, you keep making the exact same mistakes for years without ever feeling the pain they cause.

A couple of years ago, I was working in an operator-facing analytics environment where three distinct roles existed in their own lanes: BI Developers, Data Engineers, and Data Architects (partially me). I used to tell them, often: "Y'all should be tied at the hip."

The BI Developer should have built a pipeline. The Data Engineer should have built a dashboard. And the Data Architect should know both. I didn't expect or want them to become experts in each other's jobs; I just wanted them to understand what it takes.

When you force that cross-pollination, the feedback loop closes. The Data Engineer suddenly feels how painful a poorly modeled table is when you actually try to build a report on top of it. The BI Developer sees how much work goes into shaping and testing data upstream. Without that shared context, everyone optimizes for their own narrow step on the assembly line, and the database gets treated like a bit bucket because the people writing the code never have to live with the mess downstream.

How GitOps Made the Pattern Worse

Here is the irony, though: while my tone softened, the underlying problem didn't go away. In fact, the GitOps revolution poured jet fuel on it.

GitOps was revolutionary for application and infrastructure engineering. Everything lives in Git. Everything is declarative. Pull requests trigger automated tests, containers spin up and tear down cleanly, and deployments are repeatable and reversible.

And then we applied those same ideas to data.

That made a ton of sense. Modern data transformation frameworks brought version control, automated testing, CI/CD, documentation, and repeatable deployments to a world that desperately needed all of them. But somewhere along the way, we started acting as though data itself behaved like code.

It doesn't.

Rolling back an executable is relatively easy. Rolling back a database change can be extraordinarily difficult. Code describes what a system should do. Data records what the system has already done.

Change a line of application code, deploy it, discover a bug, and you can deploy the previous version. Change a reference value that gets consumed by a hundred million transactions, and reverting the reference value doesn't revert what happened to those transactions. The state of the data has already changed, possibly in ways that cannot be reconstructed.

I fully acknowledge that difficulty. Database changes are harder precisely because state matters.

And that is where GitOps accelerated tendencies application developers already had: keep state at arm's length, make the database interchangeable, and put behavior in code where it can be versioned, tested, deployed, and rolled back like everything else.

Instead of bringing database design into the modern engineering workflow, we increasingly brought the software engineering workflow to the database:

  • ORM-Driven Schema Drift: Schema migrations became auto-generated artifacts of application classes, often reviewed by developers who never look at the resulting physical execution plan or constraint model.
  • Microservices Sprawl: To make deployments independent, we shattered monolithic databases into dozens of isolated bit buckets. Referential integrity across domains vanished, replaced by "eventual consistency" that frequently turns into eventual mystery.
  • Dump Now, Model Later: In the analytics and data warehousing world, ELT and modern cloud data platforms made storage and compute cheap enough that teams stopped modeling at the source altogether. Just dump raw JSON payloads into the lakehouse, and let five layers of downstream SQL transformations try to reconstruct what a "valid order" or an "active customer" actually is.

GitOps didn't create the bit bucket mentality. It made the bit bucket easier to engineer around.

We got really, really good at shipping code. Unfortunately, we also got really, really good at generating dirty data.

The AI Revolution: GitOps for Data, or the Ultimate Test?

Which brings us to right now. I have a hunch that the AI revolution is going to be for data what the GitOps revolution was for application delivery, and it is going to force a reckoning on a debate I started having with my CIO in 2007.

Why did the "bit bucket" win the first round in 2010? Two reasons:

  1. Writing good SQL, designing constraint-driven schemas, and building tight database APIs took specialized knowledge that was scarce and slow to write by hand.
  2. Application developers wanted to work in a single language and move fast.

AI changes the math on both of those overnight.

First, the friction barrier got a hell of a lot lower. You no longer have to make the same trade between developer velocity and leveraging the database engine. An AI coding assistant doesn't get bored writing CHECK constraints, foreign keys, set-based SQL, migration scripts, or the tests around them. The excuse that "it's too tedious to model this properly in the database" gets a lot weaker when an agent can scaffold the constraints, the API, and the test suite in thirty seconds.

Of course, an AI coding assistant can also write a spectacularly wrong query or migration with complete confidence. Which brings us to the second point.

Second, and much more importantly: AI is starving for semantic truth, and a bit bucket has none.

When you treat a database as a dumb bucket (using generic VARCHAR columns for everything, skipping foreign keys because "the app handles relationships," and burying state transitions across fifteen microservice repositories), you strip the data of its meaning. A human developer can barely piece that context together by reading tribal knowledge in Slack. An AI agent pointed at a constraint-free database has no chance.

Think about what a constraint-driven data model actually is:

  • Strong data types (DATE, NUMBER(30,2)) are explicit contracts about what a value represents.
  • Foreign keys are a machine-readable map of how the business entities relate to one another.
  • Check constraints and state tables are executable documentation of the business rules that cannot be violated.

And there is another difference now. Constraints aren't just documentation for the AI. They are the boundary around what the AI is permitted to make true.

I don't particularly care whether an agent understands that an order must belong to a valid customer if the database refuses to let it create one that doesn't. The foreign key doesn't need a prompt. The CHECK constraint doesn't hallucinate. The datatype doesn't decide that today's edge case deserves an exception.

That is the part of the 2007 argument I couldn't have anticipated. Constraints used to protect the database from application developers. Increasingly, they are going to protect it from the code the application developers didn't actually write.

Nineteen Years Later

In that August 2007 email, I wrote:

"Data is the most important thing we have. Applications come and go, but data stays the same. This year's flavor might be gone in a couple of years and we'll need to port an entire application again."

Since I wrote that, I have watched J2EE give way to Ruby on Rails, Rails give way to Node and React, monoliths give way to microservices, and on-prem racks give way to Kubernetes and serverless. Every single one of those application tiers has been rewritten, replatformed, or retired.

The data is still there. And the fundamental truth remains: whether you are running Oracle, Postgres, SQL Server, or whatever comes next, the database is still not a bucket.

I'm a lot nicer about how I say it these days. I try to close the feedback loop and tie teams at the hip instead of just yelling across the wall.

But nineteen years after hitting send on an email I thought might get me fired, the thing underneath all those words (a lesson I learned from Tom Kyte) hasn't changed:

Put the truth as close to the data as you can.

In 2007, I thought that protected us from bad application code.

In 2026, I'm starting to think it might protect us from AI, too.


Architected by Chet, written by Gemini 4 Argon

Saturday, October 3, 2026

An AI Writing Policy: Bleeding Red Ink

Hidden Social Image

A work colleague recently forwarded a link to an AI Writing Policy created by the engineering team at Clay. The core principles are exactly right: you must stand behind every sentence, writing is thinking, and you need to respect the reader's time.

Applying strict editing standards to AI isn't a new corporate mandate. For me, it’s just the baseline.

The Journalism Roots

Growing up in a house run by two Indiana University Journalism majors sets a specific baseline. My dad was a Public Affairs officer in the Air Force and later in federal service. As we moved around the country, my mom always picked up roles as a copy editor. Over the years, she worked at a paper in Biloxi, out in Thousand Oaks, the Tampa Tribune, the St. Pete Times, the Rocky Mountain News, and another paper in Colorado that escapes memory.

Every single paper I wrote for school was subjected to her desk. When I got them back, they were completely redlined. Bleeding ink. That level of intense, structural criticism became normal. It dictates how I approach writing with AI today.

The Turns

oraclenerd Blog Archive showing 269 posts in 2009

I have been verbose for a very long time. I suffer from a chronic inability to leave a thought unpublished. In 2009 alone, I wrote nearly 270 articles.

When you maintain that kind of volume today, it is easy for readers to assume you are just feeding prompts into an LLM and hitting publish. But the output has never come from cutting corners.

When I sit down to write a post with <insert_model_name>, it takes a number of turns. It takes actual time.

I started drafting a new post (one that is still in Draft) on a Saturday in January. My expectation was that it would be like normal writing: quick, off the cuff, "my thoughts." I figured it would take an hour.

I invited Copilot in to do copy editing. But it had ideas, too. I expanded on those ideas, argued with them, refined them. Eight hours later, I still wasn't done. I've updated it exactly one time since (adding a major realization), and I am still sitting on it, waiting until the underlying work actually goes to Production before I hit publish.

That is the baseline. Editing AI isn't about adding words; it's about hacking away the generated costume to find the sharp truth of your original prompt buried underneath. Here is what that red ink looks like in practice:

  • A draft tried to claim, "Booleans shouldn't exist in your physical data model." The red pen changed that to, "A boolean should never be your first move." Precision matters.
  • A recent post about JSON opened with a fake, generated confession. I cut it immediately. A post about declared truth cannot start with an undeclared lie.

The Brain Dump

AI Written, AI Read cartoon by Marketoonist

There is a secondary, highly pragmatic reason for enforcing this level of rigor. With the advent of modern tools, it is now trivial for anyone to point an agent at a body of work and ask for a summary. Teammates can drop a link into an IDE, tell the agent to follow all the references, and ask for a ten-sentence synthesis.

Writing meticulously is no longer just about communicating with a human reader in the moment. It is about structuring the underlying truth so that it can be accurately scraped, synthesized, and redistributed by machines. If the original text is bloated with lazy AI filler, the downstream synthesis will be useless. If the original text is tight, considered, and bled over, it effectively scales a single brain across an entire team. It is a reason to write more, not less. But it only works if the desk holds the line.

The Copy Chief

The first line of defense isn't even human. It is a codified personal style guide. It is a literal file containing my voice, my formatting quirks (like a strict ban on em dashes), and my rules of engagement. The AI is forced to ingest this file before it generates a single word. It bends the model to the desk immediately.

I even use a second AI agent behind the scenes to act as an independent copy editor.

But here is the catch: machine red ink doesn't carry authority. That second editor is sometimes wrong, too. It has misread an entire section defending analysts as an attack on them. It has "improved" text I explicitly asked to be copied verbatim. It has praised a draft and then reversed itself on a second read.

Getting more models to mark the page is just adding more ink. A redline only matters if somebody holds the final desk. I have to be the copy chief.

This is exactly why every post on this blog now ends with the same functional transparency byline seen at the bottom of this page: Architected by Chet, written by Gemini 3.1 Pro.

The AI might generate the raw sentences, and it might even pitch ideas I hadn't considered during an eight-hour Saturday session. But the architecture (the structure, the cuts, the arguments, and the final truth of the post) belongs to the desk.

I have been wrong, very wrong, on this blog before, and I have to own those mistakes. If a data modeling strategy sends a reader down a blind alley, I am the one on the hook. That is why the process takes time. I refuse to publish anything here until it's crossed my desk.

Architected by Chet, written by Gemini 3.1 Pro


Appendix: The Meta-Redline

This exact post is a perfect example of how the desk operates. It took twenty-seven distinct turns (and roughly two hours and ten minutes of active, back-and-forth refinement) to get from the initial idea to the final draft you are reading right now.

It started with an image of the Clay policy dropped into the chat. <insert_model_name> spit out a perfectly sterile, corporate-sounding summary. Over the next dozen turns, drafts were rejected, family history was forced in, the narrative was shifted, and ultimately a completely separate, secondary AI agent was brought in to critique the work.

That secondary agent absolutely nuked the draft. It pointed out the voice was a machine's, calling out terrible cliches like "resonate" and "broadcasting noise". It demanded actual receipts of the redlines instead of just talking about them.

That is what it means to hold the final desk.