references/knowledge-map.md
Evidence-Centered Knowledge Map
Use this reference for map mode. A useful map preserves reasoning, not just headings.
Node Types
THESIS: the central claim or explanatory model.CLAIM: a supporting or opposing proposition.REASON: a logical bridge between claims.EVIDENCE: an observation, quotation, record, or study.DATA: numerical evidence with unit, population, period, and baseline.EXAMPLE: an illustration that does not by itself establish generality.CONCEPT: a term whose definition matters to the argument.ASSUMPTION: an unstated premise.COUNTERARGUMENT: an alternative conclusion or explanation.LIMITATION: a boundary on scope or confidence.QUESTION: an unresolved issue or retrieval prompt.
Edge Labels
Every edge must use a meaningful label: supports, explains, defines, illustrates, depends on, qualifies, contradicts, or raises.
Never use unlabeled proximity as a substitute for a relationship.
Required Metadata
For evidence and data nodes, include:
- source location;
- the claim they connect to;
- confidence label;
- missing context or caveat.
Markdown Output
THESIS: [central claim]
├── supports → CLAIM: [supporting claim]
│ ├── because → REASON: [logical bridge]
│ ├── supports → EVIDENCE: [evidence] ([location])
│ └── qualifies → LIMITATION: [boundary]
├── depends on → ASSUMPTION: [unstated premise]
└── contradicted by → COUNTERARGUMENT: [strong alternative]
When the user requests FreeMind or XMind-compatible output, render the same hierarchy as valid FreeMind XML and escape all source-derived text used in XML attributes.
Quality Check
Before delivering the map, verify:
- Every major claim connects to the thesis.
- Every evidence node connects to a specific claim.
- Examples are labeled as examples.
- Contradictions and limitations remain visible.
- The map contains no conclusion that exists only because of layout.
Sources
- Novak, J. D. & Cañas, A. J. — "The Theory Underlying Concept Maps and How to Construct and Use Them" (IHMC CmapTools Technical Report, 2008) — the concept-mapping method this map structure derives from.
- Toulmin, S. — The Uses of Argument (1958) — claim / grounds / warrant decomposition mirrored by the claim–reason–evidence fields.
- Ahrens, S. — How to Take Smart Notes (2017) — atomic, linked notes as durable knowledge structure.
- Adler, M. J. & Van Doren, C. — How to Read a Book (1972) — syntopical reading: mapping how multiple sources answer the same question.
- Weinstein, Y., Madan, C. R. & Sumeracki, M. A. — "Teaching the Science of Learning", Cognitive Research 3 (2018) — elaboration and concrete-example strategies encoded in the map's link labels.
- Hattie, J. & Donoghue, G. M. — "Learning Strategies: A Synthesis and Conceptual Model", npj Science of Learning 1 (2016) — where organization/mapping strategies help in the acquisition→consolidation cycle.