https://marcioflorindo.com/blog.html Writing on technical documentation, AI workflows, content architecture, and developer experience. en-us Tue, 19 May 2026 00:00:00 GMT https://marcioflorindo.com/post.html?slug=writing-is-the-output https://marcioflorindo.com/post.html?slug=writing-is-the-output Tue, 19 May 2026 00:00:00 GMT The label I've been using for five years — technical writer — is accurate and fundamentally misleading at the same time. Accurate, because I write. Misleading, because writing is the output, not the work. https://marcioflorindo.com/post.html?slug=ai-does-not-replace-tech-writers https://marcioflorindo.com/post.html?slug=ai-does-not-replace-tech-writers Sat, 28 Mar 2026 00:00:00 GMT There is a version of the AI narrative that tells you that AI writes content, therefore writers are obsolete. However this hasn't been my experience after a few months of building AI deeply into my daily workflow. AI has enabled me to do my job even better. Here's how. https://marcioflorindo.com/post.html?slug=separate-ai-knowledge-from-actions https://marcioflorindo.com/post.html?slug=separate-ai-knowledge-from-actions Sat, 07 Mar 2026 00:00:00 GMT As a technical writer, there are a lot of repetitive tasks I have to do manually that eat into my time. Over the past couple of months I've been building a system of AI-assisted workflows that handles the mechanical parts of my job — the parts that eat hours without requiring much creative judgment. And it's genuinely changed how I work. https://marcioflorindo.com/post.html?slug=blog-brain-system https://marcioflorindo.com/post.html?slug=blog-brain-system Sat, 07 Mar 2026 00:00:00 GMT A colleague of mine built a system he calls Project Brains. The AI reads the context file first and starts every conversation already knowing what it needs to know. His core insight is that AI assistants become dramatically more useful when they have structured context to work from, not just raw files. So I built a system that captures those decisions automatically for my workflow, and makes them available in every future session. https://marcioflorindo.com/post.html?slug=blog-discovery-system https://marcioflorindo.com/post.html?slug=blog-discovery-system Thu, 05 Mar 2026 00:00:00 GMT Over the past month or so I've built 22 slash commands that automate different parts of my documentation workflow with OpenCode. But at some point around command number 15, I noticed that I didn't know what commands I had. So I built an automated system that lets the AI discover commands for me and suggests the best one bases on intent. https://marcioflorindo.com/post.html?slug=automate-research https://marcioflorindo.com/post.html?slug=automate-research Wed, 25 Feb 2026 00:00:00 GMT The other day I closed a P1 ticket that asked me to review a 5-lesson internal training course and figure out what was missing from our developer docs. The scope was big: compare the training material against hundreds of existing pages, identify content gaps, draft new conceptual documentation, and create follow-up tickets for anything out of scope. Normally, this kind of work takes the better part of a week. Research alone — reading the training, cross-referencing existing docs, searching the wiki, identifying stakeholders — can easily take a few days at least before you write a single word. This was exactly why I've created a while back the `/research` command in [OpenCode](https://opencode.ai). Recently, I got to put it to the test for the first time with a big task, and the whole thing went from ticket to merged PR in about two working days. https://marcioflorindo.com/post.html?slug=ai-toolkit-rename-products https://marcioflorindo.com/post.html?slug=ai-toolkit-rename-products Fri, 20 Feb 2026 00:00:00 GMT A few months ago, I was asked to lead the documentation side of a large product renaming project. So I build a whole toolkit with the help of AI to automate and accelerate this project. https://marcioflorindo.com/post.html?slug=research-command-tickets https://marcioflorindo.com/post.html?slug=research-command-tickets Tue, 10 Feb 2026 00:00:00 GMT Tech writers spend a lot of time researching before they can start writing. Gathering context for a Jira ticket means jumping between several other tickets, existing documentation, internal wiki pages with PRDs or technical specs, among other sources. To help speed up the process of researching, I've used OpenCode to create a command that reads Jira tickets and researches all the appropriate sources.