Schema

This file documents the conventions of the vault. Update it whenever you change a convention.

Three-layer architecture (Karpathy)

1. raw/ — immutable source material. Links, fetched articles, transcripts, official documentation excerpts. Never edited after capture; if a source changes, add a new dated copy.
2. wiki/ — synthesized markdown notes. The actual learning material. Everything in wiki/ should cross-reference relevant raw sources.
3. schema.md / index.md / log.md — the spine. Conventions, catalog, chronological log.

Folder rules

• wiki/101/ — Beginner. Claude basics, claude.ai usage, prompting fundamentals, model selection.
• wiki/201/ — Intermediate. API, MCP, Claude Code, Skills, Subagents, Bedrock.
• wiki/301/ — Advanced / certification. CCA-F exam domains, scenarios, study plan, cheat sheets.
• raw/ — Flat. Filenames are dated like 2026-05-28-cca-domains.md.
• daily/ — YYYY-MM-DD.md daily notes.

Frontmatter

Every wiki note has frontmatter:

---
title: <human title>
level: 101 | 201 | 301
domain: agents | tools-mcp | claude-code | prompting | context-reliability | api | general
tags: [#level/201, #domain/api, ...]
related: other-note, another-note
sources: 2026-05-28-source.md
updated: 2026-05-28
---

Linking conventions

• Use wikilinks for internal notes.
• Use full URLs only for external resources (cited in sources: frontmatter or inline).
• Every cert-related concept should link back to the relevant 301 domain note.

Log format

log.md is append-only. Entry format:

## [YYYY-MM-DD] kind | Title — one-line note

kind is one of: ingest, synth, cheat, daily, meta.

Tag taxonomy

Level

• #level/101 — foundational
• #level/201 — intermediate (most certification prep material)
• #level/301 — advanced / cert-specific

Domain (CCA-F)

• #domain/agents — agentic architecture & orchestration (27%)
• #domain/tools-mcp — tool design & MCP (18%)
• #domain/claude-code — Claude Code config & workflows (20%)
• #domain/prompting — prompt engineering & structured output (20%)
• #domain/context-reliability — context management & reliability (15%)

Scenario (CCA-F)

• #scenario/support — customer support agent
• #scenario/code-gen — code generation with Claude Code
• #scenario/research — multi-agent research
• #scenario/dev-tools — developer productivity tools
• #scenario/cicd — Claude Code in CI/CD
• #scenario/extraction — structured data extraction

Kind

• #raw — captured source material
• #wiki — synthesized note
• #cheatsheet — quick-reference
• #playbook — scenario walkthrough