wf-fix

Update planning documents and coordinate code changes for bugs or requirement improvements.

2|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/liqunx/wikiflow --skill wf-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wf-fix
Source: https://github.com/liqunx/wikiflow/tree/main/skills/wf-fix
Command: npx skills add https://github.com/liqunx/wikiflow --skill wf-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

When requirements evolve or bugs appear during WikiFlow development, the docs can drift from the actual implementation. wf-fix helps you correct that drift by updating the planning artifacts and recording the decisions that explain the “why”.

Core Features & Use Cases

  • Bug vs. requirement change detection: AI classifies the input as a bug fix or a requirement improvement and applies the right update pattern.
  • Synchronized documentation updates: updates spec.md and tasks.md (and decisions.md when needed) so the documentation remains the source of truth.
  • Controlled code changes via paths.code: directs code modifications through the configured code-repo path while keeping documentation files in the documentation repo.
  • Decision logging for traceability: appends a structured entry to decisions.md for requirement improvements, capturing rationale and impact.

Quick Start

Run wf-fix with your change request so it automatically updates spec.md and tasks.md (and decisions.md if it’s a requirement improvement) after validating you are in the documentation repository.

Frequently Asked Questions about wf-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep documentation and code synchronized when fixing bugs during iterative development?

To keep documentation and code synchronized during bug fixes, update planning artifacts like tasks.md to reflect the corrected behavior while routing code modifications strictly through the configured code repository path.

How do I update spec.md and decisions.md when requirements change during development?

When requirements change, update spec.md to reflect the new behavior and append a structured entry to decisions.md to capture the rationale and impact, ensuring the documentation remains the source of truth.

What is the difference between updating documentation for a bug fix versus a requirement improvement?

The difference between updating documentation for a bug fix versus a requirement improvement is that bug fixes only require updating tasks.md, while requirement improvements require updating spec.md and logging the decision in decisions.md.

Can I apply code changes and documentation updates in the same repository using workflow fixes?

Yes, you can apply code changes and documentation updates using workflow fixes by validating the repository type first, keeping documentation files in the documentation repo, and directing code edits only through the configured paths.code.

When should I use a documentation synchronization workflow for fixing development issues?

You should use a documentation synchronization workflow for fixing development issues when active changes exist after an iterative development step and you need to correct drift between planning artifacts and actual implementation.

Why does documentation drift from the actual implementation during iterative development?

Documentation drifts from the actual implementation during iterative development because requirements evolve and bugs appear over time, requiring synchronized updates to planning artifacts and decision logs to maintain traceability.