<rss version="2.0">
  <channel>
    <title>Writing on enumerator.dev</title>
    <link>https://enumerator.dev/t/writing/</link>
    <description></description>
    
    <language>en-CA</language>
    
    <lastBuildDate>Mon, 21 Sep 2026 00:00:00 +0000</lastBuildDate>
    
    <item>
      <title>How I use AI When Writing</title>
      <link>https://enumerator.dev/how-i-use-ai-when-writing/</link>
      <pubDate>Mon, 21 Sep 2026 00:00:00 +0000</pubDate>
      <guid>https://enumerator.dev/how-i-use-ai-when-writing/</guid>
      <description>&lt;p&gt;I use AI when I write for work.&lt;/p&gt;
&lt;p&gt;And like you, I hate slop.&lt;/p&gt;
&lt;p&gt;Despite LLMs writing like someone &lt;a href=&#34;https://martinfowler.com/articles/2026-dont-like-llms.html&#34;&gt;I would never want to spend time with&lt;/a&gt;, I still find some of their output useful.&lt;/p&gt;
&lt;p&gt;They speed up research, even if they are confidently wrong.&lt;/p&gt;
&lt;p&gt;And they are mediocre grammar checkers and good enough document structure editors, even if they are obtuse.&lt;/p&gt;
&lt;h2 id=&#34;my-writing-standards&#34;&gt;My Writing Standards&lt;/h2&gt;
&lt;h3 id=&#34;when-my-writing-is-personal&#34;&gt;When My Writing is Personal&lt;/h3&gt;
&lt;p&gt;I don&amp;rsquo;t write personal things with AI. This includes text messages, emails to friends and family, and Slack messages, comments on documents.&lt;/p&gt;
&lt;h3 id=&#34;when-i-write-for-this-blog&#34;&gt;When I Write for this Blog&lt;/h3&gt;
&lt;p&gt;Most of my writing on this blog is free form with limited edits. I hit publish and then find a mistake when I read it on my site and I&amp;rsquo;m quite okay with that.&lt;/p&gt;
&lt;p&gt;However, I use LLMs to assist with research and validation. Every now and then, I&amp;rsquo;ll do a double check on grammar and structure with a writing tool like LanguageTool or Grammarly, and I&amp;rsquo;ll occasionally accept phrasing that an LLM suggests if it suits my needs.&lt;/p&gt;
&lt;h3 id=&#34;when-my-writing-is-an-artifact-for-work&#34;&gt;When My Writing is An Artifact for Work&lt;/h3&gt;
&lt;p&gt;At work I write documentation and proposals that are artifacts the company can discuss and work with.&lt;/p&gt;
&lt;p&gt;I use today&amp;rsquo;s AI tools to research ideas, validate my assumptions, fact-check my work, and edit the document&amp;rsquo;s structure. More on this later.&lt;/p&gt;
&lt;h3 id=&#34;when-writing-generates-code&#34;&gt;When Writing Generates Code&lt;/h3&gt;
&lt;p&gt;I write to AI agents in the form of chat interfaces, documents, and structured prompts to generate code. I use all the tools available to me:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Type out my chat prompts by hand.&lt;/li&gt;
&lt;li&gt;Dictate through a voice-to-text model.&lt;/li&gt;
&lt;li&gt;Dictate through a voice-to-text model that is passed through an LLM to generate a structured output.&lt;/li&gt;
&lt;li&gt;Have an agent generate a document, then have a second agent read and validate that document.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Essentially, there are no rules when I write in order to generate code. I don&amp;rsquo;t even consider most of this &amp;ldquo;writing.&amp;rdquo; But it does result in generated text that has my name attached to it.&lt;/p&gt;
&lt;h2 id=&#34;how-i-use-ai-to-write-an-artifact&#34;&gt;How I use AI to Write an Artifact&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Use a number of agents to do research.&lt;/strong&gt; This often involves getting a coding agent to research and test ideas in a code repository, sending an agent with computer use off to do web research and produce a document, or chatting with an LLM to validate ideas.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Save agent-generated artifacts.&lt;/strong&gt; Between chat sessions, I get the agents to save artifacts other agents can find. Coding agents write docs, desktop agents find and read those docs and generate text files or docs through an MCP connector, and chat agents generate text I copy-paste elsewhere.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Write a doc in my own words.&lt;/strong&gt; After iterating with agents to build an understanding of what I&amp;rsquo;m writing, I start writing in my own words. The result is a document that is well-researched and thought-through. And very human. It has my tone, thought process, and mistakes.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Edit with an LLM.&lt;/strong&gt; I have two prompts that I use to edit both my work and docs the agent generates. For my own writing, I prefer to make the edits myself. Occasionally, I agree with the LLM&amp;rsquo;s feedback but am stumped on how to make a change, so I&amp;rsquo;ll ask for ideas.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;DON&amp;rsquo;T TRUST THE LLM.&lt;/strong&gt; I use my judgement when the LLM gives me feedback. Its generated response often has good points that slightly miss the mark. I take those into account and use my own words.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Use LLM-generated text when it helps.&lt;/strong&gt; It feels like I&amp;rsquo;ve admitted to a mortal sin here. I am writing for business, and LLMs are trained on business applications. I have no problem copy-pasting a sentence from an LLM at this point because I&amp;rsquo;ve done the legwork and the LLM is helping with polish.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;DON&amp;rsquo;T ARGUE WITH THE LLM&lt;/strong&gt;. It is going to generate text that makes no sense. Ignore this. When I have tried to correct things the LLM gets wrong, it begins to misunderstand the task overall. I often tell it what was good and then say something like &amp;ldquo;You can do better than this, I know you can. Give it a second, more thoughtful pass.&amp;rdquo; If is WEIRD to say things like that to a computer, but it works for me.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Share my work.&lt;/strong&gt; &lt;del&gt;I share a document with two sections. The first is my writing. The second is a summary of the LLM&amp;rsquo;s research, generated by the LLM. I flag this as AI-generated content in a BIG banner at the top.&lt;/del&gt; [EDIT: Oct 3, 2026] I no longer find value in the AI generated section. I share my writing with a notice at the top explaining the document was written by me with AI assisted research.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;ai-agent-prompts&#34;&gt;AI Agent Prompts&lt;/h2&gt;
&lt;h3 id=&#34;research-prompts&#34;&gt;Research Prompts&lt;/h3&gt;
&lt;p&gt;In my research prompts, I tell the agents my &lt;strong&gt;objectives, opinions, and assumptions.&lt;/strong&gt; This context helps the agent focus on the outcome I am asking for. It also forces me to think about my opinions and &lt;a href=&#34;https://enumerator.dev/assumptions/&#34;&gt;assumptions&lt;/a&gt;. I expect the agent to confirm my assumptions and push back on my opinions. If it doesn&amp;rsquo;t do this, I ask it to.&lt;/p&gt;
&lt;p&gt;Here is a template of a prompt I use:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-fallback&#34; data-lang=&#34;fallback&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;I am researching &amp;lt;feature&amp;gt;. I need you to research &amp;lt;technology&amp;gt; in this
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;repository and write a summary that explains the current state.
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;Focus on &amp;lt;area of code&amp;gt;.
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;Ignore &amp;lt;similar but irrelevant area of code&amp;gt;.
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;My objective is to &amp;lt;write your objective&amp;gt;.
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;My opinion is that &amp;lt;what I think the research will reveal and what decision
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;I lean towards already&amp;gt;.
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;My assumptions are &amp;lt;how the repo works, how the technology works with the
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;repo, etc.&amp;gt; 
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;prompts-for-editing&#34;&gt;Prompts for Editing&lt;/h3&gt;
&lt;p&gt;I have been working on a skill I call &amp;ldquo;&lt;a href=&#34;https://enumerator.dev/writing-for-understanding.txt&#34;&gt;Writing for Understanding&lt;/a&gt;&amp;rdquo; that is based on a number of accessible writing standards from government websites and based on my own experience. I pass all of the writing through this with the following prompt:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-fallback&#34; data-lang=&#34;fallback&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/writing-for-understanding read @doc and give me feedback one bullet
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;point at a time. Don&amp;#39;t edit the doc. I will make the edits myself.
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;I also use Anil Dash&amp;rsquo;s &lt;a href=&#34;https://www.anildash.com/2024/03/10/make-better-documents/&#34;&gt;Better Documents&lt;/a&gt; with a similar prompt. This is where I often get stuck! The LLM makes good recommendations based on Anil&amp;rsquo;s skill, but I sometimes don&amp;rsquo;t have an idea at my fingertips. In this case, I ask the LLM for ideas for restructuring the doc.&lt;/p&gt;
&lt;p&gt;I prefer to make these edits myself, even if it means copying some AI-generated text into my final output.&lt;/p&gt;
</description>
    </item>
    
    <item>
      <title>Everything was done with an ASCII editor</title>
      <link>https://enumerator.dev/everything-was-done-with-an-ascii-editor/</link>
      <pubDate>Mon, 31 Aug 2026 00:00:00 +0000</pubDate>
      <guid>https://enumerator.dev/everything-was-done-with-an-ascii-editor/</guid>
      <description>&lt;p&gt;The &lt;a href=&#34;https://gamefaqs.gamespot.com/snes/588741-super-metroid/faqs/10114&#34;&gt;Super Metroid – FAQ/Speed Guide&lt;/a&gt; is 17,000 words of perfectly-spaced, full justified, mono-spaced text. It&amp;rsquo;s beautiful to look at.&lt;/p&gt;
