trace-production-issue

Trace production alerts to REQ-* requirements and generate remediation intents.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/foolishimp/ai_sdlc_method --skill trace-production-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace-production-issue
Source: https://github.com/foolishimp/ai_sdlc_method/tree/main/gemini-code/plugins/runtime-skills/skills/trace-production-issue
Command: npx skills add https://github.com/foolishimp/ai_sdlc_method --skill trace-production-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Actuator traces production alerts or issues back to the originating REQ-*, links to the original intent, and generates remediation intents.

Core Features & Use Cases

  • Alert-to-REQ Linking: Extracts REQ-* from production alerts.
  • Intent Traceability: Finds original intent and connects to remediation opportunities.
  • Remediation Intent: Creates a new remediation intent with context and linked requirements.

Quick Start

Trace a login latency alert to REQ-NFR-PERF-001 and create remediation INT-150.

Frequently Asked Questions about trace-production-issue

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

FAQPage Schema
How do I trace a production alert back to its original requirement?

Tracing production alerts to requirements involves extracting REQ-* identifiers from the alert, linking them to their original intent documentation, and cross-referencing the implementing code and commits. This Skill automates that extraction and traceability chain to show the complete path from alert to requirement.

What's the best way to close the feedback loop from production incidents to requirements?

Close the feedback loop by mapping production alerts to REQ-* requirements, identifying the original intent, and generating remediation intents with full traceability. This creates actionable directives that connect incident response back to the requirements and code that caused the issue.

Can I link production incidents directly to code commits and requirements?

Yes. By parsing production alerts for REQ-* identifiers and cross-referencing commits and intent documentation, you can establish direct links between incidents, their originating requirements, and the implementing code—enabling comprehensive incident-to-requirement traceability.

How do I create remediation intents from production alerts?

Generate remediation intents by extracting requirement identifiers from production alerts, tracing to original intents, and synthesizing a new remediation directive with full context. The Skill handles alert parsing, requirement linking, and intent generation to produce actionable remediation directives.

What information do I need to trace an issue from alert to requirement?

You need the production alert, REQ-* requirement identifiers embedded in or related to the alert, access to original intent documentation, and commit history. The Skill extracts and links these inputs to create complete traceability and generate remediation intents.

Why should I connect production alerts to requirements instead of just fixing the code?

Connecting alerts to requirements ensures you understand root causes, apply fixes consistently, and prevent recurrence by addressing the original intent. This closes the feedback loop, improves incident response quality, and strengthens the link between production behavior and design decisions.