gh-witt3rd-claude-plugins-plugins-azkg/commands/refresh-topic.md

description

description
Refresh a topic page with latest information from Perplexity

Refresh Topic

You are tasked with refreshing a topic page with the latest information. Follow these steps:

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

1. Read the Topic File

• The user will provide a filename (e.g., agents.md or just agents)
• Read the file from REPO_PATH (not current directory)
• Parse the YAML frontmatter and main content

2. Formulate Perplexity Query

• Analyze the topic content to understand the main subject
• Extract key concepts, technologies, or themes
• Create a focused query to find:
  • Recent developments (last 6-12 months)
  • New research or papers
  • Updated best practices
  • Emerging trends
  • Deprecated or outdated information

Example query format: "What are the latest developments, research, and best practices for [TOPIC] as of 2025? Include any significant changes, new tools, or deprecated approaches."

3. Query Perplexity

• Use the mcp__perplexity-ask__perplexity_ask tool
• Provide a clear, focused query based on the topic analysis
• Request comprehensive, up-to-date information

4. Incorporate Updates

• Review the Perplexity response carefully
• Identify genuinely new or updated information that should be added
• For each update:
  • Determine the appropriate section to update
  • Maintain the existing structure and format
  • Add new information without removing valuable existing content
  • Preserve all existing citations and references
  • Add new citations for updated information if provided

5. Update Metadata

• Add or update the YAML frontmatter with:

  last_refresh: 2025-10-11  # Use today's date
  

• Preserve all existing YAML fields (tags, etc.)

• Maintain YAML formatting

6. Write Updated File

• Use the Edit tool to make surgical updates to specific sections
• OR use the Write tool if comprehensive rewrite is needed
• Ensure all formatting is preserved (markdown, wikilinks, etc.)

7. Summary

• Provide a brief summary of:
  • What updates were found
  • Which sections were modified
  • Any significant new information added
  • Any outdated information identified (but keep unless contradicted)

Important Notes

• Preserve existing content: Only add or update, don't remove unless information is clearly outdated or contradicted
• Maintain structure: Keep the same section organization
• Keep relationships: Don't modify the "Related Concepts" section
• Respect format: Maintain wikilink format [[note]], YAML format, etc.
• Be conservative: Only incorporate high-quality, verifiable updates
• No hyperbole: Don't add marketing language or grandiose claims

Execute these steps for the topic file provided by the user.