Blog Kategorien
Schnell zur Zielseite
Stöbern in Kategorien
Community & Hilfe

How AI Writes Our Help Pages – and Why There's a "Second Brain" Behind It

Dienstag, 14. April 2026

Keeping help pages up to date is tedious work. New features, changed workflows, updated wording – until now, all of that had to be done by hand. We asked ourselves: What if AI didn't just answer questions, but maintained the knowledge itself? The result is our new help system – inspired by an idea that came out of Silicon Valley.

The Idea: Andrej Karpathy's "LLM Wiki"

Andrej Karpathy – co-founder of OpenAI and former head of AI at Tesla – published a concept in April 2026 that he called "LLM Wiki". The core idea: instead of having an AI search through all documents from scratch for every question (the classic RAG approach), you build a living knowledge system that maintains itself and improves over time.

"The tedious part of maintaining a knowledge base is not the reading or the thinking … it's the bookkeeping."
— Andrej Karpathy

The pattern consists of three layers:

The Three Layers of the LLM Wiki Pattern

Applied to Crazypatterns

Layer 1 Raw Sources
Source Documents & Code
Contents
  • Feature specs
  • Support exports
  • Screenshots
  • Legacy documentation
Read/Write Rule
The LLM reads from here but NEVER writes to it.
ingest
Layer 2 Wiki
AI-Maintained Markdown Pages
Contents (Core Knowledge Layer)
  • Knowledge pages
  • Help pages
  • Cross-references
  • Terminology / glossary
Read/Write Rule
The LLM reads AND writes here.
validate
Layer 3 Schema
Rules & Conventions
Contents (LLM Governance)
  • File format rules
  • Editorial standards
  • Lint rules & QA
  • Sync operations
Read/Write Rule
Controls how the LLM writes help pages.
Feedback Loop
Schema ----governs---→ Wiki
The rules from Layer 3 continuously feed back into wiki maintenance as governance directives.
Read-only foundation
Active working wiki
Governance ruleset
Figure 1: The three layers of the LLM Wiki pattern

What makes this special: the AI reads raw material, distills knowledge into interconnected pages, and keeps everything up to date – much like a librarian who doesn't just shelve books but also writes summaries and flags outdated entries.

What We Built From It

We found the idea immediately compelling – but our use case is different from a personal knowledge base. At Crazypatterns, it's about help pages that are derived directly from our code. When a feature changes, the documentation should automatically follow.

Inspired by this idea, we developed our own layer model for our code-to-help workflow:

From Code to Help Page – Our Layer Model

LAYER 1
Raw Sources

Unmodified source documents from the development process.

Rule: The AI reads from here but never writes to it.
Contents:
  • Feature specs
  • Support exports
  • Screenshots
  • Legacy documentation
ingest
LAYER 2
Knowledge Layer

AI-generated platform knowledge in a dedicated intermediate layer.

Never published directly, but it makes every help page better.
Contents:
  • Product knowledge
  • Editorial rules
  • Terminology
  • Feature mapping
distill
LAYER 3
Publishable Pages

Finished help pages for the live website.

Each page = one user goal.
Contents:
  • Help pages
  • JSON metadata
  • Markdown body
sync
FINAL
Sync Step

Synced to the database, then live on the website.

Architecture: The filesystem is the source of truth; the database is just a runtime mirror.
Filesystem
Database
Live Website
Figure 2: From code to help page – our layer model

Why Filesystem Over Database?

A deliberate design decision: the filesystem is our source of truth, not the database. Markdown files can be versioned (Git), reviewed (pull requests), and read and written directly by the AI. The database is just the runtime mirror – a fast cache for the live website.

The benefit: Every change to a help page is traceable, reversible, and auditable – just like code. No more copy-pasting between CMS fields, no more lost intermediate states.

How the AI Actually Works

Our system uses four operations that are loosely inspired by Karpathy's concept – but tailored to our workflow:

The 4 AI Operations in the Crazypatterns Workflow

