AI tool comparison
Context Engineering Reference vs Pretty Fish
Which one should you ship with? Here is the side-by-side panel verdict, pricing read, reviewer split, and community vote comparison.
Developer Tools
Context Engineering Reference
Runnable 5-layer stack that enforces RAG output against retrieved context
75%
Panel ship
—
Community
Paid
Entry
Context Engineering Reference Implementation is an open-source project by Brian Carpio at OutcomeOps that makes a concrete claim: RAG is not enough. The project defines and implements a 5-layer context engineering stack — Corpus, Retrieval, Injection, Output, and Enforcement — where the final Enforcement layer is what separates it from standard retrieval-augmented generation pipelines. The enforcement layer actively verifies that generated content actually reflects what was retrieved, closing the loop on hallucinations that occur when an LLM "knows" something from pretraining that contradicts the retrieved document. The reference implementation runs against Amazon Bedrock and Claude using a Spring PetClinic codebase with Architecture Decision Records as the corpus — making it practical to study with real enterprise artifacts. Launched April 17 and already trending as a Show HN post, the project is winning the framing war around "context engineering as a discipline." As prompting has matured into prompt engineering, RAG is now maturing into something more rigorous. This is one of the cleaner articulations of that shift.
Developer Tools
Pretty Fish
Free, beautiful Mermaid diagram editor that works offline
75%
Panel ship
—
Community
Free
Entry
Pretty Fish is a free, open-source Mermaid diagram editor with live preview, 5 built-in themes, multi-page workspaces, and one-click SVG/PNG export. It works offline as a Progressive Web App (PWA) and requires no account, no login, and no installation. It supports all 14+ Mermaid diagram types including flowcharts, sequence diagrams, Gantt charts, entity-relationship diagrams, and Git graphs. The editor includes syntax highlighting, auto-completion, instant error feedback, and a clean split-pane layout. The multi-page workspace lets you manage entire diagram projects in a single session. Export quality is excellent — SVG output is clean and scaling-ready for use in presentations, docs, or design systems. Pretty Fish hit Hacker News front page today with 128 points and has the makings of the go-to Mermaid editor for developers who generate diagrams from AI-assisted documentation workflows. With LLMs increasingly generating Mermaid syntax in their outputs, having a polished renderer and editor matters more than ever.
Reviewer scorecard
“The Enforcement layer is the real insight here — I've seen so many RAG systems where the LLM just ignores the retrieved context and answers from weights anyway. Having a verifiable check that output actually uses retrieval is table stakes for production. This implementation shows exactly how to do it.”
“The official Mermaid live editor is clunky and slow. Pretty Fish loads instantly, works offline, and the multi-page workspace means I can manage all my architecture diagrams in one place. Bookmarking this immediately as my default Mermaid editor.”
“The 5-layer framing is useful for communication but it's mostly reorganizing concepts practitioners already know. The enforcement check adds overhead and the reference implementation is tied to Bedrock — not everyone wants another AWS dependency in their AI stack.”
“It's a genuinely nice editor but it's solving a niche problem — most devs who need Mermaid diagrams already use VS Code extensions or embed them in Notion. And with no backend, there's no collaboration or sharing story, which limits its use in team workflows.”
“Naming and systematizing a practice is how it scales. 'Context engineering' as a discipline with a formal 5-layer model will shape how teams hire, design systems, and evaluate results — just as 'prompt engineering' gave teams a shared vocabulary for something they were already doing intuitively.”
“As AI tools increasingly output Mermaid syntax to explain architectures and flows, the need for a great rendering environment grows. Pretty Fish positions itself at the intersection of AI-generated diagrams and human editing — that's a well-timed niche.”
“For teams building editorial AI tools or knowledge bases, the enforcement layer concept translates directly to brand safety and accuracy guarantees. Knowing your AI isn't wandering off into its own hallucinations is what makes these systems publishable.”
“Five beautiful themes and clean SVG exports mean I can finally use Mermaid diagrams in client-facing presentations without them looking like developer scratch notes. This is the Mermaid editor I've always wanted and the zero-friction setup seals it.”
Weekly AI Tool Verdicts
Get the next comparison in your inbox
New AI tools ship daily. We compare them before you waste an afternoon.