seongsu-kang/tycono/knowledge-gate

Knowledge Gate (Dynamic Domain Experts)

"Prevent mindless document creation. Domain experts find optimal connections."

Core Problem

Process

Step 1: Insight Summary

When documenting new knowledge:

1. One-line summary of the insight
2. Extract 3-5 keywords

Step 2: Existing Document Search (Quick Scan)

# Search with keywords
grep -rn "{keyword1}\|{keyword2}\|{keyword3}" --include="*.md" .
 
# Find similar topic docs
find . -name "*.md" | xargs grep -l "{core_topic}"

Step 3: Dynamic Domain Expert Analysis (Diverge)

3.1 Discover All Hubs

Hub pattern: {folder-name}.md as folder entry point, or akb_type: hub frontmatter.

# Find Hub documents
find . -name "*.md" -exec sh -c 'dir=$(dirname "$1"); base=$(basename "$dir"); fname=$(basename "$1" .md); [ "$base" = "$fname" ] && echo "$1"' _ {} \;
grep -rl "akb_type: hub" --include="*.md" .

3.2 Parallel Expert Agent Execution

For every discovered Hub, run an Expert Agent in parallel:

Each expert evaluates:

• Is there a direct dependency between this insight and my domain?
• Rate relevance strictly: high (direct dependency) / medium (indirect) / none

Relevance criteria (strict):

Anti-bias rule: Don't force connections. Only HIGH = direct dependency.

3.3 Converge Results

Step 4: Decide Placement

Step 5: AKB Linter Verification

Run akb-linter on new/modified document.

Step 6: Execute Connections

1. Hub routing: Add link in the relevant Hub
2. Cross-links: Add mutual references to related docs
3. Related Documentation: Include links in new doc

Decision Criteria

Core Principles

"1 doc added = maintenance cost increased"

"Strengthen existing > Create new"

"Isolated doc = dead doc"

1. Existing first - Never create without searching
2. Expert analysis - All domain Hubs weigh in
3. Links required - Hub routing + cross-links mandatory
4. Justify creation - State why new doc is needed
5. Preview before action - Show what will change