gh-witt3rd-claude-plugins-plugins-azkg/commands/graph-note.md

---
description: Display detailed information about a specific note
---

# Graph Note

Show detailed information about a specific note, including all relationships and backlinks.

## 0. Locate AZKG Repository

**Check for AZKG_REPO_PATH environment variable:**

- Use bash conditional: `if [ -z "$AZKG_REPO_PATH" ]; then REPO_PATH=$(pwd); else REPO_PATH="$AZKG_REPO_PATH"; fi`
- **If AZKG_REPO_PATH is set:** Use that path as the repository root
- **If AZKG_REPO_PATH is not set:** Use current working directory (pwd)
- Store result as REPO_PATH for all subsequent file operations

**All file operations must use REPO_PATH:**

- Read: `Read(REPO_PATH/filename.md)` or `Read("$REPO_PATH/filename.md")`
- Write: `Write(REPO_PATH/filename.md)` or `Write("$REPO_PATH/filename.md")`
- Edit: `Edit(REPO_PATH/filename.md)` or `Edit("$REPO_PATH/filename.md")`
- Grep: `Grep(pattern, path=REPO_PATH)` or with explicit path
- Glob: `Glob(pattern, path=REPO_PATH)` or with explicit path

**Example usage:**

```
# Check environment variable
if [ -z "$AZKG_REPO_PATH" ]; then
  REPO_PATH=$(pwd)
else
  REPO_PATH="$AZKG_REPO_PATH"
fi

# Then use REPO_PATH for all operations
Read("$REPO_PATH/agents.md")
```

**Concrete examples:**

- If AZKG_REPO_PATH="/c/Users/dothompson/OneDrive/src/witt3rd/donald-azkg"
  → Read("/c/Users/dothompson/OneDrive/src/witt3rd/donald-azkg/agents.md")
- If AZKG_REPO_PATH is not set and pwd is /c/Users/dothompson/OneDrive/src/witt3rd/donald-azkg
  → Read("agents.md") or use full path from pwd

## Task

Display:

- Note title, tags, and summary (from YAML frontmatter and heading)
- All relationships from "Related Concepts" section
- Backlinks (other notes that reference this note)

## Input

User provides filename: `/graph-note agents.md` or `/graph-note agents`

## Execution Steps

### 1. Normalize Filename

Ensure filename has `.md` extension.

### 2. Verify Note Exists

Use Glob to check if note exists:

```bash
Glob "agents.md"
```

If not found, report error.

### 3. Read Note Content

Use Read tool to get full note content.

### 4. Extract Metadata

From the note content:

- **Title**: First `# Heading` after YAML frontmatter
- **Tags**: From `tags:` field in YAML frontmatter
- **Summary**: First paragraph after title (before `##` sections)

### 5. Parse "Related Concepts" Section

From note content, extract all relationships:

- Prerequisites
- Related Topics
- Extends
- Extended By
- Alternatives
- Examples

For each relationship, capture the target note and "why" explanation.

### 6. Find Backlinks

Use Grep to find all notes that reference this note:

```bash
# Find all wikilinks to this note
Grep "\[\[agents\]\]" --glob="*.md" --output_mode="files_with_matches"
```

Count and list the files that link to this note.

## Output Format

```
Note: agents.md
============================================================

## Metadata
Title: AI Agents
Tags: #agents, #ai, #llm, #architecture
Summary: AI agents are autonomous systems powered by LLMs that can perceive,
decide, and act to achieve goals.

## Relationships (Total: 8)

### Prerequisites (0)
(None)

### Related Topics (3)
- [[semantic_routing]] - Enables intelligent model selection for agent tasks
- [[llm_self_talk_optimization]] - Token-efficient communication between agents
- [[react_agent_pattern]] - UI pattern for building agent interfaces

### Extends (0)
(None)

### Extended By (2)
- [[claude_code]] - Implements agentic coding assistant
- [[alita]] - Example implementation of AI agent system

### Alternatives (0)
(None)

### Examples (3)
- [[alita]] - Production AI agent implementation
- [[claude_code]] - Agentic coding assistant
- [[another_example]] - Another implementation

## Backlinks (12 notes reference this)

Files that link to [[agents]]:
- semantic_routing.md
- react_agent_pattern.md
- mcp_overview.md
- claude_code.md
- agents_moc.md
- ...

============================================================
💡 Next Steps:
• Use `/expand-graph agents.md` to discover more relationships
• Review backlinks to understand how this note is used
• Check if "Extended By" relationships should be in "Examples" instead
```

## Use Cases

- **Understand connections**: See how a note fits into the knowledge graph
- **Find usage**: See where a concept is referenced (backlinks)
- **Verify relationships**: Check if relationships are accurate and complete
- **Discover gaps**: Find missing prerequisite or extension relationships

## Tools Used

- **Glob** - Verify note exists
- **Read** - Get full note content
- **Grep** - Find backlinks (wikilinks to this note)
- **Parse logic** - Extract YAML, title, summary, relationships

## Present Results

- Show clear breakdown of relationship types
- Highlight if note has no prerequisites (might be foundational)
- Highlight if note has many Extended By (indicates it's a base concept)
- Show backlink count to indicate note importance/usage
- Suggest using `/expand-graph` if relationship count seems low