Blog categories
Quick to Target
Browse Categories
Community & Help

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

Tuesday, April 14, 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.


Default user avatar image
Please register or Log in!

Recent Activities Blogs

Free Crochet Pattern Christmas Decor
1 Comment last by roskam
Monday, March 2, 2026
Free Amigurumi Pattern. Football Player Crochet Pattern
1 Comment last by sally-saunders
Sunday, July 6, 2025
Crochet Phone Case. Free Crochet Pattern for Cell Phone Pouch
2 Comments last by YarnFun_for_One
Sunday, June 8, 2025
Free Crochet Pattern for Strawberry Bear
2 Comments last by TansuluuCraftHaus
Saturday, February 1, 2025
Northern cardinal
1 Comment last by sylvia-cooper1
Friday, December 27, 2024

Most-discussed posts

Free crochet pattern
From Leem 11+ Comments
Sunday, March 20, 2016
Little Martian
From crochetfantasy 11+ Comments
Tuesday, May 19, 2020
A Flying Saucer
From crochetfantasy 10+ Comments
Thursday, May 28, 2020
Free Crochet Pattern Baby Sneakers
From Leem 7+ Comments
Monday, October 30, 2017
Dandelion. Little sunny.
From crochetfantasy 7+ Comments
Friday, March 22, 2019

Popular patterns

Top patterns from Natalija from the Crochet category!
Top patterns from stricken-im-trend from the Knitting category!
Top patterns from stricken-im-trend from the Crochet category!
Top patterns from MorbenDesign from the Crochet category!
Top patterns from MorbenDesign from the Crochet category!
Top patterns from elke-eder from the Crochet category!
Top patterns from NiggyArts from the Crochet category!
Top patterns from elke-eder from the Crochet category!
Top patterns from alexstrickt from the Knitting category!
Top patterns from kleinesundfeinesCH from the Crochet category!
More top patterns

Free patterns

Top patterns from MorbenDesign from the Crochet category!
Top patterns from CrochetFox from the Crochet category!
Top patterns from Miralay from the Crochet category!
Top patterns from jennysideenreich from the Crochet category!
Top patterns from MorbenDesign from the Crochet category!
Top patterns from MorbenDesign from the Crochet category!
Top patterns from MorbenDesign from the Crochet category!
Top patterns from MorbenDesign from the Crochet category!
Top patterns from kandjdolls from the Crochet category!
Top patterns from JosephinesPuppenstuebchen from the Crochet category!
More free patterns

Win shopping credit every month!

42 prizes / total value €300: 30×€5, 10×€10, 2×€25 – simply activate the newsletter. No purchase necessary. Unsubscribe at any time. Prizes are awarded as Crazypatterns shopping credit. Learn more