3.3 KiB
3.3 KiB
Wiki Schema — Research Deep-Dive
Page Types
| Type | Directory | Purpose |
|---|---|---|
| entity | wiki/entities/ | Named things (people, tools, organizations, datasets) |
| concept | wiki/concepts/ | Ideas, techniques, phenomena, frameworks |
| source | wiki/sources/ | Papers, articles, talks, books, blog posts |
| query | wiki/queries/ | Open questions under active investigation |
| comparison | wiki/comparisons/ | Side-by-side analysis of related entities |
| synthesis | wiki/synthesis/ | Cross-cutting summaries and conclusions |
| overview | wiki/ | High-level project summary (one per project) |
| thesis | wiki/thesis/ | Working hypothesis and its evolution over time |
| methodology | wiki/methodology/ | Research methods, protocols, and study designs |
| finding | wiki/findings/ | Individual empirical results or observations |
Naming Conventions
- Files:
kebab-case.md - Entities: match official name where possible (e.g.,
openai.md,gpt-4.md) - Concepts: descriptive noun phrases (e.g.,
chain-of-thought.md) - Sources:
author-year-slug.md(e.g.,wei-2022-cot.md) - Queries: question as slug (e.g.,
does-scale-improve-reasoning.md) - Theses: hypothesis as slug (e.g.,
scaling-improves-reasoning.md) - Methodologies: method name (e.g.,
systematic-review.md,ablation-study.md) - Findings: descriptive slug (e.g.,
larger-models-better-few-shot.md)
Frontmatter
All pages must include YAML frontmatter:
---
type: entity | concept | source | query | comparison | synthesis | overview
title: Human-readable title
tags: []
related: []
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
Source pages also include:
authors: []
year: YYYY
url: ""
venue: ""
Thesis pages also include:
confidence: low | medium | high
status: speculative | supported | refuted | settled
Finding pages also include:
source: "[[source-slug]]"
confidence: low | medium | high
replicated: true | false | null
Index Format
wiki/index.md lists all pages grouped by type. Each entry:
- [[page-slug]] — one-line description
Log Format
wiki/log.md records activity in reverse chronological order:
## YYYY-MM-DD
- Action taken / finding noted
Cross-referencing Rules
- Use
[[page-slug]]syntax to link between wiki pages - Every entity and concept should appear in
wiki/index.md - Queries link to the sources and concepts they draw on
- Synthesis pages cite all contributing sources via
related: - Findings link back to their source via the
source:frontmatter field - Thesis pages reference supporting and refuting findings via
related: - Methodology pages are cited by the findings that used them
Contradiction Handling
When sources contradict each other:
- Note the contradiction in the relevant concept or entity page
- Create or update a query page to track the open question
- Link both sources from the query page
- Resolve in a synthesis page once sufficient evidence exists
Research-Specific Conventions
- Keep the thesis pages updated as evidence accumulates — they are living documents
- Every finding should assess replication status when known
- Methodology pages explain the why (rationale) not just the how
- Distinguish between direct evidence and inference in finding pages