&lt;p&gt;From the FAQ&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;What program did you use to justify the text?&lt;/p&gt;
&lt;p&gt;None. I just chose words carefully so that everything lined up on the right hand side. Everything was done with an ASCII editor.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href=&#34;https://unsung.aresluna.org/i-just-chose-words-carefully/&#34;&gt;via Unsung&lt;/a&gt; &lt;a href=&#34;https://news.ycombinator.com/item?id=49503601&#34;&gt;via Hacker News&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;This reminds me of the hours I spent in a trance tracking, kerning, and editing text to create a triangular brochure that folded out into a tessellation with full-justified text that fit perfectly into each repeated triangle.&lt;/p&gt;
</description>
    </item>
    
    <item>
      <title>LLMs Don&#39;t Write, They Generate</title>
      <link>https://enumerator.dev/llms-dont-write-they-generate/</link>
      <pubDate>Tue, 18 Aug 2026 00:00:00 +0000</pubDate>
      <guid>https://enumerator.dev/llms-dont-write-they-generate/</guid>
      <description>&lt;p&gt;&lt;a href=&#34;https://daringfireball.net/2026/08/anthropics_watermark_text_adulteration_in_claude_is_a_perversion_of_writing&#34;&gt;Everyone&lt;/a&gt; is &lt;a href=&#34;https://medium.com/whither-news/words-matter-damnit-fc883733a729&#34;&gt;mad&lt;/a&gt; about AI &lt;a href=&#34;https://www.404media.co/anthropics-text-watermarking-proves-ai-companies-do-not-care-at-all-about-writing/&#34;&gt;watermarking&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;The thing is.&lt;/p&gt;
