💥 NEWSFLASH: #AI isn't your 🏗️ architect! Shocker, right? It seems Claude's been masquerading as your brilliant tech guru, but surprise! 🤖 It's actually just confidently wrong about everything. Maybe it's time to stop letting a glorified calculator write your Jira tickets and start taking #responsibility for your own mess. 🎉
https://www.hollandtech.net/claude-is-not-your-architect/ #Misconceptions #TechGuru #JiraTickets #AIReality #HackerNews #ngated
Claude Is Not Your Architect. Stop Letting It Pretend.

Somewhere between 'ask Claude for a quick opinion' and 'Claude is writing our Jira tickets,' we lost the plot. AI agents are brilliant implementers. They're also confidently wrong about every decision that matters. And when it all falls over, they won't be the ones carrying the bag.

HollandTech

"Formalizing AI workflows into reusable commands makes them more reliable and consistent than having to write a prompt every time we need help with something. When I run this command, it follows the same research steps in the same order, which means it's easier to find everything relevant and not forget about something.

The two-phase approach — research first, writing second — I think is also worth the extra step. Someone might want to just research a ticket and not write a draft. Also, this way the command works for other colleagues in the team who aren't tech writers.

MCP integrations are what make this a powerful tool. The ability to pull data from multiple internal tools in a single session is the foundation everything else is built on.

And as always: AI doesn't replace the tech writer's judgment. It replaces the tedious context-gathering so we can spend more time on the parts of the job that actually require expertise — deciding what customers need to know and how best to explain it.

If you want to try building something similar, OpenCode supports custom commands and agent skills. The setup takes a few minutes: define a command file with your research steps, create skill files with your docs framework conventions, and you have a reusable workflow. The OpenCode docs cover how to create commands and agent skills."

https://www.linkedin.com/pulse/building-ai-research-command-documentation-tickets-m%C3%A1rcio-florindo-mc4te/

#TechnicalWriting #OpenCode #Jira #JiraTickets #AI #GenerativeAI #AIWorkflows #ReusableCommands #MCP #MCPServers

Building an AI research command for documentation tickets

Tech writers spend a lot of time researching before they can start writing. Gathering context for a single ticket might mean jumping between several Jira tickets, existing documentation, internal wiki pages with PRDs or technical specs… Some tickets might have whole discussions with back and forths