Operation 1
Ingest
Intake and process new raw data
Trigger
Developer adds new feature spec to raw/sources/
Action
AI reads the spec, extracts relevant information
Result
Knowledge layer is updated
Operation 2
Query
Query knowledge and generate/update help pages
Trigger
Knowledge layer has new or changed information
Action
AI creates or updates the affected help pages
Result
Publishable pages are updated
Operation 3
Lint
Quality checks on generated content
Trigger
Help page was created or modified
Action
Automated checks for links, structure, special elements, images
Result
QA report with findings and recommendations
Operation 4
Publish
Sync to the database and go live
Trigger
QA passed + human review approval
Action
Markdown → HTML rendering → database sync
Result
Help page is live on crazypatterns.net
Figure 3: The four AI operations in the Crazypatterns workflow
* For readability, two steps (validate + audit) are combined into "Lint" here.

A concrete example: when we change the download process, a developer drops the new spec into raw/sources/. The AI reads the spec, updates the knowledge layer, and then adjusts the relevant help page for downloading patterns – in all supported languages.

Ensuring Quality: From Editorial Standards to Automated QA

AI-generated content needs clear guardrails. That's why we defined a clear editorial standard that applies to every help page:

  • One page = one user goal. No catch-all pages, no mixed topics.
  • The answer starts at the top. What is this about? Who is it for? What's the outcome?
  • Real step-by-step instructions. Numbered steps, clear actions, expected results.
  • No marketing fluff. Help is help, not advertising.
  • Links must be self-explanatory. No "click here" – instead, "Reset your password."

QA Pipeline

From Markdown file to verified live page

Step 1
Markdown File
Starting point: the AI has created or updated a help page as Markdown.
.md file .json metadata in the filesystem
Step 2
Sync
Markdown is synced to the database.
Automated process, no manual intervention
Step 3
QA Suite
Automated quality checks across 4 areas:
Links & Anchors
Link resolution
Content Structure
Structure validation
Special Elements
CSS/JS inspection
Image Sequences
Asset mirroring
Step 4
Fact Checker
AI agent compares help page text against actual code.
Detects discrepancies between the documentation and the reality in the code.
Step 5
Human Review
A human reviews and approves.
  • AI proposes, a human decides
  • For now, no automatic publishing without manual approval
Step 6
Deploy / Live
Approved page goes live on crazypatterns.net
DE EN Available in supported languages
Figure 4: QA pipeline from Markdown file to verified live page

Our QA suite automatically checks four areas:

Check What's verified? Method
Links & Anchors No .md links in the frontend, no wrong locales, all anchors present Link resolution
Content Structure No swallowed paragraphs, clean heading hierarchy Structure validation
Special Elements Info boxes not empty, formulas not truncated, tables properly styled CSS/JS inspection
Image Sequences No bullets next to images, no side-by-side errors, no broken images Asset mirroring

The Fact Checker

Note: The system is in production and is being continuously improved.

A key component of our pipeline is the AI-powered fact checker. This agent regularly inspects our code and compares the help pages against the actual state of the platform.

Here's how it works:

  • Code inspection: The agent reads relevant code sections and compares them against the descriptions in the help pages.
  • Discrepancy detection: If a help page says "Click the blue button" but the button is now green, that gets flagged.
  • Language parity: Automated checks to ensure DE and EN pages are in sync.
  • Continuous monitoring: The check runs automatically – not just when someone remembers to do it.

Fact Checker – Code ↔ Help Page

The AI fact checker automatically compares the platform's actual implementation against the official documentation.

Code / Platform
Current state of the platform
Sources
PHP code, templates, UI elements, feature flags
Actual Reality
Button color is green,
form has 3 fields.
AI Fact Checker
Compares reality against text
1. Code Inspection
Reads relevant code sections
2. Discrepancy Check
Flags mismatches (e.g., color, field count)
3. Language Parity
Checks if DE & EN are in sync
Runs automatically & continuously
Help Pages
Current Documentation
Sources
Markdown help pages
Documented Text
"Click the blue button",
"Fill in 4 fields"
Analysis & Results
Findings Report
Detailed list of discrepancies between code and help page, prioritized by severity.
Recommendations & Review
  • Concrete change suggestions for help page text.
  • Human review: The AI proposes, a human decides.
