Initial commit
This commit is contained in:
Zhongwei Li
203
commands/graph-moc.md
Normal file
203
commands/graph-moc.md
Normal file
@@ -0,0 +1,203 @@
|
||||
---
|
||||
description: Display information about a Map of Content (MOC) file
|
||||
---
|
||||
|
||||
# Graph MOC (Map of Content)
|
||||
|
||||
Display information about a specific MOC (Map of Content) file, which serves as a thematic navigation hub.
|
||||
|
||||
## 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
|
||||
|
||||
Show:
|
||||
|
||||
- MOC name and theme
|
||||
- Total notes linked in this MOC
|
||||
- List of all notes with their brief descriptions
|
||||
- Section organization within the MOC
|
||||
|
||||
## Input
|
||||
|
||||
User provides the MOC name (e.g., "agents", "mcp", "python", "rust")
|
||||
|
||||
Common MOCs:
|
||||
|
||||
- agents_moc.md - AI agents and agentic systems
|
||||
- mcp_moc.md - Model Context Protocol
|
||||
- python_moc.md - Python development
|
||||
- rust_moc.md - Rust programming
|
||||
- typescript_moc.md - TypeScript and React
|
||||
- windows_moc.md - Windows development
|
||||
- writing_moc.md - Writing and communication
|
||||
- csharp_moc.md - C# development
|
||||
|
||||
## Execution Steps
|
||||
|
||||
### 1. Normalize MOC Name
|
||||
|
||||
Ensure filename has `_moc.md` suffix:
|
||||
|
||||
- Input: "agents" → "agents_moc.md"
|
||||
- Input: "agents_moc" → "agents_moc.md"
|
||||
- Input: "agents_moc.md" → "agents_moc.md"
|
||||
|
||||
### 2. Verify MOC Exists
|
||||
|
||||
Use Glob to check if MOC file exists:
|
||||
|
||||
```bash
|
||||
Glob "agents_moc.md"
|
||||
```
|
||||
|
||||
If not found, list available MOCs and suggest closest match.
|
||||
|
||||
### 3. Read MOC Content
|
||||
|
||||
Use Read tool to get full MOC content.
|
||||
|
||||
### 4. Parse MOC Structure
|
||||
|
||||
Extract:
|
||||
|
||||
- **Title** (H1 heading)
|
||||
- **Sections** (H2 headings)
|
||||
- **Wikilinks** in each section
|
||||
- **Brief descriptions** next to each wikilink
|
||||
|
||||
Example MOC structure:
|
||||
|
||||
```markdown
|
||||
# Agents - Map of Content
|
||||
|
||||
## Core Concepts
|
||||
- [[agents]] - AI agents powered by LLMs
|
||||
- [[semantic_routing]] - Intelligent model selection
|
||||
|
||||
## Coding Assistants
|
||||
- [[claude_code]] - Agentic AI coding assistant
|
||||
- [[claude_code_agents]] - Subagent system
|
||||
```
|
||||
|
||||
### 5. Count Notes
|
||||
|
||||
Count total wikilinks across all sections.
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
MOC: agents_moc.md
|
||||
============================================================
|
||||
|
||||
Theme: AI agents and agentic systems
|
||||
Total notes: 15
|
||||
|
||||
## Sections and Notes:
|
||||
|
||||
### Core Concepts (5 notes)
|
||||
- [[agents]] - AI agents powered by LLMs for autonomous action
|
||||
- [[semantic_routing]] - Intelligent model selection based on query
|
||||
- [[react_agent_pattern]] - Design pattern for agent UIs
|
||||
- [[llm_self_talk_optimization]] - Token-efficient agent communication
|
||||
- [[agentic_development_context]] - Comprehensive development ecosystems
|
||||
|
||||
### Coding Assistants (5 notes)
|
||||
- [[claude_code]] - Anthropic's agentic AI coding assistant
|
||||
- [[claude_code_agents]] - Subagent system for parallel tasks
|
||||
- [[claude_code_plugins]] - Extensibility via slash commands
|
||||
- [[claude_code_hooks]] - Lifecycle event system
|
||||
- [[zettelkasten_claude_plugin]] - Knowledge graph plugin
|
||||
|
||||
### Integration & APIs (2 notes)
|
||||
- [[agent_mcp_apis]] - MCP APIs for agent tool integration
|
||||
- [[adding_mcp_to_claude_code]] - Adding custom agents
|
||||
|
||||
### Related Topics (3 notes)
|
||||
- [[mcp_overview]] - Protocol for agent tool integration
|
||||
- [[react_framework]] - UI framework for agents
|
||||
|
||||
============================================================
|
||||
|
||||
💡 Next steps:
|
||||
• Use `/graph-note [filename]` to explore any note in this MOC
|
||||
• Use `/create-note` to add new notes to this domain
|
||||
• Use `/search-notes #agents` to find all agent-tagged notes
|
||||
```
|
||||
|
||||
## Use Cases
|
||||
|
||||
- **Explore a domain**: See all notes in a specific theme
|
||||
- **Find related notes**: Discover notes you didn't know existed
|
||||
- **Assess coverage**: Check if a topic area is well-covered
|
||||
- **Navigate efficiently**: Jump to specific concepts in a domain
|
||||
- **Plan additions**: Identify gaps where new notes are needed
|
||||
|
||||
## Tools Used
|
||||
|
||||
- **Glob** - Verify MOC file exists, list all MOCs
|
||||
- **Read** - Get full MOC content
|
||||
- **Parse logic** - Extract sections, wikilinks, descriptions
|
||||
|
||||
## Present Results
|
||||
|
||||
After displaying MOC information:
|
||||
|
||||
- Assess coverage (comprehensive vs sparse)
|
||||
- Comment on organization (clear sections vs needs structure)
|
||||
- Suggest if MOC is getting too large (might need splitting)
|
||||
- Identify potential notes to add based on theme
|
||||
- Note any wikilinks that point to non-existent notes
|
||||
|
||||
## If MOC Not Found
|
||||
|
||||
```
|
||||
MOC not found: unknown_moc.md
|
||||
|
||||
Available MOCs:
|
||||
- agents_moc.md - AI agents and agentic systems
|
||||
- mcp_moc.md - Model Context Protocol
|
||||
- python_moc.md - Python development
|
||||
- rust_moc.md - Rust programming
|
||||
- typescript_moc.md - TypeScript and React
|
||||
- windows_moc.md - Windows development
|
||||
- writing_moc.md - Writing and communication
|
||||
- csharp_moc.md - C# development
|
||||
|
||||
Did you mean one of these?
|
||||
```
|
||||
Reference in New Issue
Block a user