&lt;p&gt;These machines don&amp;rsquo;t write.&lt;/p&gt;
&lt;p&gt;&lt;a href=&#34;https://buttondown.com/maiht3k/archive/how-to-talk-about-ai-without-adding-to-the/&#34;&gt;They generate text.&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Writers write. Machines generate. LLMs can watermark text without affecting the quality of the output because they are benchmarked on the usefulness of their output rather than the meaning of the text.&lt;/p&gt;
&lt;p&gt;LLMs don&amp;rsquo;t reflect on meaning, consider their audience, and convey thoughts with care.&lt;/p&gt;
&lt;p&gt;LLMs generate a probable output to the input. That&amp;rsquo;s all.&lt;/p&gt;
&lt;p&gt;AI companies don&amp;rsquo;t value writing because they&amp;rsquo;ve never thought about writing. AI companies value the likelihood that the machine produces useful output. Not a &lt;em&gt;meaningful&lt;/em&gt; output.&lt;/p&gt;
&lt;p&gt;LLMs have gotten really good at generating probable outputs that are productive.&lt;/p&gt;
&lt;p&gt;But it&amp;rsquo;s still probable. And only mostly productive. But rarely meaningful.&lt;/p&gt;
&lt;p&gt;Saying that an LLM writes is as accurate as saying a lawn mower gardens, an airplane vacations, or a &lt;a href=&#34;https://www.colincornaby.me/2025/08/in-the-future-all-food-will-be-cooked-in-a-microwave-and-if-you-cant-deal-with-that-then-you-need-to-get-out-of-the-kitchen/&#34;&gt;microwave is a chef&lt;/a&gt;.&lt;sup id=&#34;fnref:1&#34;&gt;&lt;a href=&#34;#fn:1&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;
&lt;div class=&#34;footnotes&#34; role=&#34;doc-endnotes&#34;&gt;
&lt;hr&gt;
&lt;ol&gt;
&lt;li id=&#34;fn:1&#34;&gt;
&lt;p&gt;Ha! Oh dear. I wanted to write the word &amp;ldquo;cooks&amp;rdquo; here but I can&amp;rsquo;t. Is there another word for &amp;ldquo;cooks with great culinary skill&amp;rdquo; in English? Perhaps language is changing and LLMs do, in fact, &amp;ldquo;write&amp;rdquo; with the same skill that a microwave cooks.&amp;#160;&lt;a href=&#34;#fnref:1&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/div&gt;
</description>
    </item>
    
    <item>
      <title>Tenets of Storytelling: How to Write a Technical Proposal</title>
      <link>https://enumerator.dev/tenets-of-storytelling-how-to-write-a-technical-document/</link>
      <pubDate>Thu, 13 Aug 2026 00:00:00 +0000</pubDate>
      <guid>https://enumerator.dev/tenets-of-storytelling-how-to-write-a-technical-document/</guid>
      <description>&lt;p&gt;Sophie Alpert recently posted her internal policy on the &lt;a href=&#34;https://sophiebits.com/2026/06/25/there-are-no-lossless-transformations-of-natural-language-text&#34;&gt;acceptable use of AI for writing technical documents&lt;/a&gt;, which included this line:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;More time should be spent authoring a document than consuming it.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Similarly, Over at &lt;a href=&#34;https://www.themarginalian.org&#34;&gt;The Marginalian&lt;/a&gt; Maria Popova has been posting about reading more and writing better.&lt;/p&gt;
