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

---
description: Rename a note and update all wikilink references
---

# Rename Note Command

Rename a note file and update all wikilink references throughout the knowledge base.

## 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

1. Rename the physical markdown file (using Bash mv)
2. Update all wikilinks `[[old_filename]]` → `[[new_filename]]` in all markdown files (using Grep + Edit)
3. Update MOC files if needed (using Edit)

## Input

User provides:

- Old filename (e.g., "mcp_sdk.md" or just "mcp_sdk")
- New filename (e.g., "python_mcp_sdk.md" or just "python_mcp_sdk")

## Execution Steps

### 1. Normalize Filenames

Ensure both filenames have `.md` extension:

```
old_filename = "mcp_sdk" → "mcp_sdk.md"
new_filename = "python_mcp_sdk" → "python_mcp_sdk.md"
```

### 2. Verify Old File Exists

Use Glob to check if old file exists:

```bash
# Check if file exists
Glob mcp_sdk.md
```

If not found, report error to user.

### 3. Check New Filename Not In Use

Use Glob to ensure new filename doesn't already exist:

```bash
# Check if new filename is available
Glob python_mcp_sdk.md
```

If exists, report error to user.

### 4. Find All Wikilinks to Old Note

Use Grep to find all markdown files containing wikilinks to the old note:

```bash
# Find all files with wikilinks to old note
Grep "\[\[mcp_sdk\]\]" --glob="*.md" --output_mode="files_with_matches"
```

Store list of files that need updating.

### 5. Rename the Physical File

Use Bash to rename the file:

```bash
# Rename the file
mv "mcp_sdk.md" "python_mcp_sdk.md"
```

### 6. Update Wikilinks in All Files

For each file found in step 4, use Edit tool to replace wikilinks:

```markdown
# Old wikilink
[[mcp_sdk]]

# New wikilink
[[python_mcp_sdk]]
```

Use Edit tool for each file:

- old_string: `[[mcp_sdk]]`
- new_string: `[[python_mcp_sdk]]`
- replace_all: true (to catch all occurrences in the file)

Track how many files were updated.

### 7. Update MOC Files

Check if any MOC files were updated in step 6. If so, verify the context around the wikilink makes sense with the new name.

## Output Format

Report to user:

```
============================================================
Renamed Note: mcp_sdk.md → python_mcp_sdk.md
============================================================

📝 Physical file renamed
   ✓ mcp_sdk.md → python_mcp_sdk.md

📄 Updated wikilinks in N files:
   ✓ file1.md: X reference(s)
   ✓ file2.md: Y reference(s)
   ✓ file3.md: Z reference(s)

============================================================
✅ Rename Complete!
============================================================

📋 Summary:
   • File renamed: mcp_sdk.md → python_mcp_sdk.md
   • Markdown files updated: N
   • Total wikilink updates: M

💡 Next steps:
   • Review changes with git diff
   • Update note title if needed to match new filename
   • Update note tags if needed
   • Verify MOC entries make sense with new name
```

## Validation

After renaming:

- Old file no longer exists (verify with Glob)
- New file exists (verify with Glob)
- No remaining wikilinks to old filename (verify with Grep)
- All "Related Concepts" sections still valid (Read a few files to spot check)

## Safety Features

- Check old file exists before renaming
- Check new filename not in use before renaming
- Use replace_all to catch all wikilinks in each file
- Report which files were updated for transparency
- All changes visible in git diff

## Use Cases

- **Clarify naming**: Rename `mcp_sdk.md` → `python_mcp_sdk.md` to be more specific
- **Fix typos**: Rename `agnet.md` → `agent.md`
- **Reorganize**: Rename `notes.md` → `note_taking_systems.md` for better descriptiveness
- **Language consistency**: Ensure all filenames follow `language_topic.md` pattern

## Present Results

After renaming:

- Show summary of changes made
- Highlight number of files and references updated
- Suggest reviewing MOC files to ensure context still makes sense
- Recommend updating note title/tags if needed to match new filename

## Common Patterns

**Language-specific SDK notes:**

```
mcp_sdk.md → python_mcp_sdk.md
(leaves room for typescript_mcp_sdk.md, rust_mcp_sdk.md, etc.)
```

**Generic to specific:**

```
agents.md → ai_agents.md
deployment.md → docker_deployment.md
```

**Consistency with existing patterns:**

```
mcp-overview.md → mcp_overview.md  (underscore convention)
llm_agents.md → agents.md  (when already specific enough)
```

## Tools Used

- **Glob** - Check if files exist
- **Grep** - Find all wikilinks to old filename
- **Bash** - Rename the physical file (mv command)
- **Edit** - Update wikilinks in each markdown file
- **Read** - Spot check updated files for correctness