story-remediation

Automate remediation of audit findings in story, epic, and context files.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/bankielewicz/DevForgeAI --skill story-remediation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-remediation
Source: https://github.com/bankielewicz/DevForgeAI/tree/main/.claude/skills/story-remediation
Command: npx skills add https://github.com/bankielewicz/DevForgeAI --skill story-remediation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automatically identifies and fixes issues found in story, epic, and context files during the audit process, ensuring code quality and consistency.

Core Features & Use Cases

  • Automated Fixes: Applies safe, deterministic fixes for common issues like broken file references or stale status labels.
  • Guided Interactive Fixes: For complex issues, it guides you through the resolution process with clear options and confirmations.
  • Audit Remediation: Directly addresses findings from the /validate-stories audit, streamlining the correction workflow.
  • Use Case: After running /validate-stories, you find several quality/broken_file_reference findings. Running /fix-story with the relevant audit file will automatically correct these broken links, saving you manual search and replace operations.

Quick Start

Use the story-remediation skill to fix all findings listed in the audit report 'audit-results.md'.

Frequently Asked Questions about story-remediation

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

FAQPage Schema
How do I fix broken file references and missing frontmatter in story files?

To fix broken file references and missing frontmatter in story files, you need an automated remediation process that classifies audit findings and applies deterministic fixes to correct file paths and restore metadata. This Skill automates that correction workflow using a structured audit file.

What is story and epic audit remediation in software engineering?

Story and epic audit remediation is the process of resolving validation findings related to broken file references, stale status labels, and context path errors. It classifies issues to apply automated fixes or guide interactive resolutions to maintain code quality.

How do I resolve stale status labels and context file path errors after a validation audit?

You can resolve stale status labels and context file path errors by running an automated remediation tool with the audit results file. It directly addresses these findings by applying safe fixes or guiding you through interactive resolution steps.

Can I automatically apply fixes for all findings listed in a validation audit report?

Yes, you can automatically apply fixes for safe, deterministic issues like broken file references listed in an audit report. For complex findings, the remediation process provides guided interactive resolutions with clear options and confirmations.

Do I need a structured audit file to remediate story and epic validation findings?

Yes, you need a structured audit file detailing findings and remediation steps to automate the correction of story and epic files. The remediation process relies on this input to classify issues and verify applied changes across project files.

What are the limitations of automated story file remediation?

Automated story file remediation is limited to safe, deterministic fixes for common issues like broken references. Complex findings cannot be fully automated and require guided interactive resolutions with manual confirmation to ensure correct changes.