Kodex Fix Incorrect

Correct factually incorrect Kodex topic content.

Overview

This sub-skill is invoked by kodex-fix when a topic is flagged as incorrect. It focuses on the specific inaccuracy described in the flag and verifies against actual code.

Step 1: Get Existing Topic and Flag Details

Query the existing topic to understand the current content:

Tool: mcp__plugin_mermaid-collab_mermaid__kodex_query_topic
Args: { "project": "<cwd>", "name": "<topic-name>" }

Review the flag description to understand what's incorrect. Extract:

Current content (conceptual, technical, files, related)
File paths from the 'files' section
The specific inaccuracy mentioned in the flag

If topic not found:

Topic not found. This may need kodex-fix-missing instead.

Return to parent skill.

Step 2: Verify the Inaccuracy

Focus on the specific inaccuracy mentioned in the flag. Read the files mentioned in the topic to compare what they actually contain versus what the topic claims:

Tool: Read
Args: { "file_path": "<file-from-topic>" }

Compare:

What the topic claims
What the code actually does

Identify the specific incorrect statement(s) by examining the implementation. Focus specifically on the inaccuracy flagged rather than a general review.

Step 3: Research Correct Information

Use Grep to find actual implementations and verify what the code actually does:

Tool: Grep
Args: { "pattern": "<function-or-concept>", "path": "<project-root>" }

Build accurate understanding of how things actually work in the codebase. Research the specific behavior that contradicts what the topic currently documents.

Step 4: Generate Corrected Content

Update the sections that contain the inaccuracy. Focus corrections on:

The specific inaccuracy from the flag
Any related incorrect statements discovered during research
Keep accurate parts unchanged

Generate corrected versions of affected sections (conceptual, technical, files, related as needed).

Step 5: Validate with User

Present the correction for user validation:

**Correction:**

The flag said: "[flag description]"
I found: "[actual behavior from code]"

Updated content:
[corrected section]

Is this correction accurate?
1. Yes
2. No - needs adjustment

Use AskUserQuestion to get user feedback. If user selects 2, ask for corrections and regenerate.

Step 6: Create Draft

Call kodex_update_topic to create a draft with the corrected content:

Tool: mcp__plugin_mermaid-collab_mermaid__kodex_update_topic
Args: {
  "project": "<cwd>",
  "name": "<topic-name>",
  "content": { "conceptual": "...", "technical": "...", "files": "...", "related": "..." },
  "reason": "Corrected inaccuracy: [brief description of the correction]"
}

Return to parent skill after draft is created.

Error Handling

| Error | Action | |-------|--------| | Topic not found | Return to parent, suggest kodex-fix-missing | | Files not readable | Skip, note in content | | User rejects content | Ask for corrections, regenerate | | MCP tool failure | Display error, suggest retry |

Integration

Called by: kodex-fix (parent skill) Returns to: kodex-fix after creating draft

Related skills:

kodex-fix - Parent skill that orchestrates flag fixes
kodex-fix-outdated - Update stale content
kodex-fix-incomplete - Fill missing sections
kodex-fix-missing - Create new topics
using-kodex - Query and flag topics