v0.2.0 — Wiki Automation Layer

v0.2.0 — Wiki Automation Layer

This release adds a complete automation layer for wiki maintenance and
raw source ingestion, and brings the Russian wiki layer to full lint-clean
status.

New skills

• docs/INGEST-SKILL.md — agent prompt for adding raw source material:
  fetches or accepts pasted content, classifies subdirectory, cleans body,
  builds frontmatter, runs duplicate checks, reports series detection
• docs/WIKI-SKILL.md — agent prompt for wiki page generation:
  Mode A (new ingest: raw/ → both wiki layers) and Mode B (update: revise
  existing pages when source changes)
• docs/ENHANCE-SKILL.md — single-page polish skill replacing
  PAGE-ENHANCEMENT-STANDARD.md: mechanical scan, frontmatter standardization,
  wikilink enrichment via link maps, content quality audit, lint gate

New scripts (tools/)

• check_duplicate.py — duplicate URL and slug detection before ingest
• derive_slug.py — filename slug normalization from URL
• check_series.py — series membership detection for raw/ files
• build_link_map.py — generates docs/link-map-en.md and
  docs/link-map-ru.md; agents read these instead of scanning directory trees
• check_parity.py — checks whether a slug exists in both wiki layers

Generated files

• docs/link-map-en.md and docs/link-map-ru.md — wikilink target maps
  for both layers; regenerate with python3 tools/build_link_map.py

Source policy

• raw/ now accepts Bitcoin-only sources beyond 21ideas.org — BIPs,
  Satoshi writings, established Bitcoin-only authors and publications
• Full tier list in docs/CONTRIBUTING.md; contributor prompt template
  added for Track 2 (EN + RU website versions)

Wiki content

• wiki-ru/: all 76 pages lint-clean (0 mechanical issues)
• wiki-en/philosophy/overview.md: first EN page enhanced with
  ENHANCE-SKILL.md — canonical frontmatter, wikilinks, reviewed field

Superseded

• docs/PAGE-ENHANCEMENT-STANDARD.md — replaced by ENHANCE-SKILL.md;
  kept for historical reference with superseded notice

Pending (v0.3.0 candidates)

• wiki-en/ full enhancement pass
• build_link_map.py integration into CI/deploy workflow
• INGEST-SKILL.md and WIKI-SKILL.md production testing

v1.0.0 — 21wiki public release

21wiki v1.0.0 — First public release

The first stable release of 21wiki: a bilingual, AI-assisted,
human-curated Bitcoin knowledge base built from 21ideas.org source material.

Live site

🌐 wiki.21ideas.org

What's in this release

Russian wiki (wiki-ru/) — fully enhanced

76 pages across concepts, entities, history, philosophy, practice, series,
and books. All pages meet the full quality standard: complete frontmatter,
rich wikilinks, reader-facing 21ideas.org citations, and clean Quartz output.

Coverage highlights:

• 35+ concept pages: Bitcoin protocol, economics, privacy, security,
  Lightning Network, governance, and cypherpunk precursors
• 12 entity pages: Satoshi Nakamoto, Hal Finney, Nick Szabo, Adam Back,
  David Chaum, and more
• Major series: Gradually Then Suddenly (17 parts), Discovering Bitcoin,
  Genesis Files, Silk Road, OXT Research, Bitcoin Astronomy
• 8 book summaries: Inventing Bitcoin, The Fiat Standard, The Blocksize War,
  The Sovereign Individual, and more
• Practice guides: buying, storage, running a node, Lightning tools,
  privacy practice

English wiki (wiki-en/) — structurally complete

76 pages mirroring the Russian layer. Full enhancement pass is the next
milestone (see roadmap below).

Site infrastructure

• Published via Quartz 4.x at wiki.21ideas.org
• Sitemap, RSS feed, canonical links, per-page JSON-LD (schema.org)
• robots.txt and llms.txt for search engine and AI crawler optimization
• Bilingual routing: /en/ and /ru/ paths
• Mechanical lint CLI (tools/lint.py) — both layers pass at 0 issues

Roadmap

• wiki-en/ full enhancement pass (canonical frontmatter, wikilinks,
  body style fixes)
• New concept pages: KYC, Fees, Wallet, CoinJoin, MuSig2, and more
  (see WIKI-BACKLOG.md)
• Raw source coverage gaps: ~40 unprocessed files in raw/Theory/
  and raw/Practice/