&lt;p&gt;This week, she posted &lt;a href=&#34;https://www.themarginalian.org/2026/08/12/kurt-vonnegut-on-writing-stories/&#34;&gt;Kurt Vonnegut&amp;rsquo;s 8 Tenets of Storytelling&lt;/a&gt;, which includes a similar line:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Use the time of a total stranger in such a way that he or she will not feel the time was wasted.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Vonnegut&amp;rsquo;s tenets can teach us something about technical writing, especially these days when an LLM can generate a &lt;a href=&#34;https://enumerator.dev/smitten-with-whats-written/&#34;&gt;seemingly polished&lt;/a&gt; technical document in seconds.&lt;/p&gt;
&lt;p&gt;I&amp;rsquo;m sure Vonnegut would loath being a technical writer and despise being quoted for technical writing.&lt;/p&gt;
&lt;p&gt;Nonetheless, here are Vonnegut&amp;rsquo;s eight tenets rewritten by yours truly as tenets for writing technical proposals. Unsurprisingly, some of these tenets work, word-for-word.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Use your colleagues&amp;rsquo; time wisely. They will thank you for it.&lt;/li&gt;
&lt;li&gt;Give your audience at least one thing to be excited about.&lt;/li&gt;
&lt;li&gt;Every component should do something useful, even if only to write a log.&lt;/li&gt;
&lt;li&gt;Every sentence must do one of two things — reveal details or propose action.&lt;/li&gt;
&lt;li&gt;Start as close to the solution as possible.&lt;/li&gt;
&lt;li&gt;Be a Sadist. No matter how much you or your team love a feature, show its faults so you can make good decisions.&lt;/li&gt;
&lt;li&gt;Write to please just one person. If you solve every technical problem, your proposal will get pneumonia.&lt;/li&gt;
&lt;li&gt;Give your readers as much information as possible as soon as possible. To hell with suspense. Readers should have such complete understanding of what is going on, where and why, that they could finish the design themselves, should entropy degrade the last few bytes.&lt;/li&gt;
&lt;/ol&gt;
</description>
    </item>
    
    <item>
      <title>Why I Write When AI Already Knows the Answer</title>
      <link>https://enumerator.dev/why-i-write-when-ai-already-knows-the-answer/</link>
      <pubDate>Thu, 03 Jul 2025 11:47:00 +0000</pubDate>
      <guid>https://enumerator.dev/why-i-write-when-ai-already-knows-the-answer/</guid>
      <description>&lt;p&gt;I have always been a writer. I haven&amp;rsquo;t kept all my writing, but I&amp;rsquo;ve always enjoyed it. Many of my recent blog posts are topics that are easily answerable by AI. I&amp;rsquo;ve asked myself, why write these posts when an AI can already answer these questions?&lt;/p&gt;
