The Moxie Docs blog
Notes on documentation, codebases, and keeping context current.
Practical writing on keeping documentation in sync with the code, onboarding engineers faster, and giving AI agents context they can trust.
Stop Maintaining .cursorrules: A Better Way to Give AI Context
Static .cursorrules files grow bloated, fall out of sync, and go stale. Learn how Model Context Protocol (MCP) servers replace static custom rules files with live, queryable repository context.
How to Write the Perfect CLAUDE.md File for Claude Code
Claude Code relies on a CLAUDE.md file for instructions on build, test, and style conventions. Learn how to write, structure, and maintain a perfect CLAUDE.md that keeps your AI agent on track.
- claude-code
- ai-agents
- developer-tools
- +1

Living Documentation Best Practices for Agile Teams
Discover best practices for living documentation in Agile teams. Enhance collaboration, transparency, and efficiency with effective documentation strategies tailored for software engineering, DevOps, and startups.
Answer Engine Optimization for Developer Docs: How to Get Cited by AI Assistants
Developers now ask AI assistants before they read your docs. Learn how answer engine optimization (AEO) works for documentation: llms.txt, answer-first writing, stable URLs, and why accuracy is the real ranking factor.
- documentation
- ai-agents
- industry-trends

Documentation Drift Review: Detection Methods for Technical Teams
Explore effective detection methods for documentation drift to ensure accuracy in technical teams. A comprehensive review for software engineers, writers, and DevOps.
Mermaid Diagrams for Developers: Examples, Syntax, and a Free Live Editor
Learn Mermaid diagram syntax with live flowchart, sequence, ER, class, and state examples. Paste into a free browser Mermaid live editor for instant preview, shareable links, and SVG/PNG export.
- mermaid
- documentation
- developer-tools
- +1

GitHub Documentation Gets Real-Time Collaboration Feature Update
Discover the latest GitHub documentation update featuring real-time collaboration tools, enhancing teamwork for software developers, DevOps, and technical writers.
Managing AI Agent Context Without the Bloat
Static rule files like .cursorrules get stale fast. We look at how to serve fresh codebase context to AI agents via Model Context Protocol without eating your token limits.
- mcp
- ai-agents
- developer-experience

Documentation Drift Spurs New Push to Tie Docs to Code
Discover how documentation drift is prompting a new push to connect documentation directly to code, empowering software engineers and DevOps teams to improve accuracy and consistency.
- documentation
- developer-experience

Comparing AI Coding Conventions in Auto Documentation and AI Documentation
Explore a comprehensive comparison of AI coding standards in auto documentation and AI documentation workflows, helping engineering leaders and developers optimize their practices.
- documentation
- industry-trends

Why Documentation Drift Happens and How to Prevent It
Learn why documentation drift occurs and discover practical strategies for preventing it. Essential guide for software teams, technical writers, and DevOps.
- documentation
- engineering-management

Auto Documentation vs Living Documentation: Which Is More Effective?
Discover the differences between Auto Documentation and Living Documentation to determine which method best enhances your development workflow and maintenance.
- documentation
- industry-trends

MoxieDocs Review: AI-Powered Documentation for Modern Dev Teams
Discover how MoxieDocs leverages AI-powered technology to streamline documentation for modern software teams, boosting efficiency for developers and technical writers.
- documentation
- developer-experience

AI Code Conventions: How MoxieDocs Compares to DocuWriter.ai
Compare MoxieDocs and DocuWriter.ai to evaluate AI code standards for documentation. Ideal for engineering leaders and developer-tool buyers seeking top AI documentation platforms.
- industry-trends
- documentation

GitHub Documentation Gets AI Upgrade with New Copilot Features in 2026
Discover how GitHub documentation is enhanced with new AI-powered Copilot features in 2026, revolutionizing support for software engineering teams and DevOps experts.
- ai-agents
- developer-experience
- documentation

AI Code Conventions in 2026: Emerging Trends and Industry Insights
Discover the latest AI code standards and emerging trends in 2026 shaping the industry. Insights for engineering teams, developers, and tech decision-makers.
- industry-trends
- ai-agents

A Comprehensive Guide to GitHub Documentation for Development Teams
Learn how to effectively utilize GitHub documentation with this guide designed for development teams and engineering managers seeking clear, practical guidance.
- documentation
- developer-experience

MoxieDocs vs DeepDocs: Which AI Documentation Tool Wins?
Compare MoxieDocs and DeepDocs to find the best AI documentation tool for software teams, technical writers, and AI developers. Discover features and insights to make an informed choice.
- industry-trends
- documentation

Living Documentation and AI Documentation: A Comparative Overview
Explore a detailed comparison of Living Documentation and AI Documentation, helping software teams and engineers choose the best practices for effective AI-assisted development.
- documentation
- industry-trends

GitHub Code Coverage on Pull Requests Now in Public Preview
GitHub Code Coverage on pull requests is now available in public preview. Enhance code quality and review confidence with seamless CI integration.
- developer-experience
- industry-trends

GitHub Documentation Improvements Drive Better Developer Support
Discover how GitHub documentation improvements enhance developer support, streamline workflows, and empower open-source projects. Learn more about these updates
- developer-experience
- documentation

Ultimate Guide to Auto Documentation for Development Teams
Discover the ultimate guide to auto documentation for development teams, covering best practices, tools, and strategies for reliable documentation workflows.
- documentation
- developer-experience

8 Top AI Documentation Tools for Engineering Teams in 2026
Discover the top 8 AI documentation tools for engineering teams in 2026. Compare features, pricing, and ease of use for managers evaluating platforms.
- industry-trends
- documentation
Stop Copy-Pasting: How MCP is Re-Engineering the AI Coding Loop
How the Model Context Protocol (MCP) replaces copy-paste context with a universal API for AI coding — architecture, secure transports, and accurate docs.
- mcp
- developer-experience
AI code assistants and living documentation in 2026
How AI code assistants now use living documentation: automated updates tied to GitHub activity and context that stays accurate as code changes.
- documentation
- ai-agents
How to sync documentation with GitHub and keep it alive as your codebase evolves
Sync documentation with GitHub using webhooks, CI/CD, and drift detection so docs stay accurate as your codebase evolves—and your AI tools stay grounded.
- documentation
- developer-experience
Ship cleaner PRs with agentic AI: use MCP context and living docs
Improve code quality with agentic AI (Claude Code, Cursor) using MCP context and living docs. Benchmarks, prompts, and PR tips—plus how Moxie Docs helps.
- mcp
- developer-experience
- documentation
MCP for Agentic Programming: Practical ways AI helps Dev, QA, and Product
A clear overview of MCP and how it powers agentic programming across engineering, QA, and product—with examples and patterns to adopt today.
- mcp
- ai-agents
- developer-experience
How We Dogfood a Continuous Documentation Workflow to Keep Code, Docs, and AI in Sync
How we keep code, docs, and AI context in sync with a continuous documentation workflow — and the setup that speeds onboarding.
- documentation
- developer-experience
- engineering-management
Stop Writing Novels in Your Wiki: A Minimal Internal Developer Documentation Template That Survives Change
Why wiki pages rot in fast codebases and how a lightweight, git-backed internal developer documentation template keeps docs accurate without busywork.
- documentation
- developer-experience
- engineering-management
Automated code documentation that kills onboarding debt
Automated code documentation keeps context current, cuts onboarding time, and stops doc drift from wasting senior engineering hours.
- documentation
- developer-experience
- engineering-management
Put your own repo on the same footing.
Connect a GitHub repository and get searchable docs, MCP-ready context, and Cleanup PRs that keep it all current.