21wiki – Bitcoin Wikipedia by 21ideas

A bilingual, AI-assisted, human-curated Bitcoin knowledge base built from Bitcoin-only source material, anchored in 21ideas.org.

This repo contains two first-class wiki layers:

• English wiki: wiki-en/ — synthesized from Russian raw/ sources into English
• Russian wiki: wiki-ru/ — a parallel, source-grounded Russian wiki (not a translation of the English pages)

Both layers follow strict conventions: required YAML frontmatter (trust markers), consistent tags, and bilingual wikilink discipline. Full schema and rules: CLAUDE.md (repo root).

Visual tour

Interlinked Bitcoin knowledge base in Obsidian Graph View

Every page includes strict YAML trust markers and provenance

Clean, navigable overview with bilingual discipline

Repository Structure

• Source library: raw/ — immutable markdown sources from 21ideas.org and other Bitcoin-only sources (layout: raw/README.md)
• English wiki: wiki-en/ — 76 markdown pages total (73 content pages excluding index/overview + glossary). Operational changelog: docs/log.md (covers EN + RU).
• Russian wiki: wiki-ru/ — 76 markdown pages total (73 content pages excluding index, overview + glossary)

Coverage includes core Bitcoin concepts (protocol + economics), key protocol elements (PoW, mining, difficulty, forks, mempool, BIPs, etc.), cypherpunk history (Genesis Files + manifestos), and key entities.

Documentation (docs/)

File	Role
docs/WIKI-GUIDE.md	Reader and maintainer guide — includes agent prompt patterns
docs/PAGE-ENHANCEMENT-STANDARD.md	Superseded by ENHANCE-SKILL.md — kept for historical reference
docs/INGEST-SKILL.md	Raw source ingestion workflow — agent prompt + contributor template
docs/WIKI-SKILL.md	Wiki page generation — new ingest (Mode A) and update (Mode B)
docs/ENHANCE-SKILL.md	Single-page polish skill — replaces PAGE-ENHANCEMENT-STANDARD.md
docs/link-map-en.md	Generated wikilink map for wiki-en/ — do not edit manually
docs/link-map-ru.md	Generated wikilink map for wiki-ru/ — do not edit manually
docs/WIKI-BACKLOG.md	Short-lived backlog scratchpad
docs/log.md	Append-only bilingual operations log
docs/lint-report.md	Mechanical lint summary (English); overwritten by the last --write-report run
raw/README.md	raw directory structure

Mechanical lint (tools/lint.py)

From the repo root, run python3 tools/lint.py (stdlib only). Common flags: --layer en|ru|both, --write-report (overwrites docs/lint-report.md), --strict / --strict-links (non-zero exit for CI). Full checklist and agent workflow: CLAUDE.md → Lint. For raw source ingestion, see docs/INGEST-SKILL.md and the helper scripts in tools/ (check_duplicate.py, derive_slug.py, check_series.py, build_link_map.py, check_parity.py).

How to use

• Open in Obsidian: clone the repo and open it as a vault.
  • Start here:
    • wiki-en/index.md
    • wiki-ru/index.md
• Navigate by topic: use wiki-en/overview.md / wiki-ru/overview.md, then follow links.
• Verify provenance: every page contains trust markers (quality, completeness, synthesis date, and sources when available).

Working with the agent

CLAUDE.md is loaded automatically in every Cursor session — no @mention needed. Common prompts:

Task	Prompt
Ingest a source	"Ingest raw/Theory/protocol/musig2.md into both wiki layers"
Enhance a page	"Enhance wiki-ru/concepts/mempool.md @docs/ENHANCE-SKILL.md"
Full lint	"Run a full bilingual lint on both wiki-en/ and wiki-ru/" (agent runs python3 tools/lint.py --layer both --write-report and updates docs/log.md)
Targeted lint (RU)	"Run a targeted lint on wiki-ru/" (e.g. --layer ru --write-report)

See docs/WIKI-GUIDE.md for the full prompt patterns table and notes on when to use each.

How to ingest (manual)

1. Add new source markdown under the right subtree in raw/ (see raw/README.md). Treat raw/ files as read-only — never edit them to patch the wiki.
2. Run an ingest prompt (see above). The agent creates or updates pages in wiki-en/ and wiki-ru/, refreshes both index.md files, and appends a dated entry to docs/log.md.

For bilingual health checks, run a lint prompt: the agent should execute python3 tools/lint.py with the right --layer and --write-report, then append docs/log.md. The report file is English (paths and quoted vault snippets may contain Russian).

Contributing / maintaining

• Rules of the project live in CLAUDE.md (frontmatter schema, tag allowlist, wikilink discipline, operation checklists).
• Per-page polish workflow: use docs/PAGE-ENHANCEMENT-STANDARD.md when standardizing a single page. Always include @docs/PAGE-ENHANCEMENT-STANDARD.md in your enhance prompt.
• Notable maintenance passes are recorded in docs/log.md (covers both EN and RU).

Feel free to open issues or PRs if you spot gaps or want to contribute new syntheses. The wiki is designed to be agent-friendly. This wiki is a work in progress and will keep evolving as new material is added. Built as part of the 21ideas Bitcoin education project.

License

This project is licensed under the MIT License — feel free to fork, use, and build upon it.

Support

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