• EN/RU parity for remaining slugs

Contributing

Contributions welcome — see CONTRIBUTING.md for the
full workflow including AI-assisted ingest with Claude Code, Cursor, or
Gemini CLI.

Support

⚡️ Found the project useful? Zap Tony a coffee.

---

Built as part of the 21ideas Bitcoin education project.

v0.5.0 — Bilingual enhancement standard & publish readiness

Summary

This release focuses on maintainer tooling and navigation/docs: the single-page enhancement playbook works for both English and Russian wiki layers, Russian hub pages are aligned with the current vault, and the first English page has been brought up to the same structural standard as the Russian references. The project is in shape to build with Quartz and deploy to GitHub Pages (e.g. wiki.21ideas.org).

Highlights

Page enhancement (EN + RU)

• docs/PAGE-ENHANCEMENT-STANDARD.md is now language-neutral: one prompt for wiki-en/ and wiki-ru/, with conditional glossary sweeps and bilingual citation labels (Source: / Основа:).
• Task 0 documents wiki-en legacy antipatterns (singular source:, block YAML sources, body # titles, --- rules, raw/ in body, ## Related Terms, broken ]]] links, wrong wikilink prefixes, missing reviewed:, etc.) so the first EN pass is predictable.

English wiki (pilot)

• wiki-en/concepts/address-types.md enhanced as a reference implementation: canonical frontmatter, [[en/...]] links, ## Sources / ## Related pages, no duplicate Quartz title or horizontal rules in the body.

Russian wiki (hubs)

• wiki-ru/index.md: Концепции now lists bitcoin-core, bitcoin-node, censorship-resistance, third-parties (pages that already existed).
• wiki-ru/overview.md: updated folder counts (e.g. 35 concepts, 12 entities), extra reading paths (philosophy/topics, privacy, node, blocksize war, Lightning concept), expanded related links.

Documentation

• README.md: corrected wiki-ru content-page count wording (exclude only index, overview, glossary under wiki-ru/ — not log, which lives under docs/).

For maintainers

• Operational log: docs/log.md (bilingual).
• After upgrade: use @docs/PAGE-ENHANCEMENT-STANDARD.md in enhance prompts for either language.

Upgrade notes

• No breaking changes to vault layout or raw/ policy.
• Further wiki-en/ enhancement is incremental; this release does not claim full EN parity with wiki-ru/.

---

Full changelog: see docs/log.md (entries around 2026-04-10 — 2026-04-11).

v0.4.0 — Russian wiki standardized + lint tooling

Highlights

• wiki-ru/ — Full enhancement pass: schema-aligned frontmatter, [[ru/...]] links, inline sources, allowlist tags, reviewed, no spurious body # / --- where applicable. Mechanical lint is clean for wiki-ru/ (python3 tools/lint.py --layer ru).
• tools/lint.py — New stdlib-only linter for wiki-en/ and wiki-ru/ (wikilinks, sources: shape, tags, body rules, etc.); supports --write-report, strict exit codes.
• Docs — CLAUDE.md, README.md, docs/WIKI-GUIDE.md updated for lint workflow; docs/lint-report.md is the generated English report (scope = last --write-report run).

Notes

• wiki-en/ is not fully brought to the same bar yet; --layer both will still surface EN findings until a future milestone.
• Human review still covers orphans, index.md coverage, and content parity (see lint report “Suggested follow-ups”).

v0.3.0 — Agent Rulebook Overhaul + Docs Reorganisation

Agent configuration

• CLAUDE.md completely rewritten: now a tight, project-specific rulebook
  with a directory map, numbered operation checklists (Ingest / Enhance / Lint / Query),
  wikilink discipline table, and a "What agents must NOT do" section at the top.
  Generic LLM-wiki boilerplate removed.
• New rule: No # heading in page body — Quartz uses frontmatter title.
• New rule: sources: field standardised to inline array format.
• PAGE-ENHANCEMENT-STANDARD.md critical fix: the old "keep one # heading for SEO"
  instruction (which contradicted Quartz rendering) is now corrected.

Docs reorganisation

• All maintenance docs moved from repo root → docs/:
  WIKI-GUIDE.md, PAGE-ENHANCEMENT-STANDARD.md, WIKI-BACKLOG.md,
  log.md, lint-report.md
• GEMINI.md removed (redundant with CLAUDE.md)
• WIKI-GUIDE.md and README.md now include an agent prompt patterns table
  (Ingest / Enhance / Lint / Query with example prompts)
• WIKI-BACKLOG.md populated with ~35 uncovered raw/ slugs and EN/RU inconsistency flags

Wiki content

• Full enhancement pass on all 12 wiki-ru/entities pages
• Partial enhancement pass on 5 wiki-ru/concepts pages (security, segwit, taproot, third-parties, utxo)

v0.2.0 — Foundational concepts and cypherpunk entities complete

What's new in v0.2.0

• Batch 3 completed — 20 new bilingual pages (10 EN + 10 RU)
  • Concepts: bitcoin-whitepaper, aml, b-money, bit-gold, rpow
  • Entities: adam-back, tim-may, eric-hughes, david-chaum, phil-zimmermann
• All pages follow consistent frontmatter, tags, and wikilink discipline ([[en/...]] / [[ru/...]])
• Indexes and log updated

The 21ideas Bitcoin Wiki now has comprehensive coverage of core concepts, protocol elements, historical precursors, and key cypherpunk figures in both English and Russian.

Previous releases

• v0.1.3 — Bilingual wikilink architecture
• v0.1.2 — Full Russian mirror

Next step: Final Quartz deployment with language switcher.

Built as part of the 21ideas Bitcoin education project.

v0.1.3 — Proper bilingual wikilinks + lint rules

What's new in v0.1.3

• Fixed wikilink architecture for bilingual vault
  All pages in wiki-ru/ now use explicit [[wiki-ru/...]] prefixes → links work correctly for Russian readers in Obsidian (no more resolution to English pages).
• Improved bilingual lint rules in CLAUDE.md and GEMINI.md
  Clear, defensive rules prevent future link drift between languages.
• Full lint run completed — zero broken links, consistent frontmatter, and clean separation between EN and RU layers.
• New TODOs file with vague notes on what needs to be done.

The wiki is now fully bilingual-ready for Quartz deployment.

Previous releases

• v0.1.2 — Full Russian mirror
• v0.1.1 — Trust markers & synthesis showcase

Built as part of the 21ideas Bitcoin education project.

v0.1.2 — Added trust markers, source URLs and synthesis showcase

What's new in v0.1.2

• Added trust markers to all 53 wiki pages (YAML frontmatter now includes quality:, sources:, synthesized_date:, and completeness:)
• Automatically pulled real original source URLs from raw/ frontmatter for 18 key pages (links back to 21ideas.org)
• Enhanced concepts/cantillon-effect.md as a concrete showcase of the LLM Wiki synthesis process (shows how multiple sources are reconciled)
• Updated README.md and WIKI-GUIDE.md for clarity

The wiki is now more transparent, credible, and ready for public Quartz deployment + Russian mirror.

Full details: See WIKI-GUIDE.md

---

Previous release: v0.1.0

Built as part of the 21ideas Bitcoin education project.

v0.1.0 — Initial Release of 21ideas Bitcoin Wiki

21ideas Bitcoin Wiki — Initial Public Release (v0.1.0)

We have just open-sourced the 21ideas Bitcoin Wiki — a living, AI-assisted knowledge base built from 100+ articles and 10 foundational books curated on 21ideas.org.

What’s included

• 54 synthesized wiki pages with consistent YAML frontmatter
• Dense internal linking (~400–450 wikilinks) for easy navigation
• Full glossary integration and cross-references between concepts, books, series, and history
• Clean separation between immutable raw/ sources and the wiki/ synthesis layer
• Ready for Obsidian (graph view shines here) and Quartz publishing

Key Features

• Persistent, compounding knowledge layer (very different from ephemeral RAG)
• Grounded in high-quality 21ideas.org materials
• Agent-friendly structure — easy to extend with new sources
• Multilingual foundation (English synthesis complete, Russian mirror coming soon)

The wiki is now public on GitHub and will soon be available as a browsable website at wiki.21ideas.org.

How to get started

• Clone the repo and open in Obsidian for the best experience
• Query it with your favorite LLM agent
• Follow the instructions in WIKI-GUIDE.md

This is just the beginning. The wiki will continue to grow as new material is added and as we deploy the public site with search and a simple AI chatbot.

Feedback, suggestions, and contributions are very welcome!

Built with care as part of the 21ideas Bitcoin education project.

— Tony