Notes on documentation, codebases, and keeping context current.

AGENTS.md Explained: How to Write One File Every Coding Agent Can Read

AGENTS.md is the open standard for giving AI coding agents project context. Learn what it is, how it differs from CLAUDE.md and .cursorrules, and how to write one with a free generator.

• ai-agents
• claude-code
• developer-tools
• +1

Developer Onboarding Documentation Review: Is MoxieDocs Worth It?

Struggling with slow developer onboarding? We tested MoxieDocs and found out if it cuts ramp-up time by 30%—plus its hidden perks for GitHub maintainers.

MoxieDocs vs DeepDocs: Which Fits Lean Startup Teams Better?

Struggling to keep docs up-to-date with a tiny team? Compare MoxieDocs and DeepDocs to see which AI docs generator saves your engineers time without sacrificing clarity—so you can ship faster.

MoxieDocs vs DocuWriter.ai: Best Living Docs for GitHub

GitHub documentation tools matter—especially for teams using docs as code. This comparison cuts through the noise to show which tool, MoxieDocs or DocuWriter.ai, keeps your docs in sync with your codebase *without* the hassle.

GitHub Documentation: 7 Tips for Better README Files

Your README is the first impression for contributors and users. Discover 7 actionable tips to make it clear, engaging, and functional—boosting adoption and collaboration on your project.

What Is an Architecture Decision Record? A Complete Guide

An Architecture Decision Record (ADR) clarifies key technical choices for engineering teams. Learn how to document decisions that shape your system’s future—without endless meetings.

Living Documentation: How to Keep It Relevant with Continuous Updates

Outdated docs slow teams down. Discover how **living documentation tools** help engineering teams sync docs with code, reduce friction, and keep knowledge current—without the manual busywork.

AI Documentation: A Comprehensive Review of the Top 5 Platforms

Discover the best AI documentation platforms tailored for software teams, technical writers, and AI developers. Find the ideal tool to improve clarity and collaboration in your projects.

Introducing Free: See Moxie Docs Work on Your Own Repo, No Card Required

Moxie Docs now has a permanent Free plan: connect one repository, no credit card required ever, and see real generated docs, search, and live MCP context on your own code.

• product
• announcement
• developer-experience
• +1

8 MCP Documentation Servers to Speed Up Setup

Discover 8 MCP documentation servers that streamline setup for developers, AI tool builders, and technical teams. Improve efficiency with targeted solutions for coding assistants.

Documentation Debt: How to Measure It, Track It, and Pay It Down

Documentation debt compounds like tech debt but almost nobody tracks it. Learn where it comes from, how to score it, and how to set up a ratchet that keeps docs from rotting again.

• documentation
• developer-experience
• engineering-management

MCP Documentation Server: Complete Setup and Use Guide

Learn how to set up and utilize the MCP Documentation Server to streamline your documentation workflows, improve collaboration, and support AI-driven projects with detailed, step-by-step guidance.

• Documentation
• MCP
• developer-tools

7 AI Code Conventions That Keep Models and Teams Aligned

Discover essential AI code conventions that ensure models and development teams stay aligned, improving efficiency and consistency across AI projects. Practical strategies for engineering leaders and teams adopting AI.

MCP Security Risks Explained: Tool Poisoning, Confused Deputies, and the Lethal Trifecta

MCP servers introduce a new attack surface: tool poisoning, rug pulls, confused deputy, and the lethal trifecta. What is real, and how to mitigate it.

• mcp
• ai-agents
• security
• +1

Best ADR Tools: Managing Architecture Decision Records

Explore the best ADR tools to manage Architecture Decision Records. Compare ADR-Tools CLI, Log4brains, and Moxie Docs, and get a free Markdown ADR template.

• architecture
• documentation
• developer-tools

Building an Enhanced MCP Feedback Loop for Coding Agents

Learn how to build an enhanced MCP feedback loop for coding agents. Practical guide to integrating automated testing, linting, and self-correction via MCP servers.

• mcp
• ai-agents
• developer-tools

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.

• ai-agents
• mcp
• developer-velocity
• +1

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

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

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

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

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

AI Code Conventions: How Moxie Docs Compares to DocuWriter.ai

Compare Moxie Docs 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

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

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

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

Inside Moxie Docs' own continuous documentation workflow: how we keep code, docs, and AI agent context in sync automatically, 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 as code changes, cuts new-hire onboarding time, and stops documentation drift from burning senior engineers' hours answering Slack questions.

• documentation
• developer-experience
• engineering-management