AIGNE DocSmith: Documentation that Ships with Your Code

Write great docs, without writing them yourself.

In software, code is the structure. Documentation is the blueprint. Too often, the blueprint goes stale while the structure keeps changing. What if documentation moved with the same cadence—and intelligence—as the code it describes?

AIGNE DocSmith isn’t another place to type. It’s a different way to keep the conversation between a project and its creators alive. Think of it as a scribe that stays in lockstep with your repository: listening to the code, proposing an outline, drafting the story, and revising as the project evolves.

The Challenge: The Echo of Unwritten Knowledge#

We all know the paradox. Docs are essential for collaboration, yet the first to drift. Knowledge lives in the heads of the builders and the seams of the codebase, not in the README. Drift slows teams, buries intent, and makes onboarding expensive. Write great docs, without writing them yourself. (Because AI agents never complain about deadlines. 😉)

What DocSmith Proposes#

Built on ArcBlock's AIGNE Framework, DocSmith is an AI-driven agent that automates the creation of detailed, structured, and multi-language documentation directly from your source code. It treats the repo as the source of truth. Use agents to plan, draft, and update documentation so it changes when the code changes. Keep humans in the loop for structure and edits. Ship docs with the build and not weeks later.

• Plan: Map a codebase into a clean, navigable outline.
• Draft: Generate precise, human‑readable pages (with diagrams when needed).
• Update: Regenerate specific sections with targeted feedback instead of rewriting whole docs.
• Translate: Publish in multiple languages so the audience doesn’t have to be fluent in your default.
• Publish: Make the latest version the one people actually read—on the DocSmith portal or your own site.

Internally, ArcBlock teams run DocSmith across all of our projects to keep docs current.

A Piece of a Larger Puzzle: The AIGNE Ecosystem#

DocSmith is one of the Smiths in the AIGNE ecosystem. If DocSmith is the Scribe—capturing a project’s story—then WebSmith is the Architect (turning agents into sites), and CodeSmith is the Artisan (reviewing and improving the code). They share the same AIGNE Framework, CLI, and Hub, so you can adopt one tool or the whole workshop without changing your workflow.

Quick Start#

The Road Ahead#

The release of DocSmith represents a new beginning. Our roadmap is focused on deepening its intelligence and integrating it more deeply into the development lifecycle and making easy documentation available for businesses.

• Direct CI/CD Integration: Making documentation a live artifact of your build process.
• Doc Quality Evaluation: Introducing metrics and reporting to measure the clarity and effectiveness of the documentation.
• Enhanced User Experience: Developing more intuitive components for formatting and presenting information.

We are not just building a tool; we are shaping a new standard for how software is understood and maintained.

Explore the Blueprint#

We invite you to check out AIGNE DocSmith. See how it works, try it with your projects, and contribute to its evolution. After all this philosophical talk about blueprints and puzzles, the best way to understand it is to simply try it.

• Explore the Code: https://github.com/AIGNE-io/aigne-doc-smith
• Get Started: https://docsmith.aigne.io
• View a Sample: https://docsmith.aigne.io/app
• Read the Docs: https://docsmith.aigne.io/c/docs/aigne-docsmith

Try AIGNE DocSmith for free today and publish your docs for free, or self-host them on your own server.