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