Skip to content

CLAUDE.md

Latest commit

 

History

History
74 lines (61 loc) · 3.35 KB

CLAUDE.md

File metadata and controls

74 lines (61 loc) · 3.35 KB
Raw

stt-research: LLM Wiki

Mode: E (Research) + B (Repository) hybrid Purpose: Track speech-to-text models, desktop ASR architectures, and the recording app I'm building. Owner: Paul Day Created: 2026-05-09

Structure

vault/
├── .raw/                      # immutable source documents (papers, transcripts, dumps)
├── wiki/
│   ├── index.md               # master catalog
│   ├── log.md                 # operations log (append at top)
│   ├── hot.md                 # 500-word hot cache
│   ├── overview.md            # executive summary
│   ├── sources/               # one summary per .raw source
│   ├── papers/                # research papers, model reports, technical write-ups
│   ├── models/                # speech-to-text models tracked (Whisper, Parakeet, Granite, Voxtral, ...)
│   ├── concepts/              # ASR/STT concepts and patterns
│   ├── entities/              # orgs, products, libraries, repos, people
│   ├── domains/               # top-level topic areas
│   ├── architecture/          # recording-app architecture (Mode B slice)
│   │   ├── modules/           # per-module notes
│   │   ├── decisions/         # ADRs
│   │   └── flows/             # data flows, request paths
│   ├── comparisons/           # side-by-side analyses
│   ├── gaps/                  # open questions, contradictions
│   ├── questions/             # filed answers to past queries
│   ├── _templates/            # frontmatter templates per type
│   └── meta/                  # dashboards, lint reports, conventions
└── CLAUDE.md

The data/ folder contains pre-existing research material. Move items into .raw/ as you ingest them.

Conventions

  • All notes use YAML frontmatter: type, title, status, created, updated, tags (minimum)
  • Wikilinks use [[Note Name]] format — filenames are unique, no paths needed
  • .raw/ contains source documents — never modify them
  • wiki/index.md is the master catalog — update on every ingest
  • wiki/log.md is append-only — never edit past entries; new entries go at the TOP
  • wiki/hot.md is overwritten in full after every significant operation (~500 words)

Operations

  • Ingest: drop source in .raw/, say "ingest [filename]" → routes to wiki-ingest skill
  • Query: ask any question — Claude reads hot.md → index.md → drills in
  • Lint: say "lint the wiki" to run a health check
  • Save: say "save this" or /save to file the current chat as a wiki page
  • Research: say /autoresearch [topic] to run an autonomous research loop
  • Archive: move cold sources to .archive/ to keep .raw/ clean

Wiki Knowledge Base (for cross-project use)

Other Claude Code projects can reference this vault by adding to their CLAUDE.md:

## Wiki Knowledge Base
Path: ~/Code/stt-research

When you need context not already in this project:
1. Read wiki/hot.md first (recent context, ~500 words)
2. If not enough, read wiki/index.md (full catalog)
3. If you need domain specifics, read wiki/domains/<area>.md
4. Only then read individual wiki pages

Do NOT read the wiki for:
- General coding questions or language syntax
- Things already in this project's files or conversation
- Tasks unrelated to STT, ASR, or audio recording