<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>The Specification Problem — WkndPrjct</title><link>https://wkndprjct.id/series/the-specification-problem/</link><description>Technology, history, systems, and human behavior share the same underlying patterns. WkndPrjct finds the connections.</description><language>en-us</language><lastBuildDate>Mon, 06 Jul 2026 12:05:13 +0000</lastBuildDate><atom:link href="https://wkndprjct.id/series/the-specification-problem/index.xml" rel="self" type="application/rss+xml"/><item><title>The Specification That Became the Product</title><link>https://wkndprjct.id/articles/the-specification-that-became-the-product/</link><guid>https://wkndprjct.id/articles/the-specification-that-became-the-product/</guid><pubDate>Sat, 06 Jun 2026 00:00:00 +0000</pubDate><category>Technology</category><category>History</category><category>Organizations</category><description>The Specification That Became the Product In 1490, a Portuguese cartographer named Pedro Reinel drew a map of the African coastline that would influence navigators for the next fifty years. The map was based on Bartolomeu Dias&amp;amp;rsquo;s expedition of 1488 — the first European voyage around the Cape of Good Hope. Reinel drew what Dias had seen.</description><content:encoded><![CDATA[<h1 id="the-specification-that-became-the-product">The Specification That Became the Product</h1>
<p>In 1490, a Portuguese cartographer named Pedro Reinel drew a map of the African coastline that would influence navigators for the next fifty years. The map was based on Bartolomeu Dias&rsquo;s expedition of 1488 — the first European voyage around the Cape of Good Hope. Reinel drew what Dias had seen.</p>
<p>Within a decade, the map was updated, annotated, and distributed to ships throughout the Portuguese fleet. By 1510, captains were navigating by Reinel&rsquo;s map rather than by their own observations. If their instruments said the cape was to the east and the map said it was to the south, captains adjusted their instruments. The map had become more authoritative than the sea.</p>
<p>This is not a story about cartography. It is a story about what happens when the document describing a thing becomes more trusted than the thing itself.</p>
<p>In the 1990s, management consulting firms discovered the same dynamic. McKinsey consultants developed a reputation for producing slides of extraordinary quality — impeccably structured, beautifully designed, logically airtight. Clients paid millions for them. A persistent observation in the industry: the slides were so convincing that clients sometimes implemented the slide rather than the strategy. The 2×2 matrix became the reorganization plan. The pyramid framework became the operating model. The visual clarity of the artifact substituted for the messy reality of implementation.</p>
<p>The slide had become more authoritative than the situation it described.</p>
<h2 id="the-story">The Story</h2>
<p>A team is using an AI assistant to help them develop a go-to-market strategy for a new product. They describe the product and market. The AI produces a structured analysis: target segments, competitive positioning, channel recommendations, pricing considerations, key risks.</p>
<p>The analysis is impressive. It is logically organized, well-reasoned, clearly written. The team presents it to leadership. Leadership approves the strategy.</p>
<p>Three months later, the product has launched and early results are disappointing. In a review, someone asks: how did we develop the pricing recommendation? The team references the original analysis. Someone asks where the data behind the pricing model came from. The team checks the analysis. The AI had produced a reasonable-sounding pricing framework based on general market logic — but the specific price points had been suggested without reference to actual customer research, competitor pricing data, or the team&rsquo;s own cost structure.</p>
<p>The analysis looked like a strategy document. It read like a strategy document. It was not a strategy document — it was a well-formatted hypothesis that had been treated as a conclusion.</p>
<p>The team had evaluated the quality of the artifact. Nobody had evaluated the quality of the thinking behind the artifact.</p>
<h2 id="three-ways-this-appears">Three Ways This Appears</h2>
<p><strong>In everyday life:</strong> A student submits a perfectly formatted essay with a clear thesis, well-organized paragraphs, and a strong conclusion. The teacher, pressed for time, evaluates the format and gives high marks. The thesis is wrong. The conclusion does not follow from the argument. The format signaled quality that was not there.</p>
<p><strong>In technology:</strong> An engineering design document is polished, comprehensive, and well-structured. It covers all the standard sections: requirements, architecture, alternatives considered, risks. The &ldquo;alternatives considered&rdquo; section lists three alternatives and dismisses each in one sentence. The dismissals are not wrong — but they are not evidence that the alternatives were seriously analyzed. The document format made shallow consideration look thorough.</p>
<p><strong>In organizations:</strong> A project status report is consistently high-quality: clear, organized, on time, well-designed. Senior leadership reads it and feels informed. The reports accurately describe what happened. They consistently omit analysis of why things happened, what the implications are, and what different choices might have produced. The quality of the artifact has become the standard, substituting for the quality of the thinking the artifact was supposed to represent.</p>
<h2 id="the-pattern">The Pattern</h2>
<p>The quality of an artifact is not the same as the quality of the thinking it represents. This has always been true, but it has become a critical distinction in an environment where artifact quality can be high regardless of thinking quality — where the form and the substance can decouple completely.</p>
<p>The artifact is the visible product of work. The thinking is the invisible work the artifact is supposed to capture. When artifact quality is hard to achieve, it is a reliable proxy for thinking quality — producing a polished artifact requires the effort that tends to produce clear thinking. When artifact quality becomes cheap, the proxy breaks.</p>
<p>A beautiful slide, a well-formatted document, a coherent analysis can now be produced quickly, at low cost, at high visual quality. This is genuinely useful for legitimate work. It is also a change in the reliability of artifact quality as a signal of thinking quality. The two have decoupled.</p>
<p>The evaluation problem is real: assessing the quality of intellectual work is harder and slower than assessing the quality of its artifacts. Artifact evaluation is what we default to when time is limited and understanding is incomplete. The default was always imperfect. The gap between artifact quality and thinking quality has grown.</p>
<h2 id="the-cross-domain-connection-the-map-and-the-territory">The Cross-Domain Connection: The Map and the Territory</h2>
<p>Alfred Korzybski coined the phrase &ldquo;the map is not the territory&rdquo; in 1931 to describe the relationship between representations and reality. Maps are useful precisely because they simplify — they select the features of a territory that are relevant for navigation and ignore everything else. The simplification is the point.</p>
<p>The error is treating the map as if it were the territory — as if the simplification were complete and the selected features were all the features. Every map has an unstated contract with the reader: &ldquo;I am a representation of the territory, useful for these purposes, inaccurate or silent about these other things.&rdquo;</p>
<p>A strategy document, a design spec, an analytical report — each is a map. Each has the same unstated contract. The reader who treats the map as the territory has accepted the map&rsquo;s premises without evaluating whether those premises are reliable.</p>
<p>The specific version of this error that AI tools make possible: the map can now be produced at scale, at speed, with high surface quality, without the underlying territory having been fully explored. The map looks complete. The exploration may not have been.</p>
<h2 id="the-framework-artifact-quality-vs-thinking-quality">The Framework: Artifact Quality vs. Thinking Quality</h2>
<div class="mermaid">graph TD
    A[Artifact Produced] --&gt; B{Evaluate artifact quality?}
    B --&gt;|Only artifact| C[Mistaking representation&lt;br/&gt;for thing represented]
    B --&gt;|Artifact &#43; thinking| D[Full evaluation]

    C --&gt; E[High artifact quality&lt;br/&gt;Low thinking quality&lt;br/&gt;Undetected]
    D --&gt; F{How to evaluate thinking?}
    F --&gt; G[Test assumptions against evidence]
    F --&gt; H[Stress-test conclusions]
    F --&gt; I[Identify what was not analyzed]
    G --&gt; J[Thinking quality visible]
    H --&gt; J
    I --&gt; J
    J --&gt; K[Artifact is reliable representation&lt;br/&gt;of sound thinking]
    E --&gt; L[Decisions made on&lt;br/&gt;impressive-looking basis]</div>
