/related

SkillDev tools

Find all notes related to a topic using parallel sub-agents for comprehensive search.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the /related skill

About this capability

A comprehensive knowledge management system for Solutions Architects using AI

What this skill tells your AI

The instructions your AI receives, as published by davidroliverba/architectkb in .claude/skills/related/SKILL.md and read by ahel’s review.

Find all notes related to a topic using parallel sub-agents for comprehensive search.

Usage

/related <topic>
/related VendorA
/related Cloud Platform
/related Jane Doe

Instructions

Phase 1: Planning

  1. Analyse the topic to determine:

    • Is it a person? → Focus on Person notes, meetings with them
    • Is it a technology? → Focus on Pages, ADRs, Projects
    • Is it a project? → Focus on Project, Meetings, Tasks
    • Is it an organisation? → Focus on Organisation, People, Meetings
  2. Load relevant context file:

    • People topic → .claude/context/people.md
    • Tech topic → .claude/context/technology.md
    • Project topic → .claude/context/projects.md
    • Org topic → .claude/context/organisations.md

Phase 2: Parallel Search (use sub-agents)

Launch 4 sub-agents in parallel using model: "haiku" for efficiency:

Agent 1: Direct Matches (Haiku)

  • Find notes with topic in filename
  • Find notes with topic in title frontmatter
  • Return: filename, type, title

Agent 2: Content Search (Haiku)

  • Grep for topic across all .md files in vault root
  • Return: filename, matching line, context

Agent 3: Backlink Analysis (Haiku)

  • If a note exists for topic, find all notes linking TO it
  • Return: linking notes with context

Agent 4: Tag & Metadata Search (Haiku)

  • Search frontmatter for topic in tags, project, organisation fields
  • Return: notes with metadata matches

Phase 3: Compile & Rank Results

# Notes Related to: {{topic}}

**Found**: {{count}} related notes

## Direct Matches ({{count}})

Notes specifically about {{topic}}:

| Note | Type | Last Modified |
|------|------|---------------|
{{direct matches}}

## Mentions ({{count}})

Notes that reference {{topic}}:

| Note | Type | Context |
|------|------|---------|
{{content matches with snippet}}

## Linked Notes ({{count}})

Notes connected via wiki-links:

{{backlink results}}

## By Type

### Meetings ({{count}})
{{meeting list}}

### Projects ({{count}})
{{project list}}

### People ({{count}})
{{people list}}

### ADRs ({{count}})
{{adr list}}

### Tasks ({{count}})
{{task list}}

## Suggested Connections

{{identify notes that SHOULD link to each other but don't}}

Signals

GitHub stars
52
Forks
12
Last commit
Mar 2026
Advanced
Catalog kind
skill
Gateway key
related
Source
github.com/davidroliverba/architectkb