Ragasaurus

AI-Powered RAG Documentation Enhancement Plugin for Docusaurus

Comment

What Inspired Me to Build This

I watched technical writers build a Docusaurus site packed with institutional knowledge — but when we tried to layer on AI-powered search, things did not go as planned. The highly technical documentation was perfect for humans… but not as perfect for AI.

That’s when it hit me: most organizations are drowning in documentation that AI can’t understand.

And yet, the AI revolution hinges on high-quality, structured, AI-ready content. So I asked:
What if AI could make documentation AI-friendly, without taking humans out of the loop?

That became the spark for Ragasaurus, built around the principle of collaborative intelligence — not AI replacing people, but AI doing the heavy lifting so humans can stay strategic.

What I Learned: Multi-Agent Orchestration is Magic

Building Ragasaurus taught me the power of orchestrated, specialized agents working in concert. I designed a four-agent system where each agent focuses on a specific transformation:

  1. SEO Metadata Generator – surfaces key entities and summaries
  2. Topic Taxonomy Agent – builds hierarchical structure
  3. Chunking Optimizer – restructures content for better RAG performance
  4. Content Research Agent – validates or enhances with real-time sources

Using KaibanJS to coordinate these agents was a breakthrough. Watching them operate in sequence — with each one building on the last — felt like watching a team of experts collaborate. In just one test, 56 inter-agent handoffs optimized 14 complex markdown files.

But none of this replaces human judgment. Every change flows through GitHub PRs with confidence scores, source links, and decision checkpoints. No file is modified without human signoff — a core tenet of my human-in-the-loop philosophy.

How I Built This

Ragasaurus was built from the ground up during this hackathon to solve a real-world pain point.

Phase 1: Docusaurus-Embedded Prototype

I developed and tested directly inside a live Docusaurus site to iterate quickly and ensure real-world performance. The demo you see is the build environment.

Phase 2: Multi-Agent Architecture

I combined the strengths of:

  • Google Gemini API – for advanced content analysis
  • Tavily – to empower agents with live web research
  • KaibanJS – to handle intelligent agent coordination
  • GitHub API – for frictionless human review flows

Phase 3: Plugin Packaging

Once stable, I transformed it into a universal plugin installable with npm.

Phase 4: Visual Demo + Transparency Layer

Finally, I turned the development site into a full-featured demo, providing a transparent look into the AI workflow and a visual representation of each agent’s contribution.

Challenges That Pushed Me Forward

Agent Coordination Complexity

Designing a multi-agent system where each AI builds contextually on the last was no easy feat. Tuning that orchestration — ensuring quality and relevance at each step — took many iterations to achieve meaningful results.

Human-in-the-Loop UX

A great idea fails if humans don’t trust the output, so I knew I had to find a way to keep humans informed, involved, and in control. I designed PRs that clearly communicated changes, surfaced reasoning, and made approval effortless. I also added transparent logs with confidence scores and source attribution to help writers improve their documentation on their own terms.

Scaling for Real Teams

Choosing between functionality and cost was tough. Ragasaurus is optimized to work even for small teams with tight budgets, using APIs and workflows that balance performance with affordability. Making AI-ready documentation accessible was a core goal.

Compatibility

Making a plugin that "just works" with any Docusaurus setup required extensive testing and careful planning.

The Future Impact: AI-Ready Docs for Everyone

Ragasaurus wasn’t just built for this hackathon — it was built to solve a real problem facing companies, especially small startups.

But most teams don’t need to generate entirely new content or spend weeks restructuring their docs. They just need a way to make their existing documentation usable by AI systems — quickly, affordably, and responsibly.

That’s what Ragasaurus delivers.

Its potential impact:

  • Enterprise-grade RAG preparation for small teams
  • Accelerated AI adoption with zero manual cleanup
  • Smarter, safer human-AI collaboration
  • Transparent, responsible automation with human oversight baked in

Ragasaurus shows that AI can elevate human work — not replace it — and that hackathon projects can inspire powerful, open-source tools for the future of documentation.

This may have started as a hackathon build, but it's already on its way to being something much bigger.

Built With

Share this project:

Updates