Maceff Knowledge Web Curate

macf_tools knowledge graph --json    # Current node/edge counts
macf_tools knowledge gaps            # What's missing?

Record baseline metrics in task notes: nodes, edges, cross-CA edges, gap count.

Step 2: Evaluate Gaps

For each gap suggestion:

• 100% confidence: Almost certainly genuine — add the wiki-link
• 50-67% confidence: Evaluate whether the keyword overlap reflects real conceptual connection
• Below 50%: Skip unless you have domain knowledge confirming the link

Step 3: Query Before Linking

Before adding a wiki-link, query the concept to understand what you're connecting to:

macf_tools knowledge query <concept>    # What's already connected?

This prevents spurious links — if the subgraph doesn't relate to your node, the keyword overlap was coincidental.

Step 4: Add Wiki-Links

For ideas (JSON files): Update the links.wiki_links array For learnings/observations (markdown): Add or update ## Wiki-Links section

Wiki-link format: [[concept_name]] — lowercase, underscores, no .md suffix. Aim for 2-5 concepts per artifact.

Step 5: Re-Verify

macf_tools knowledge gaps             # Should decrease
macf_tools knowledge graph --json     # Edge count should increase

Record post-curation metrics. The delta is the evidence of value.

ULTRATHINK Reflection

Before curating, think:

1. Are there new concepts that should exist? If 3+ CAs share a theme not in the seed vocabulary, create a new concept.
2. Are existing concepts too broad? If [[hooks]] connects 20+ nodes, consider splitting into [[hooks_lifecycle]] and [[hooks_injection]].
3. Are there orphan CAs? Learnings or observations without ## Wiki-Links sections are invisible to the graph.
4. Is normalization consistent? Check for .md suffixes, capitalization, or hyphen vs underscore variants of the same concept.

Anti-Pattern: The Isolated Sprint

Creating 10 learnings and 5 ideas during a sprint without adding wiki-links produces isolated nodes. The graph grows in node count but not in edge count. Run gap detection after any productive sprint.