<h2 id="why-this-matters-outside-technology">Why This Matters Outside Technology</h2>
<p>Every professional domain faces the artifact-thinking gap. Legal briefs, medical reports, financial analyses, academic papers — all are artifacts whose quality can be evaluated on surface dimensions (clarity, organization, completeness of format) that may or may not reflect the quality of the underlying thinking.</p>
<p>The professionals who produce the best work are those who have not confused making good artifacts with doing good thinking. The artifact is the deliverable. The thinking is the work. They require different skills, different habits, and different standards of evaluation.</p>
<p>The discipline is to evaluate both — and to be explicit about which is being evaluated. &ldquo;This is well-written&rdquo; is an evaluation of the artifact. &ldquo;The pricing assumption here is not supported&rdquo; is an evaluation of the thinking. Both evaluations are necessary. Only one is sufficient.</p>
<h2 id="the-memorable-sentence">The Memorable Sentence</h2>
<blockquote>
<p>A well-formatted document that contains bad thinking is not a good strategy — it is a good-looking record of a bad one.</p></blockquote>
<h2 id="closing-question">Closing Question</h2>
<blockquote>
<p>For the most consequential AI-assisted analysis your organization has produced this year — can you describe, specifically, how the quality of the thinking behind it was evaluated, separate from the quality of how it was expressed?</p></blockquote>
]]></content:encoded></item></channel></rss>