kodex-fix-outdated

# Kodex Fix Outdated

Update an outdated Kodex topic by analyzing codebase changes and regenerating content based on current implementation.

## Overview

This skill updates a topic that has been flagged as outdated. It analyzes the codebase to identify what has changed since the topic was written, gathers new information, and generates updated content sections for user validation.

**Use when:**
- A topic has been flagged as outdated
- Codebase has evolved significantly since topic documentation
- Implementation details in the topic no longer reflect current code
- Topic references files or patterns that have changed

---

## Step 1: Get Existing Topic

Retrieve the topic from Kodex to understand its current state.

### 1.1 Query the Topic

Use the `kodex_query_topic` tool to fetch the topic:

```
Tool: mcp__plugin_mermaid-collab_mermaid__kodex_query_topic
Args: {
  "project": "<absolute-path-to-cwd>",
  "name": "<topic-name>",
  "include_content": true
}
```

### 1.2 Extract Current Content

From the returned topic, extract:
- **name**: Topic identifier
- **title**: Human-readable title
- **content.conceptual**: Current conceptual overview
- **content.technical**: Current technical details
- **content.files**: Current file references
- **content.related**: Current related topics

### 1.3 Identify Empty Sections

Mark which sections are empty or minimal:
- Empty conceptual (just placeholder text)
- Empty technical
- Empty files listing
- Empty related topics

---

## Step 2: Analyze Codebase for Changes

Explore the codebase to identify what has changed since the topic was written.

### 2.1 Extract File References from Topic

Parse the current `content.files` section to identify files mentioned in the topic.

### 2.2 Check File Existence and Changes

For each file mentioned:
- Use `Glob` to verify the file still exists
- Use `Read` to get current content
- Compare with any older patterns mentioned in the topic

### 2.3 Scan for Related Code Patterns

Use `Grep` to