steve/skills
Public Access
1
0
Fork 0
Code Issues 11 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat(pkm): add compiled wiki layer, packet promotion, and retrieval checks to research skills

Browse Source 
- Add compiled wiki maintenance, retrieval lint, and packet promotion
  steps to knowledge-gardener skill
- Restructure research-vault workflow with source ingest, answer filing,
  and pre-completion lint pass
- Add Log.md for tracking ingest, queries, and corrections
- Enhance Claims template with provenance, supports/contradicts, and
  confidence tracking
- Add Compiled Pages table and Raw Source Rules to packet template
- Enhance atomic notes with frontmatter, promotion status, and
  structured links
- Distinguish source claims, synthesis, user opinions, and open
  questions throughout

This implements a Karpathy-style compiled wiki approach where raw
sources stay immutable, packet notes are the maintained synthesis
layer, and reusable notes can be promoted to the main vault.
This commit is contained in:
gitadmin
2026-06-22 23:06:03 -04:00
parent 1a03d0a0ff
commit 91e643553e
3 changed files with 93 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
common/pkm/research-vault/references/research-packet-template.md
+49 -3
View File
@@ -24,10 +24,16 @@ Use inside `Research/<YYYY-MM-DD> <Topic>/` unless the vault has a clearer conve
- [[Questions]]
- [[Conversation]]
- [[Glossaries]]
- [[Log]]
## Related Vault Notes
-
## Compiled Pages
| Page | Type | One-line purpose | Source basis | Status |
|---|---|---|---|---|
| | source summary \| concept \| claim cluster \| synthesis \| promoted | | | draft \| reviewed \| promoted |
## Open Questions
-
```
@@ -43,6 +49,10 @@ Use inside `Research/<YYYY-MM-DD> <Topic>/` unless the vault has a clearer conve
## Notes
-
## Raw Source Rules
- Preserve raw source files as immutable evidence.
- Add interpretation in packet notes, not inside the source file.
```
Include source links, books, papers, docs, videos, examples, search terms, or relevant vault notes only when they improve learning or evidence quality.
@@ -71,12 +81,16 @@ Include source links, books, papers, docs, videos, examples, search terms, or re
```markdown
# Claims
## Claim: <claim>
## Claim: <single answerable claim>
- Type: source claim | synthesis | opinion | open question
- Evidence:
- Source:
- Confidence: high | medium | low
- Supports:
- Contradicts or complicates:
- Implications:
- Related notes:
- Last checked:
```
### `Questions.md`
@@ -118,6 +132,22 @@ Include source links, books, papers, docs, videos, examples, search terms, or re
Record important answers, corrections, and scope decisions as the session progresses.
### `Log.md`
```markdown
# Log
Append one entry for each ingest, query filed back into the packet, lint pass, promotion, or major correction.
## YYYY-MM-DD HH:MM — <ingest | query | lint | promotion | correction>
- Input:
- Files read:
- Files changed:
- Claims added or revised:
- Links added:
- Open issues:
```
### `Glossaries.md`
```markdown
@@ -136,14 +166,30 @@ Add every acronym, abbreviation, domain-specific phrase, specialized term, jargo
## Atomic note
```markdown
---
id: <stable-id>
aliases: []
tags: [research, atomic-note]
area: <area>
project: [[<packet topic>]]
---
# <Concept>
## Idea
<State the single reusable concept.>
## Why it matters
<Explain retrieval, decision, or learning value.>
## Evidence or source
- Claim: [[Claims#Claim <anchor or short title>]]
- Source:
## Related notes
-
## Links
- Broader:
- Related:
- Contrasts:
## Promotion status
- Packet-local | candidate for main vault | promoted to [[path/to/promoted note]]
```