-
Notifications
You must be signed in to change notification settings - Fork 0
2026 05 02 knowledge gap tracking promotion patterns pkm
What structured knowledge-gap tracking and automatic backlog-promotion patterns exist in Personal Knowledge Management (PKM) and research systems, and which design is most suitable for a YAML Ain't Markup Language (YAML) frontmatter file-based corpus?
What structured knowledge-gap tracking and automatic backlog-promotion patterns exist in Personal Knowledge Management (PKM) systems (linked-note methods such as Zettelkasten, Obsidian, Roam Research, Logseq) and academic research management tools, how do they handle unresolved questions that recur across multiple notes or papers, and which design, specifically for a YAML frontmatter field in a file-based Markdown corpus with a Python aggregation script, provides the best balance between structured data quality, minimal agent overhead, and reliable automatic promotion of persistently unresolved gaps into new research backlog items?
In scope:
- PKM systems: linked-note methods such as Zettelkasten, plus Obsidian, Roam Research, and Logseq, specifically how each handles open questions, unanswered notes, and recurring gaps
- Academic research management: how systematic review tools and evidence-synthesis frameworks record evidence gaps, uncertainty, and future research implications
- Knowledge gap aggregation design patterns: deduplication strategies, occurrence counting, and promotion thresholds
- YAML field design: what fields best capture a gap, and how to balance expressiveness with aggregation reliability
- Aggregation script design: how to read gap fields from frontmatter, deduplicate, count occurrences, and write a structured
gap_registry.jsonJavaScript Object Notation (JSON) registry file - Failure modes: sparse or low-quality gap strings that defeat deduplication, over-promotion of trivially similar gaps, and agent overhead that discourages gap tracking
Out of scope:
- Full-text semantic gap extraction from body text
- Gap tracking in non-file-based systems that require a persistent database
- Automated execution of gap research after promotion
Constraints:
- Expand all acronyms on first use
- The design must work with Python 3.11+ and standard library plus YAML parsing; no external database or vector index required
- The YAML field must be writable by a Large Language Model (LLM) agent with a simple instruction such as "list 1-5 open questions this item could not answer"
W-0040 in BACKLOG.md proposes a gaps: YAML frontmatter field, an aggregate_gaps.py script, and automatic promotion of gaps appearing in three or more items. [fact; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
The design choice matters because prior completed items in this repository already favor explicit provenance, heuristic-first aggregation, and layered selection over opaque whole-corpus inference. [fact; source: https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-03-03-cross-item-synthesis-meta-insights.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md]
This item therefore asks a narrower implementation question: what is the lightest structured gap format that still scales beyond ad hoc note-level reminders and can reliably promote recurring unresolved questions into backlog items. [inference; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-03-03-cross-item-synthesis-meta-insights.md]
- PKM system survey: Review Zettelkasten, Obsidian, Roam Research, and Logseq patterns for surfacing recurring open questions and the data structure each pattern relies on.
- Academic research gap tracking review: Review systematic review and evidence-synthesis guidance to see how evidence gaps and future research implications are structured.
- YAML field design options: Compare free-text string lists, controlled vocabularies, and lightweight structured objects for LLM writeability and aggregation reliability.
- Deduplication strategy evaluation: Compare exact matching, fuzzy string similarity, and embedding-based semantic similarity for short gap questions in a roughly 200-item file corpus.
- Promotion threshold analysis: Compare threshold options and recommend the smallest threshold that avoids promoting one-off paraphrase noise.
- Design recommendation: Produce a concrete frontmatter schema, registry schema, aggregation logic, and promotion rule.
- Ahrens (2017) How to Take Smart Notes
- Sascha (2025) Universal Questions for Any Note-Taking System
- Sascha (2018) Structural Layers in Note Taking
- Blacksmithgu Dataview Documentation
- Blacksmithgu Dataview Data Commands
- Blacksmithgu Dataview Query Types
- Logseq Advanced Queries Documentation - official page is JavaScript-rendered and was not directly quotable in this session
- Logseq Datalog Documentation - official page is JavaScript-rendered and was not directly quotable in this session
- Covidence Systematic Review Software
- Schunemann et al. (2024) Cochrane Handbook Chapter 14: Completing Summary of Findings tables and grading the certainty of the evidence
- Schunemann et al. (2024) Cochrane Handbook Chapter 15: Interpreting results and drawing conclusions
- Grading of Recommendations Assessment, Development and Evaluation (GRADE) Working Group Handbook
- Rayyan Help: How to Add or Remove Labels and Exclusion Reasons in Rayyan - official help page returned a Cloudflare interstitial in this session
- Rayyan Help: Understanding Blinding, Labels, Reasons, and Ratings in Collaborative Reviews - official help page returned a Cloudflare interstitial in this session
- Zotero Documentation: Collections and Tags
- Zotero Documentation: Searching and Saved Searches
- RapidFuzz Documentation
- Sentence Transformers Semantic Textual Similarity
- NVIDIA NeMo Semantic Deduplication
(Full output from running the research skill, retained verbatim in the completed item. Sections 0-5 are the investigation, and section 6 seeds the Findings section below.)
- Question: determine which structured gap-tracking pattern from PKM and research systems best fits a YAML frontmatter corpus with file-based aggregation
- Scope: PKM patterns, systematic-review gap handling, field design, deduplication strategy, promotion threshold, and script design are in scope; full-text extraction and database-backed systems are out of scope
- Constraints: Python 3.11+, file-based operation, YAML-only authoring, low agent overhead, and no vector index as a baseline
- Output format: knowledge output with a concrete frontmatter schema, registry schema, aggregation logic, and promotion rule
- [fact] Prior work cross-reference: W-0040 already defines the desired capability, while prior repository research argues for explicit provenance and heuristic-first aggregation rather than opaque whole-corpus inference. [source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-03-03-cross-item-synthesis-meta-insights.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md]
A. PKM patterns
- A1. How do mature PKM systems surface unresolved questions across many notes?
- A2. What data structures do those systems rely on: tags, metadata fields, tasks, block references, or structure notes?
- A3. What scaling limits appear when open questions are left as free text only?
B. Academic review patterns
- B1. How do systematic review frameworks represent uncertainty and future research needs?
- B2. What is structured versus free-form in those systems?
- B3. Do they prioritize gaps by recurrence or by decision relevance?
C. Field design
- C1. Is a free-text list sufficient for reliable aggregation?
- C2. Is a controlled vocabulary too costly for agents and humans?
- C3. What is the minimum structured object that materially improves deduplication?
D. Deduplication
- D1. What does exact matching do well and poorly?
- D2. What does fuzzy string matching do well and poorly?
- D3. What does embedding-based semantic matching require operationally?
E. Promotion
- E1. What threshold is high enough to avoid two-item noise?
- E2. What threshold is low enough to surface real recurring gaps before the corpus is much larger?
F. Recommendation
- F1. What frontmatter schema should this repository adopt now?
- F2. What registry schema should the script emit?
- F3. What matching and promotion policy is the best first implementation?
- [fact] Zettelkasten practice on zettelkasten.de treats long-run note systems as future-oriented tools that need explicit entry points rather than retrieval alone, and warns that tags do not scale well because they dilute connections as note volume grows. [source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/]
- [fact] The same Zettelkasten guidance says direct links with explanations and topic entry points are more durable than a growing undifferentiated tag cloud. [source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/]
- [fact] The structural-layers article says full-text search and tags are sufficient only for a smaller archive, after which hub notes and then structure notes emerge to organize recurring themes. [source: https://zettelkasten.de/posts/three-layers-structure-zettelkasten/]
- [fact] Obsidian Dataview is a live index and query engine over note metadata, including YAML frontmatter, inline fields, tags, tasks, and links, and it keeps queries automatically up to date. [source: https://blacksmithgu.github.io/obsidian-dataview/]
- [fact] Dataview query commands can select notes by tag, folder, or link, and task queries operate at task level rather than only at page level. [source: https://blacksmithgu.github.io/obsidian-dataview/queries/data-commands/; https://blacksmithgu.github.io/obsidian-dataview/queries/query-types/#task]
- [inference] The strongest PKM pattern is not "infer open questions from prose later" but "capture open questions in a queryable surface now, then use dynamic queries or structure notes to surface them later." [source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://blacksmithgu.github.io/obsidian-dataview/]
- [assumption] Access note: the official Logseq advanced-query pages were JavaScript-rendered in this session, so Logseq is treated as a supporting pattern rather than an anchor source. The raw exported page still exposed a Datalog-style block model with
block/tagsandblock/refs, which is directionally consistent with block-level query patterns. [source: https://docs.logseq.com/#/page/Advanced%20Queries; https://docs.logseq.com/#/page/datalog]
- [inference] Covidence presents itself as a collaborative systematic review platform optimized for faster reviews and distributed review-team workflow, and its public marketing surface emphasizes workflow management rather than exposing a fine-grained public gap schema. [source: https://www.covidence.org/]
- [fact] Cochrane Chapter 14 states that Summary of Findings tables present the main findings of a review in a transparent, structured, and simple tabular format, including important outcomes and certainty of evidence. [source: https://training.cochrane.org/handbook/current/chapter-14]
- [fact] Cochrane Chapter 15 states that reviews inform future research and that author conclusions are explicitly divided into implications for practice and implications for research. [source: https://training.cochrane.org/handbook/current/chapter-15]
- [fact] The GRADE handbook describes GRADE outputs as evidence summaries plus graded recommendations built on a transparent, structured assessment of certainty. [source: https://gdt.gradepro.org/app/handbook/handbook.html]
- [fact] Zotero supports detailed item tags, collections, and continuously updated saved searches, including searches across tags and note text. [source: https://www.zotero.org/support/collections_and_tags; https://www.zotero.org/support/searching]
- [inference] Academic review systems separate two layers: structured evidence judgments that are easy to aggregate, and narrative interpretation that explains them. They do not depend on semantic clustering of arbitrary prose as the primary control surface. [source: https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15; https://gdt.gradepro.org/app/handbook/handbook.html; https://www.zotero.org/support/searching]
- [assumption] Access note: Rayyan's official help center URLs were behind a Cloudflare challenge in this session, so Rayyan is not used as an anchor source for the recommendation. [source: https://help.rayyan.ai/hc/en-us/articles/16759720118929-How-to-Add-or-Remove-Labels-and-Exclusion-Reasons-in-Rayyan; https://help.rayyan.ai/hc/en-us/articles/35305653554705-Understanding-Blinding-Labels-Reasons-and-Ratings-in-Collaborative-Reviews]
- [fact] RapidFuzz documents practical fuzzy string scorers such as ratio, token sort ratio, token set ratio, and weighted ratio, and notes that preprocessing materially affects similarity scores. [source: https://github.com/maxbachmann/RapidFuzz]
- [fact] RapidFuzz's token set ratio returns a perfect score when one string is a subset of another, which is useful for formatting variants but risky for over-merging questions that share a core phrase while differing in scope. [source: https://github.com/maxbachmann/RapidFuzz]
- [fact] Sentence Transformers semantic textual similarity computes embeddings for all texts and then compares them by cosine or other similarity metrics. [source: https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html]
- [fact] NVIDIA NeMo's semantic deduplication workflow requires embedding generation, clustering, within-cluster pairwise similarity, duplicate thresholds, representative selection, unique identifiers, and threshold experimentation. [source: https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html]
- [inference] Exact matching after lowercase and punctuation normalization is too brittle for LLM-authored questions, because semantically identical gaps often differ by leading phrasing, token order, or qualifier words. [source: https://github.com/maxbachmann/RapidFuzz; https://www.soenkeahrens.de/en/takesmartnotes]
- [inference] Embedding-based semantic deduplication is a heavier later-stage option for this repository because it introduces model selection, threshold tuning, clustering, and storage concerns, while the current repository question is a lightweight frontmatter-and-registry design rather than a new semantic infrastructure layer. [source: https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md]
- [inference] The practical middle ground is bounded fuzzy comparison inside a coarse area bucket, with normalized exact matching first and fuzzy consolidation second, so obvious paraphrases merge while unrelated questions on different surfaces remain separate. [source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html]
- [inference] Dataview and Zotero both favor fields and tags that remain easy to write and easy to query later, while Zettelkasten guidance warns that broad tags alone lose explanatory power as scale increases. [source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/collections_and_tags; https://zettelkasten.de/posts/universal-questions-for-note-taking-system/]
- [inference] A pure free-text list is easiest for agents but leaves the aggregator with no boundary signal, so near-duplicate questions about different domains can collapse incorrectly. [source: https://blacksmithgu.github.io/obsidian-dataview/; https://github.com/maxbachmann/RapidFuzz]
- [inference] A lightweight schema is a safer first design than a full controlled taxonomy, because the sources support queryable structure but do not justify adding a richer classification burden to the closing workflow. [source: https://www.zotero.org/support/collections_and_tags; https://training.cochrane.org/handbook/current/chapter-15; https://blacksmithgu.github.io/obsidian-dataview/]
- [inference] The best balance is a lightweight structured object with one required natural-language field and one optional coarse classifier drawn from existing canonical tags or a short area list. [source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/]
- [fact] W-0040 currently defines promotion when a gap appears in three or more completed items. [source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
- [inference] A threshold of two distinct items is too noisy for agent-authored gap text because two mentions can arise from one local topic cluster, one fashionable framing, or one paraphrase family rather than a corpus-level structural gap. [source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/maxbachmann/RapidFuzz]
- [assumption] A threshold of five distinct items would probably delay promotion more than this repository wants, but that judgment cannot be tested yet because the repository does not currently store historical structured gap data. [source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://training.cochrane.org/handbook/current/chapter-15]
- [inference] Three distinct completed items is the current implementation target in W-0040 and a defensible starting threshold, but it remains provisional until structured historical gap data exists for calibration. [source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://training.cochrane.org/handbook/current/chapter-15]
-
[inference] The repository should not try to reproduce academic evidence-taxonomy depth inside frontmatter. It should capture only the minimum data needed to aggregate and promote unanswered questions reliably. [source: https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15]
-
[inference] The recommended frontmatter shape is:
gaps: - question: "What benchmark best predicts long-horizon coding-agent reliability?" area: evaluation - question: "What minimum evidence package should justify production deployment?" area: governance
where
questionis required andareais optional but recommended. [source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/collections_and_tags; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md] -
[inference] The registry output should preserve both canonical and variant phrasing, for example
{canonical_question, area, variants, item_slugs, count, promote, backlog_slug}rather than overwriting all variants into one silent merge result. [source: https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md] -
[inference] Matching order should be: normalize exact match first, then compare only within the same
areabucket using a bounded fuzzy threshold, and leave low-confidence clusters separate rather than auto-merging them. [source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html] -
[inference] Embedding-based semantic deduplication is better treated as a later-stage option, to revisit only if structured questions plus bounded fuzzy matching still produce unacceptable false negatives at current corpus scale. [source: https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md]
- [inference] The consistent pattern across PKM and research-review tools is "capture explicitly, query later." Systems scale when the author records the unresolved question in a bounded field or note type, not when a later process tries to infer all unresolved questions from rich narrative prose. [source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching]
- [inference] This makes a pure free-text list too weak and a rich taxonomy too heavy. The gap field should be just structured enough to constrain matching, but not so structured that authors skip it or agents fill it poorly. [source: https://www.zotero.org/support/collections_and_tags; https://training.cochrane.org/handbook/current/chapter-15]
- [inference] Deduplication should follow the same principle as the rest of the repository's architecture: heuristics first, heavier semantic machinery later only if the simple layer proves inadequate. [source: https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html]
- [assumption] A short
areaclassifier can reuse the repository's existing canonical tag vocabulary or a small hand-maintained area list without introducing enough overhead to discourage capture. [source: https://github.com/davidamitchell/Research/blob/main/docs/tag-vocabulary.md; https://blacksmithgu.github.io/obsidian-dataview/]
- [inference] The PKM evidence and the academic-review evidence both favor explicit structure plus later aggregation rather than fully unstructured narrative capture. [source: https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://training.cochrane.org/handbook/current/chapter-14]
- [inference] The deduplication sources support a lighter first layer based on normalization and fuzzy comparison, while embedding pipelines add model, clustering, and threshold choices that make them operationally heavier. [source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html]
- [inference] The only material uncertainty is not whether structured gap capture is needed, but how much structure is the minimum that still reduces false merges. That is why the recommendation stops at
questionplus optionalarea, not a larger schema. [source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/collections_and_tags]
- [inference] From a technical lens, the recommended schema is intentionally small because file-based automation benefits from deterministic fields and low merge friction. A larger schema would produce more missing values, more agent inconsistency, and more review overhead than signal. [source: https://blacksmithgu.github.io/obsidian-dataview/; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
- [inference] From a behavioral lens, open-question capture succeeds only if it feels like a short closing step. Academic review methods tolerate richer schemas because the whole workflow is already structured and labor-intensive; this repository should not import that whole burden. [source: https://training.cochrane.org/handbook/current/chapter-15; https://www.covidence.org/]
- [inference] From an information-architecture lens, the role of the registry is closer to a structure note or saved search than to a semantic knowledge graph. It is an entry point for recurring unresolved questions, not a full ontology of uncertainty. [source: https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://www.zotero.org/support/searching]
- [inference] From a governance lens, a threshold of three promotes only repeated unresolved questions and leaves one-off uncertainties inside the item where they belong. That keeps the research backlog tied to repeated decision-value signals rather than to every local caveat. [source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://training.cochrane.org/handbook/current/chapter-15]
Executive Summary
The best-fit design is a lightweight structured gaps: field whose entries store a required natural-language question and an optional coarse area, aggregated by normalized exact matching first and bounded fuzzy matching second, with promotion to backlog at three distinct completed-item mentions. [inference; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
PKM systems and academic review methods converge on the same architectural lesson: recurring unknowns should be captured explicitly in a structured, queryable surface and then surfaced through dynamic aggregation, rather than inferred later from arbitrary prose. [inference; source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15]
Exact matching alone is too brittle for agent-authored question phrasing, while embedding-based semantic deduplication introduces model, clustering, and threshold complexity that is disproportionate to the repository's current lightweight file-based design target. [inference; source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
The result should behave more like a saved search or structure note than like a full semantic platform: capture only enough structure to keep recurring gaps legible, deduplicated, and promotable. [inference; source: https://www.zotero.org/support/searching; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/]
Key Findings
- The cited PKM approaches, especially Zettelkasten guidance and Obsidian Dataview, surface recurring open questions through explicit metadata, links, tasks, or structure notes rather than by depending on later semantic inference over free-form narrative prose. ([inference]; medium confidence; source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://blacksmithgu.github.io/obsidian-dataview/)
- Academic review frameworks separate structured evidence summaries from narrative interpretation, which means recurring uncertainty is made aggregatable by design before it becomes a research-priority conclusion. ([inference]; high confidence; source: https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15; https://gdt.gradepro.org/app/handbook/handbook.html)
-
A pure free-text
gaps:list is too weak for reliable automatic promotion because it gives the aggregator no boundary signal and forces all deduplication decisions onto unstable question phrasing alone. ([inference]; medium confidence; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/collections_and_tags; https://github.com/maxbachmann/RapidFuzz) - A lightweight schema is a safer first design than a full controlled taxonomy, because the sources support small queryable structures but do not justify adding a richer classification burden to the repository's closing workflow. ([inference]; medium confidence; source: https://www.zotero.org/support/collections_and_tags; https://training.cochrane.org/handbook/current/chapter-15; https://blacksmithgu.github.io/obsidian-dataview/)
-
The best current frontmatter design is a lightweight object with
questionrequired andareaoptional but recommended, because that is the smallest schema that materially improves grouping without turning gap capture into ontology work. ([inference]; medium confidence; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/) -
Normalized exact matching followed by bounded fuzzy comparison inside the same
areabucket is a reasonable first deduplication layer, because it addresses paraphrase brittleness without introducing the heavier operational stack documented for embedding-based semantic deduplication. ([inference]; low confidence; source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md) - Embedding-based semantic deduplication is a sensible later-stage option rather than the best first implementation for this repository, because the documented workflow requires embedding generation, clustering, threshold tuning, and model-choice governance while the current design target is a lightweight frontmatter-and-registry layer. ([inference]; medium confidence; source: https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md)
- Promotion at three distinct completed-item mentions is the current implementation target in W-0040, but it should be treated as a provisional starting threshold rather than as an empirically validated optimum until structured historical gap data exists. ([inference]; low confidence; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://training.cochrane.org/handbook/current/chapter-15)
Evidence Map
Assumptions
- [assumption] The optional
areafield can reuse existing canonical tags or a short hand-maintained area list without materially increasing capture burden. [source: https://github.com/davidamitchell/Research/blob/main/docs/tag-vocabulary.md; https://blacksmithgu.github.io/obsidian-dataview/] - [assumption] Leaving uncertain fuzzy matches unmerged is preferable to aggressive auto-merging, because backlog promotion errors are costlier than a small number of false negatives in the first implementation. [source: https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
Analysis
The evidence points toward a hybrid of PKM minimalism and systematic-review structure. [inference; source: https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://training.cochrane.org/handbook/current/chapter-14]
PKM tools show that recurring questions become useful when they are queryable and connected to entry points, while academic review methods show that uncertainty only becomes decision-useful when it is expressed in a structured summary layer rather than buried in narrative discussion. [inference; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://training.cochrane.org/handbook/current/chapter-15]
That combination rules out both extremes: free-text-only capture leaves too much ambiguity for reliable grouping, and a rich multi-field taxonomy would add classification overhead that the current evidence does not show this repository needs. [inference; source: https://www.zotero.org/support/collections_and_tags; https://blacksmithgu.github.io/obsidian-dataview/]
The matching trade-off is similar. Exact equality alone undercounts paraphrases, but embedding-based dedupe belongs to a heavier operational class with model, clustering, and threshold choices, and prior repository architecture work has already treated similar vector-style infrastructure as a later layer rather than as a baseline requirement. [inference; source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md]
The clean first implementation is therefore deterministic normalization plus bounded fuzzy comparison within area, variant preservation in the registry, and use of W-0040's three-mention promotion rule as a starting threshold that should be revisited once structured historical data exists. [inference; source: https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
Risks, gaps, uncertainties
- The recommendation relies more heavily on Cochrane, GRADE, and Zotero than on deep vendor-specific Rayyan and Covidence help documentation, so fine-grained product-behavior claims should be treated as medium-confidence extrapolations rather than as product-spec facts. [inference; source: https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15; https://gdt.gradepro.org/app/handbook/handbook.html; https://www.zotero.org/support/searching; https://www.covidence.org/]
- The exact fuzzy-threshold value still needs calibration against real repository examples because W-0040 has not yet produced a historical
gaps:dataset for threshold testing. [assumption; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/maxbachmann/RapidFuzz] - The recommendation assumes most gap strings will be short, well-formed questions rather than long paragraph fragments, because bounded fuzzy matching is safer on concise prompts than on long descriptive text. [assumption; source: https://github.com/maxbachmann/RapidFuzz; https://blacksmithgu.github.io/obsidian-dataview/]
- False-positive and false-negative rates cannot yet be quantified empirically because the repository does not currently store structured historical gap entries. [fact; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
Open Questions
- Should
areareuse canonical tags directly, or should W-0040 define a smaller area vocabulary dedicated to gap clustering? - Should the registry store a manual
canonical_questionoverride so reviewers can merge or split clusters without editing historical item frontmatter? - Should promoted gaps create backlog items automatically, or first mark
promote: trueand let the loop create the backlog item only after checking for an existing equivalent slug?
- Coverage audit: complete
- Claim-label audit: complete
- Acronym expansion audit: complete
- Inline citation audit: complete
- Synthesis and Findings parity: complete
- Material uncertainties: threshold calibration and incomplete vendor-help coverage remain explicit
The best-fit design is a lightweight structured gaps: field whose entries store a required natural-language question and an optional coarse area, aggregated by normalized exact matching first and bounded fuzzy matching second, with W-0040's three-mention rule treated as a provisional starting threshold. [inference; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
PKM systems and academic review methods converge on the same architectural lesson: recurring unknowns should be captured explicitly in a structured, queryable surface and then surfaced through dynamic aggregation, rather than inferred later from arbitrary prose. [inference; source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15]
Exact matching alone is too brittle for agent-authored question phrasing, while embedding-based semantic deduplication introduces model, clustering, and threshold complexity that is disproportionate to the repository's current lightweight file-based design target. [inference; source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
The result should behave more like a saved search or structure note than like a full semantic platform: capture only enough structure to keep recurring gaps legible, deduplicated, and promotable. [inference; source: https://www.zotero.org/support/searching; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/]
- The cited PKM approaches, especially Zettelkasten guidance and Obsidian Dataview, surface recurring open questions through explicit metadata, links, tasks, or structure notes rather than by depending on later semantic inference over free-form narrative prose. ([inference]; medium confidence; source: https://zettelkasten.de/posts/universal-questions-for-note-taking-system/; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://blacksmithgu.github.io/obsidian-dataview/)
- Academic review frameworks separate structured evidence summaries from narrative interpretation, which means recurring uncertainty is made aggregatable by design before it becomes a research-priority conclusion. ([inference]; high confidence; source: https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15; https://gdt.gradepro.org/app/handbook/handbook.html)
-
A pure free-text
gaps:list is too weak for reliable automatic promotion because it gives the aggregator no boundary signal and forces all deduplication decisions onto unstable question phrasing alone. ([inference]; medium confidence; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/collections_and_tags; https://github.com/maxbachmann/RapidFuzz) - A lightweight schema is a safer first design than a full controlled taxonomy, because the sources support small queryable structures but do not justify adding a richer classification burden to the repository's closing workflow. ([inference]; medium confidence; source: https://www.zotero.org/support/collections_and_tags; https://training.cochrane.org/handbook/current/chapter-15; https://blacksmithgu.github.io/obsidian-dataview/)
-
The best current frontmatter design is a lightweight object with
questionrequired andareaoptional but recommended, because that is the smallest schema that materially improves grouping without turning gap capture into ontology work. ([inference]; medium confidence; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://zettelkasten.de/posts/three-layers-structure-zettelkasten/) -
Normalized exact matching followed by bounded fuzzy comparison inside the same
areabucket is a reasonable first deduplication layer, because it addresses paraphrase brittleness without introducing the heavier operational stack documented for embedding-based semantic deduplication. ([inference]; low confidence; source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md) - Embedding-based semantic deduplication is a sensible later-stage option rather than the best first implementation for this repository, because the documented workflow requires embedding generation, clustering, threshold tuning, and model-choice governance while the current design target is a lightweight frontmatter-and-registry layer. ([inference]; medium confidence; source: https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md)
- Promotion at three distinct completed-item mentions is the current implementation target in W-0040, but it should be treated as a provisional starting threshold rather than as an empirically validated optimum until structured historical gap data exists. ([inference]; low confidence; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://training.cochrane.org/handbook/current/chapter-15)
- [assumption] The optional
areafield can reuse existing canonical tags or a short hand-maintained area list without materially increasing capture burden. [source: https://github.com/davidamitchell/Research/blob/main/docs/tag-vocabulary.md; https://blacksmithgu.github.io/obsidian-dataview/] - [assumption] Leaving uncertain fuzzy matches unmerged is preferable to aggressive auto-merging, because backlog promotion errors are costlier than a small number of false negatives in the first implementation. [source: https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
The evidence points toward a hybrid of PKM minimalism and systematic-review structure. [inference; source: https://zettelkasten.de/posts/three-layers-structure-zettelkasten/; https://training.cochrane.org/handbook/current/chapter-14]
PKM tools show that recurring questions become useful when they are queryable and connected to entry points, while academic review methods show that uncertainty only becomes decision-useful when it is expressed in a structured summary layer rather than buried in narrative discussion. [inference; source: https://blacksmithgu.github.io/obsidian-dataview/; https://www.zotero.org/support/searching; https://training.cochrane.org/handbook/current/chapter-15]
That combination rules out both extremes: free-text-only capture leaves too much ambiguity for reliable grouping, and a rich multi-field taxonomy would add classification overhead that the current evidence does not show this repository needs. [inference; source: https://www.zotero.org/support/collections_and_tags; https://blacksmithgu.github.io/obsidian-dataview/]
The matching trade-off is similar. Exact equality alone undercounts paraphrases, but embedding-based dedupe belongs to a heavier operational class with model, clustering, and threshold choices, and prior repository architecture work has already treated similar vector-style infrastructure as a later layer rather than as a baseline requirement. [inference; source: https://github.com/maxbachmann/RapidFuzz; https://docs.nvidia.com/nemo-framework/user-guide/25.07/datacuration/semdedup.html; https://www.sbert.net/docs/sentence_transformer/usage/semantic_textual_similarity.html; https://github.com/davidamitchell/Research/blob/main/Research/completed/2026-05-02-cross-item-synthesis-knowledge-map-architecture.md]
The clean first implementation is therefore deterministic normalization plus bounded fuzzy comparison within area, variant preservation in the registry, and use of W-0040's three-mention promotion rule as a starting threshold that should be revisited once structured historical data exists. [inference; source: https://github.com/maxbachmann/RapidFuzz; https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
- The recommendation relies more heavily on Cochrane, GRADE, and Zotero than on deep vendor-specific Rayyan and Covidence help documentation, so fine-grained product-behavior claims should be treated as medium-confidence extrapolations rather than as product-spec facts. [inference; source: https://training.cochrane.org/handbook/current/chapter-14; https://training.cochrane.org/handbook/current/chapter-15; https://gdt.gradepro.org/app/handbook/handbook.html; https://www.zotero.org/support/searching; https://www.covidence.org/]
- The exact fuzzy-threshold value still needs calibration against real repository examples because W-0040 has not yet produced a historical
gaps:dataset for threshold testing. [assumption; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/maxbachmann/RapidFuzz] - The recommendation assumes most gap strings will be short, well-formed questions rather than long paragraph fragments, because bounded fuzzy matching is safer on concise prompts than on long descriptive text. [assumption; source: https://github.com/maxbachmann/RapidFuzz; https://blacksmithgu.github.io/obsidian-dataview/]
- False-positive and false-negative rates cannot yet be quantified empirically because the repository does not currently store structured historical gap entries. [fact; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md]
- Should
areareuse canonical tags directly, or should W-0040 define a smaller area vocabulary dedicated to gap clustering? - Should the registry store a manual
canonical_questionoverride so reviewers can merge or split clusters without editing historical item frontmatter? - Should promoted gaps create backlog items automatically, or first mark
promote: trueand let the loop create the backlog item only after checking for an existing equivalent slug?
- Type: knowledge
- Description: Recommended a lightweight structured-gap design for W-0040:
gaps:entries with requiredquestion, optionalarea, heuristic-first aggregation, and W-0040's three-mention promotion rule treated as a provisional starting threshold. [inference; source: https://github.com/davidamitchell/Research/blob/main/BACKLOG.md; https://github.com/maxbachmann/RapidFuzz; https://training.cochrane.org/handbook/current/chapter-15] - Links:
Navigation
By Tag
bureaucracy
change-management
coase
constraint-analysis
control-model
decision-rights
delegation
- Q4: Decision rights that should move closer to execution
- Q5: Control model for the best throughput-risk trade-off
delivery-risk
- Operating model synthesis for split-authority delivery systems
- Q6: Leading indicators of instability in split-authority flow systems
demand-segmentation
enterprise
exception-handling
execution
flow
flow-design
flow-metrics
governance
- Operating model synthesis for split-authority delivery systems
- Q1: Dominant flow constraint in split-authority delivery systems
- Q2: Demand segmentation for fast-path vs controlled-path flow
- Q4: Decision rights that should move closer to execution
- Conditions under which internal governance controls minimise coordination costs in regulated enterprises
- Failure mechanisms of internal governance controls: bureaucratic inefficiency and informal circumvention in regulated enterprises
- Barriers to governance reform, leadership failure modes, and reform mechanisms in regulated enterprises
governance-patterns
incentives
- Failure mechanisms of internal governance controls: bureaucratic inefficiency and informal circumvention in regulated enterprises
- Barriers to governance reform, leadership failure modes, and reform mechanisms in regulated enterprises
instability
institutional-economics
- Conditions under which internal governance controls minimise coordination costs in regulated enterprises
- Failure mechanisms of internal governance controls: bureaucratic inefficiency and informal circumvention in regulated enterprises
- Barriers to governance reform, leadership failure modes, and reform mechanisms in regulated enterprises
leading-indicators
operating-model
organisation
- Conditions under which internal governance controls minimise coordination costs in regulated enterprises
- Failure mechanisms of internal governance controls: bureaucratic inefficiency and informal circumvention in regulated enterprises
- Barriers to governance reform, leadership failure modes, and reform mechanisms in regulated enterprises
organisational-design
queue-design
queueing
regulated-enterprise
- Conditions under which internal governance controls minimise coordination costs in regulated enterprises
- Failure mechanisms of internal governance controls: bureaucratic inefficiency and informal circumvention in regulated enterprises
- Barriers to governance reform, leadership failure modes, and reform mechanisms in regulated enterprises
routing
throughput
throughput-risk
transaction-costs
- Conditions under which internal governance controls minimise coordination costs in regulated enterprises
- Failure mechanisms of internal governance controls: bureaucratic inefficiency and informal circumvention in regulated enterprises
triage
- Q2: Demand segmentation for fast-path vs controlled-path flow
- Q3: Routing design that isolates exceptions from routine flow
williamson