Figure 5: Fact checker – code ↔ help page comparison

What This Means for You

For you as a Crazypatterns user, one thing changes above all: the help becomes more reliable.

  • Help pages are updated faster when something changes on the platform.
  • Fewer outdated screenshots and incorrect descriptions.
  • Better consistency across languages.
  • Clear, task-based structure instead of long walls of text.

We believe that good help isn't an afterthought. It's part of the product. And with the right tooling, we can maintain it the way we maintain our code: carefully, transparently, and continuously.


Standard Benutzer Avatarbild
Bitte registrieren oder einloggen!

Letzte Aktivitäten in Blogs

Häkelschrift lesen lernen – einfache Erklärung mit 3 Beispielen
2 Kommentare Neu von Silvisunflower
Montag, 13. April 2026
Ein Schaf aus Garnknäuel
1 Kommentar Neu von Silvia1967
Sonntag, 12. April 2026
Kostenlose Häkelanleitung – Frühlingsdekoration Dekoring Hase
4 Kommentare Neu von Silvisunflower
Samstag, 11. April 2026
Krone, kostenlose Häkelanleitung
1 Kommentar Neu von Cyberdani
Freitag, 10. April 2026
Das Ananasmuster – Mein Lieblingsmuster mit Geschichte
8 Kommentare Neu von blickfang-design
Mittwoch, 8. April 2026

Meist-diskutierte Beiträge

Kostenlose Häkelanleitung Amigurumi Drache
Von TansuluuCraftHaus 133+ Kommentare
Donnerstag, 1. Oktober 2015
Kostenlose Häkelanleitung Babyschuhe für Neugeborene!
Von Leem 85+ Kommentare
Montag, 30. Oktober 2017
Kostenlose Anleitung für Socken häkeln Grösse 36 bis 47
Von Wollzauber73 36+ Kommentare
Freitag, 4. Dezember 2015
Hundekotbeutel-Spender
Von AmiToysNini 31+ Kommentare
Donnerstag, 12. August 2021

Beliebte Anleitungen

Top Anleitung von OmaElla aus der Nähen Kategorie!
Top Anleitung von SteffDesigns aus der Häkeln Kategorie!
Top Anleitung von elke-eder aus der Häkeln Kategorie!
Top Anleitung von stricken-im-trend aus der Stricken Kategorie!
Top Anleitung von Wurzels-Maschendesign aus der Häkeln Kategorie!
Top Anleitung von Mtinitoon aus der Häkeln Kategorie!
Top Anleitung von Frieda-Wollknaeuel aus der Häkeln Kategorie!
Top Anleitung von MorbenDesign aus der Häkeln Kategorie!
Top Anleitung von Wurzels-Maschendesign aus der Häkeln Kategorie!
Top Anleitung von elke-eder aus der Häkeln Kategorie!
Top Anleitung von Haekelei-mit-Spass-dabei aus der Häkeln Kategorie!
Mehr Top-Anleitungen

Kostenlose Anleitungen

Top Anleitung von surishaekelfee aus der Häkeln Kategorie!
Top Anleitung von MorbenDesign aus der Häkeln Kategorie!
Top Anleitung von Haekelicious aus der Häkeln Kategorie!
Top Anleitung von MorbenDesign aus der Häkeln Kategorie!
Top Anleitung von jennysideenreich aus der Häkeln Kategorie!
Top Anleitung von CrochetFox aus der Häkeln Kategorie!
Top Anleitung von Wurzels-Maschendesign aus der Häkeln Kategorie!
Top Anleitung von MorbenDesign aus der Häkeln Kategorie!
Top Anleitung von KiZoBaer aus der Häkeln Kategorie!
Top Anleitung von Rosi_und_Hanni aus der Häkeln Kategorie!
Mehr kostenlose Anleitungen

Gewinne jeden Monat Einkaufsguthaben!

42 Gewinne / 300 € Gesamtwert: 30×5 €, 10×10 €, 2×25 € – einfach Newsletter aktivieren. Kein Kauf nötig. Abmeldung jederzeit. Gewinne in Form von Crazypatterns‑Einkaufsguthaben. Mehr Informationen