&lt;h2 id=&#34;why-i-write&#34;&gt;Why I Write&lt;/h2&gt;
&lt;p&gt;I write to understand. To explore. And to see things from a new perspective. My writing isn&amp;rsquo;t about telling people how things work so much as it is about taking readers on a journey with me. In my post about &lt;a href=&#34;https://enumerator.dev/should-i-use-a-managed-postgres-instance&#34;&gt;choosing a managed Postgres instance&lt;/a&gt;, I could have answered the question in the title in one sentence: I decided on a managed Postgres instance because it is more reliable and has better data retention guarantees.&lt;/p&gt;
&lt;p&gt;But that would have been boring, and an AI could have told you that easily.&lt;/p&gt;
&lt;p&gt;Writing that post was, for me, about taking readers on a journey and helping myself understand the choices I made. I write to understand myself, to explore the choices I&amp;rsquo;ve made, and to learn if there are better ways of doing things.&lt;/p&gt;
&lt;p&gt;As I write, new ideas come to mind, and I ask myself new questions about the code and infrastructure choices I made. I research as I write to confirm my choices and verify my assumptions.&lt;/p&gt;
&lt;h2 id=&#34;ai-already-knows-the-answer&#34;&gt;AI Already Knows the Answer&lt;/h2&gt;
&lt;p&gt;I use AI tools for all my development workflows. I type paragraphs more than I write code these days, and I spend more time reading code than I do writing it. AI tools have brought back the joy of making things because I can iterate, make mistakes, and recover quickly. I even watch AI agents make mistakes for the sole purpose of learning about those mistakes and the rabbit holes they lead to.&lt;/p&gt;
&lt;p&gt;AI agents can provide great answers and excellent guidance. But they&amp;rsquo;re not always correct. And they rarely have the context of the whole application. Even in a small project like willow.camp, I had to coax the agent to look in the right places to understand what we were working on, and I had to remind the agent about the intended outcome.&lt;/p&gt;
&lt;p&gt;AI Already Knows the Answer, but it also knows 5 or 10 other somewhat correct answers that might apply to different situations.&lt;/p&gt;
&lt;p&gt;Had I asked an AI, &amp;ldquo;Should I use a managed instance?&amp;rdquo; it would probably say, &amp;ldquo;Yes,&amp;rdquo; with some caveats. The decision is still up to me because I know how I want willow.camp to work.&lt;/p&gt;
&lt;p&gt;I write because understanding the full context of the project is essential to making good technical decisions.&lt;/p&gt;
</description>
    </item>
    
  </channel>
</rss>