# Promptless blog > Every post on the Promptless blog with its markdown twin: product updates, technical writing, and customer stories. The site index is at https://promptless.ai/llms.txt. Append `.md` to any page URL (or send `Accept: text/markdown`) to get its markdown twin. ## Technical - [The task-completion gap in AI-written docs](https://promptless.ai/blog/technical/plausible-isnt-correct.md): We reviewed 1,267 DoGBench agent sessions: 45.5% had a task-completion gap and 6.1% contained fabricated content. Here's why agents miss the reader's task and how documentation owners can review for it. - [DoGBench: Can agents meet expert standards for user-facing documentation?](https://promptless.ai/blog/technical/dogbench.md): DoGBench evaluates whether AI agents can recognize when documentation needs updating and produce changes that meet expert review standards. The best agent in the paper reached a composite score of 47.3 out of 100. - [6 months ago, we rebuilt our codebase from scratch to work better with Codex/Claude. Was it worth it?](https://promptless.ai/blog/technical/rebuilding-our-codebase-for-coding-agents.md): Output per engineer went up 3-5x and human PR review became optional, without an increase in bug frequency. The honest version, including the agent swarm that face-planted and the month our output went down. - [Docs Site Search Optimization: Why Content Accuracy Comes First](https://promptless.ai/blog/technical/docs-site-search-optimization.md): Most teams optimize search tooling while leaving stale content in place. Here's why docs search quality starts with accuracy, not configuration. - [Developer Relations Docs: Why They Go Stale and Who Should Own Them](https://promptless.ai/blog/technical/developer-relations-docs.md): DevRel docs break because responsibility is spread across too many teams, so nobody actually owns accuracy. Here's how to fix the ownership model. - [Developer Relations Docs Have a New Primary Reader](https://promptless.ai/blog/technical/developer-relations-docs-agent-primary-reader.md): AI coding agents now consume developer relations docs at higher volume than humans on many sites. Here is what that means for what DevRel teams should write. - [Automated API Documentation Updates for Weekly Releases](https://promptless.ai/blog/technical/automated-api-documentation-updates.md): A practical workflow for automated API documentation updates based on OpenAPI changes, API pull requests, changelogs, and release checks. - [Agent Context Files Explained: AGENTS.md, CLAUDE.md, and llms.txt](https://promptless.ai/blog/technical/agent-context-files-explained.md): AGENTS.md, CLAUDE.md, and llms.txt give AI agents the product-specific context they need to work correctly. Here's what each file does and why they go stale. - [API Documentation Automation: What the Tools Solve and What They Don't](https://promptless.ai/blog/technical/api-documentation-automation.md): Generation tools handle the easy part. Here's why 55% of API teams still report inconsistent docs, and what automation actually needs to solve. - [Technical Writing with AI: Faster Drafts, Larger Maintenance Surface](https://promptless.ai/blog/technical/technical-writing-with-ai.md): AI tools have made technical writing faster. They've also created more documentation to maintain, with the same capacity to keep it accurate. - [Your Docs Are Pages. Your Product Knowledge Is a Graph.](https://promptless.ai/blog/technical/your-docs-are-pages-your-product-knowledge-is-a-graph.md): Flat docs lose the relationships between your product's concepts. Here's why a living knowledge graph matters for teams building with AI agents. - [Documentation Versioning Best Practices for API Teams](https://promptless.ai/blog/technical/documentation-versioning-maintenance-multiplier.md): Versioned docs multiply your maintenance work with every release. Here's how API teams can plan for it before it becomes a support problem. - [Documentation Coverage: The Metric Your Engineering Team Has Never Checked](https://promptless.ai/blog/technical/documentation-coverage.md): Your engineering team tracks test coverage. Almost no one tracks documentation coverage. Here's how to measure whether your product surface is actually documented. - [Documentation Coverage: The Metric Your AI Features Actually Need](https://promptless.ai/blog/technical/documentation-coverage-metrics-for-ai-features.md): Most docs teams track page count and traffic. Here's why documentation coverage is the metric that actually predicts whether your AI features will work. - [Interactive API Documentation: Why the Hard Part Is Keeping It Accurate](https://promptless.ai/blog/technical/interactive-api-documentation.md): Most teams ship interactive API docs and stop there. Here's why spec drift undermines the "try it out" experience, and what changes when AI agents are involved. - [How to Connect Code Repositories with Documentation Platforms](https://promptless.ai/blog/technical/connect-code-repositories-with-documentation-platforms.md): If you're looking to connect a docs repo to Fern, Readme, GitBook, or Mintlify — that's easy and each platform covers it. This is about the harder problem: connecting your product code so docs stay current when the product changes. - [SDK Documentation Best Practices: What Actually Hurts Developer Adoption](https://promptless.ai/blog/technical/sdk-documentation-best-practices.md): SDK documentation fails developers in predictable ways. Here's how to cut Time to First Call and keep code examples accurate as your SDK evolves. - [SDK Documentation Best Practices That Hold Up After Launch](https://promptless.ai/blog/technical/sdk-documentation-best-practices-after-launch.md): SDK documentation best practices mean maintaining three distinct surfaces that break differently: reference, code samples, and getting-started guides. - [API Changelog Best Practices: Write for the Developer, Not the Team](https://promptless.ai/blog/technical/api-changelog-best-practices.md): 39% of developers say inconsistent documentation is the biggest roadblock to API collaboration. Most changelogs cause it. Here's how to write one developers can actually use. - [What Documentation Debt Actually Costs Engineering Teams](https://promptless.ai/blog/technical/documentation-debt.md): Documentation debt generates no automated alerts. Here's how to measure what you can't see and stop paying the hidden cost in onboarding and engineering time. - [Documentation Debt Accrues Where Your Team Can't See It](https://promptless.ai/blog/technical/documentation-debt-accrues-where-your-team-cant-see-it.md): Documentation debt quietly costs mid-sized engineering teams $500K–$2M annually. The people bearing that cost aren't in your standups. Here's how to prioritize what to fix. - [How to Measure Developer Documentation ROI](https://promptless.ai/blog/technical/how-to-measure-developer-documentation-roi.md): Most documentation teams track outputs, not outcomes. Here's how to measure developer documentation ROI, and why that return decays if docs aren't maintained. - [Developer Documentation ROI: The Metrics That Actually Matter](https://promptless.ai/blog/technical/developer-documentation-roi.md): Most teams make the documentation ROI case with support tickets. That understates it by 10x. Here's how to measure what leadership actually cares about. - [We Scored 100 on Agent-Friendly Docs. Here's Why That's Not Enough.](https://promptless.ai/blog/technical/agent-friendly-docs-necessary-not-sufficient.md): Making your docs accessible to AI agents is necessary but not sufficient. Agents are more credulous than humans, which means accuracy and clarity matter more than ever. - [Using Slack as a "Knowledge Base"? Here's What You're Missing out on](https://promptless.ai/blog/technical/using-slack-as-a-knowledge-base.md): Slack feels like a knowledge store because answers happen there. Its design actively destroys institutional knowledge. Here's why docs-as-code fixes it. - [Karpathy's LLM Wiki Went Viral. Here's What It Means for Your Personal Knowledge Base.](https://promptless.ai/blog/technical/karpathys-llm-wiki-personal-knowledge-base.md): Karpathy's LLM wiki pattern solves the oldest problem in personal knowledge management. Here's why it matters for your personal wiki, idea file, or knowledge base. - [When YOU are the Docs Team - Lessons from Working with Some of the Best Writers and Managers in the Industry](https://promptless.ai/blog/technical/solo-writer-team-lead.md): Whether you're the only technical writer at your company or leading the docs team, some of the structural challenges are similar: not enough resources to build infrastructure, a manager who doesn't know your craft, and an AI moment that's changing what the job entails. - [Help Center vs Docs-as-Code: When to Switch](https://promptless.ai/blog/technical/help-center-to-docs-as-code.md): A practical guide to choosing between a help center and docs-as-code, with specific signals for when to migrate and when to stay. - [Which Agent Memory Provider Should You Choose, and Why Memory Alone is not Enough](https://promptless.ai/blog/technical/agent-memory-provider.md): A practical guide to choosing an agent memory provider by workload, with clear tradeoffs, technical specs, and what to add so reliability holds up in production. - [How to Increase the Deflection Rate of Your Support Agent and Build a Feedback Loop](https://promptless.ai/blog/technical/support-agent-deflection.md): Most support agent deflection problems aren't model problems — they're documentation problems. Here's how to diagnose yours and build a feedback loop that compounds over time. - [What is Agent Context Engineering? And How is it Different from Prompt and Harness Engineering?](https://promptless.ai/blog/technical/agent-context-engineering.md): Learn what agent context engineering is, how it differs from prompt and harness engineering, why most agent failures are context failures, and a four-layer framework for building reliable AI agents. - [Documentation Drift Is a Detection Problem, Not a Writing Problem](https://promptless.ai/blog/technical/documentation-drift-detection-problem.md): Most teams treat documentation drift as a writing problem. It's not. The real bottleneck is detection — knowing what changed before the damage is done. - [What It Looks Like When Your Docs Keep Up With Your Product](https://promptless.ai/blog/technical/how-teams-keep-docs-up-to-date-with-promptless.md): Three real workflows from teams using Promptless that show what changes when your tooling handles detection, context gathering, and the first draft. - [A Practical Guide on How to Optimize Your Docs for Agents](https://promptless.ai/blog/technical/agent-docs.md): A practical guide for technical writers on adapting documentation for AI agent consumption, grounded in how agents actually access and use docs today. - [Ambient Capture: The Missing Layer in Modern Documentation](https://promptless.ai/blog/technical/ambient-capture.md): Ambient capture is the intelligent listening and recommendation layer for docs owners, continuously detecting docs-impacting changes so writers can focus on analysis and communication rather than surveillance. - [Why we're building Promptless](https://promptless.ai/blog/technical/why-were-building-promptless.md): AI won't replace human labor. But people that use AI well will replace those that don't. Promptless exists to make sure as many people as possible are in the first group. - [Parrots are underrated pets and tools](https://promptless.ai/blog/technical/parrots-are-underrated-pets-and-tools.md): You know dozens of useful heuristics but can't hold them all in your head while doing actual work. LLMs can run those obvious-in-hindsight checks in parallel in the background, acting as cognitive prosthetics that apply known wisdom continuously so you don't have to remember to. - [Writing code was hard, actually](https://promptless.ai/blog/technical/writing-code-was-hard-actually.md): The revisionist claim that writing code was never the hard part arrives conveniently at the moment AI makes it cheap to produce. But the market, the machine, and the engineers who built it all tell a different story. - ["I Have No Mouth, and I Must Scream"](https://promptless.ai/blog/technical/i-must-scream.md): What happens when you give an AI agent a Slack channel to complain in. ## Newsletter - [Run the docs loop from your editor, and more from September 2026](https://promptless.ai/blog/newsletter/whats-new-september-2026.md): Start a Promptless docs task from your editor over MCP and follow it to the docs PR. Plus Jira done triggers, scheduled checks, and GitLab updates. ## Product updates - [Doc Detective + Promptless: Test your docs like you test your code](https://promptless.ai/blog/product-updates/doc-detective.md): When a doc collection uses Doc Detective, Promptless writes and updates the tests for the procedures it documents, in the same pull request as the docs change. Here's how that works and how we test the promptless.ai docs against our own dashboard. - [Comment @promptless on a GitLab Merge Request to Request Documentation](https://promptless.ai/blog/product-updates/gitlab-merge-request-comment-trigger.md): Mention @promptless in any GitLab merge request comment to trigger a documentation review. Works on any project your GitLab connection can access, including projects outside your trigger config. - [Fix skill slop before it makes your AI workforce worse](https://promptless.ai/blog/product-updates/introducing-promptless-for-agent-instructions.md): Great skills and agent instructions are like giving superpowers to AI, but unmaintained skills actually make your agents worse. - [Grant Promptless Access to Files in Private and Shared Teams Channels](https://promptless.ai/blog/product-updates/teams-private-channel-file-access.md): Promptless can now read files attached in private and shared Microsoft Teams channels. Each one appears as its own selectable SharePoint site. - [Promptless Now Alerts You When an Integration Has a Problem](https://promptless.ai/blog/product-updates/integration-health-alerts.md): Promptless now notifies your escalation channel when a connected integration breaks, so a failed connection doesn't silently stall your documentation pipeline. - [Google Drive as a Context Source for Documentation Suggestions](https://promptless.ai/blog/product-updates/google-drive-context-source.md): Promptless can now read your Google Drive as a context source. Connect Drive on the Integrations page and Promptless searches your Docs, Sheets, and Slides when generating documentation suggestions. - [Doc Agents Now Run Your Existing Agent Skills](https://promptless.ai/blog/product-updates/doc-agents-existing-skills.md): Promptless automatically discovers and runs Agent Skills already in your documentation repository. If your team keeps skills under .claude/skills/, .agents/skills/, or .cursor/skills/, Promptless uses them with no extra setup. - [Connect Your Slite Knowledge Base to Promptless](https://promptless.ai/blog/product-updates/slite-context-source.md): Slite is now a supported context source. Connect your workspace via API key and Promptless will search your notes when generating documentation suggestions. - [Slack Notifications for Suggestion Outcomes](https://promptless.ai/blog/product-updates/suggestion-lifecycle-notifications.md): Promptless now posts a follow-up reply in each suggestion's Slack thread when the suggestion is merged, closed, rejected, or archived. Admins enable it from Organization Settings. - [Connect Multiple GitHub Organizations to One Promptless Account](https://promptless.ai/blog/product-updates/multi-org-github-connect.md): Teams with multiple GitHub organizations can now connect them all to a single Promptless account, manage each integration independently, and see repos from every org in one project dropdown. - [Edit Doc Collection Settings Without Contacting Support](https://promptless.ai/blog/product-updates/self-serve-doc-collection-editing.md): Doc collection settings can now be edited directly in the Promptless dashboard. Update your docs framework, config path, published URL, Vale config, or Doc Detective settings without a support request. - [Comment @promptless on a PR to Request Documentation](https://promptless.ai/blog/product-updates/request-docs-via-pr-comments.md): Promptless can now be triggered by commenting @promptless on a pull request in any repo you've connected to Promptless, including merged or closed ones. - [Promptless Now Supports Starlight (Astro) as a Docs Platform](https://promptless.ai/blog/product-updates/starlight-support.md): Promptless now supports Starlight, the Astro-based docs framework, with automatic detection via astro.config files and first-class onboarding support. - [Preview Rendered Markdown Diffs in the Dashboard](https://promptless.ai/blog/product-updates/markdown-preview-suggestion-diffs.md): Promptless now shows a rendered preview of Markdown and MDX suggestion diffs. Click "Preview Markdown" on any .md or .mdx file to see changes as formatted output, not raw diff text. - [Launch Week: December 2025](https://promptless.ai/blog/product-updates/launch-week-december-2025.md): Five major features we launched this December, from custom voice matching to automated screenshot updates. ## Life at Promptless - [Ship Your First (or Next) Open Source Docs PR](https://promptless.ai/blog/life-at-promptless/wtd-writing-day.md): Come work through pre-vetted documentation issues from real open-source projects at Write the Docs Portland 2026 Writing Day. Projects include Mautic, Vitess, and Helm. - [Running a Lightweight Research Paper Club](https://promptless.ai/blog/life-at-promptless/running-a-lightweight-research-paper-club.md): How we run a weekly paper club at Promptless that's surprisingly useful, surprisingly easy, and has led to tangible product improvements. ## Customer stories - [How Vellum uses Promptless to draft over 50% of their doc updates](https://promptless.ai/blog/customer-stories/vellum.md): By democratizing documentation contributions, every team member now drives content—making docs a true team sport powered by Promptless.