ideaverse-enrichment
npx skills add https://github.com/mrfelton/ideaverse --skill ideaverse-enrichment
Agent 安装分布
Skill 文档
Ideaverse Enrichment Skill
Use the ARC enrichment workflow to add new knowledge while maintaining consistency, detecting duplicates, and choosing appropriate structures. Assume familiarity with the core Ideaverse methodology.
The ARC Enrichment Workflow
All knowledge enrichment follows the ARC pattern: Add â Relate â Communicate.
Phase 1: ADD (Capture Without Friction)
1. Capture the raw information quickly
âââ To daily log (if temporal)
âââ To fleeting note (if needs processing)
âââ Direct to Atlas (if clearly permanent)
2. Include source attribution
âââ Where did this come from?
3. Don't organize yet
âââ Processing happens in RELATE phase
Key principle: Speed of capture matters. Don’t let organization concerns prevent getting ideas into the system.
Phase 2: RELATE (Connect & Integrate)
This is where enrichment quality is determined.
Step 2.1: Search Before Creating
â
âââ Search for existing notes on this concept
âââ Check related MOCs for similar ideas
âââ If exists â Update existing note instead
Step 2.2: Classify Knowledge Type
â
âââ Concept? â Use concept extraction pattern
âââ Process? â Use process documentation pattern
âââ Entity? â Use entity profile pattern
âââ Principle? â Use principle articulation pattern
Step 2.3: Extract Atomic Notes
â
âââ One note per distinct concept
âââ Keep notes focused and atomic
âââ Add proper frontmatter (up, related, created)
Step 2.4: Establish Connections
â
âââ Set up: property to relevant MOC
âââ Add related: links to connected concepts
âââ Add note to parent MOC
âââ Add back-links from related notes
Step 2.5: Validate Consistency
â
âââ Frontmatter complete?
âââ Links working?
âââ No duplicates created?
Phase 3: COMMUNICATE (Express & Use)
1. Use new knowledge in output
âââ Reference in daily logs
âââ Include in projects
âââ Build on for future work
2. Track completion
âââ Note in daily log that enrichment happened
Knowledge Classification
Different types of knowledge require different structures. Classify before extracting.
Type 1: Concepts
What: Abstract ideas, frameworks, mental models, theories
Characteristics:
- Stands alone as an idea
- Has relationships to other concepts
- Can be applied across domains
Structure pattern:
# [Concept Name]
Brief definition in 1-2 sentences.
## Core Idea
What is this concept fundamentally about?
## Key Principles
- Principle 1
- Principle 2
## Connections
How does this relate to [[Related Concept]]?
## Applications
Where/when does this apply?
## Examples
Concrete instances of this concept.
Use the prompt: ideaverse-enrichment-concepts.prompt
Type 2: Processes
What: Procedures, workflows, how-to knowledge, sequences
Characteristics:
- Has steps or phases
- Produces an outcome
- Can be followed repeatedly
Structure pattern:
# [Process Name]
Brief description of what this process accomplishes.
## When to Use
Triggers or conditions for this process.
## Prerequisites
What's needed before starting?
## Steps
1. Step one
2. Step two
3. Step three
## Decision Points
If [condition], then [action].
## Common Variations
Alternative approaches when [situation].
## Failure Modes
What can go wrong and how to recover.
Use the prompt: ideaverse-enrichment-processes.prompt
Type 3: Entities
What: People, organizations, tools, products, places
Characteristics:
- Specific instance, not abstract
- Has attributes and relationships
- Changes over time
Structure pattern:
# [Entity Name]
Brief one-line description.
## Identity
What/who is this? Core attributes.
## Relationships
- Connected to [[Person/Org]]
- Uses [[Tool]]
- Part of [[System]]
## Context
Role, function, or purpose in your world.
## History
Key events, changes, timeline (if relevant).
## Notes
Additional observations.
Use the prompt: ideaverse-enrichment-entities.prompt
Type 4: Principles
What: Rules, heuristics, guidelines, maxims
Characteristics:
- Prescriptive (tells you what to do)
- Has conditions of application
- May have exceptions
Structure pattern:
# [Principle Name]
The principle stated clearly in one sentence.
## Definition
What does this principle mean in practice?
## When It Applies
Conditions where this principle is relevant.
## How to Apply
Practical guidance for using this principle.
## Counter-Examples
When does this NOT apply? What are the exceptions?
## Why It Matters
The reasoning behind this principle.
## Related Principles
- [[Similar Principle]]
- [[Contrasting Principle]]
Use the prompt: ideaverse-enrichment-principles.prompt
Duplicate Detection
Before creating any new note, check for existing coverage.
Search Strategy
1. Exact match search
âââ Search: [[concept name]]
2. Synonym search
âââ What other terms describe this?
3. MOC review
âââ Browse relevant MOC for similar concepts
4. Semantic scan
âââ What notes discuss related ideas?
Duplicate Resolution
When a duplicate is found:
If new info < existing info:
âââ Add link to existing, don't create new
If new info supplements existing:
âââ Update existing note with new info
If notes are genuinely different:
âââ Create separate notes, add related: links
If unclear:
âââ Create new note, flag for later dedup review
Merge Process
When consolidating duplicates:
1. Choose primary note (better structured/more complete)
2. Copy unique content from secondary to primary
3. Update links pointing to secondary â point to primary
4. Update MOCs to reference only primary
5. Delete secondary (or archive if uncertain)
Enrichment Workflows
Workflow: Article/Book Processing
1. Read/consume the source
â
2. Capture key ideas to daily log
- Use bullet points
- Note source and page/location
â
3. Identify distinct concepts (usually 2-5 per article)
â
4. For each concept:
a. Classify type (concept/process/entity/principle)
b. Check for existing notes
c. Create or update note
d. Add to relevant MOC
â
5. Create source note (optional)
- Link to all extracted concepts
- Add to Sources MOC
Workflow: Experience Processing
1. Capture raw thoughts/observations
â
2. Let it sit (optional - allows reflection)
â
3. Identify the generalizable insight
- What can I learn from this that applies elsewhere?
â
4. Extract as principle or concept note
â
5. Link to specific experience in daily log
Workflow: Research Integration
1. Gather sources on topic
â
2. Create temporary synthesis note
- List all sources
- Note key points from each
â
3. Identify gaps in existing vault knowledge
â
4. Create atomic notes to fill gaps
â
5. Update relevant MOC with new structure
â
6. Archive or keep synthesis note as overview
Best Practices
Quality Over Quantity
- Better to have 10 well-linked notes than 100 orphans
- Take time in the RELATE phase
- Verify connections are meaningful
Source Attribution
- Always note where knowledge came from
- Makes future verification possible
- Helps trace your thinking
Incremental Enrichment
- Don’t try to capture everything at once
- Regular small additions beat occasional large dumps
- Let structure emerge naturally
Validation Checklist
Before considering enrichment complete:
- Frontmatter has
up:andcreated: - Note added to relevant MOC
- At least one related: link if applicable
- No broken links introduced
- No duplicate created (or duplicates merged)
Reference Documentation
For detailed patterns and extraction templates, see:
- references/enrichment-workflow.md – Complete ARC workflow details
- references/knowledge-classification.md – Deep dive on knowledge types
- references/extraction-templates.md – Type-specific extraction templates, guidelines, and quality signals
- references/duplicate-detection.md – Finding and handling duplicates
All extraction workflows are contained within this skillâno external prompts needed.