sparkengine-failure-archaeology

Documents SparkEngine's solved bugs with symptoms, root causes, fix commits, and current status.

31|3|Updated Jul 26, 2025
One-click install
npx skills add https://github.com/Krilliac/SparkEngine --skill sparkengine-failure-archaeology-krilliac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sparkengine-failure-archaeology
Source: https://github.com/Krilliac/SparkEngine/tree/main/.claude/skills/sparkengine-failure-archaeology
Command: npx skills add https://github.com/Krilliac/SparkEngine --skill sparkengine-failure-archaeology-krilliac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When debugging SparkEngine, engineers risk re-investigating bugs that were already solved or retrying approaches that already failed expensively. This Skill provides a chronological case-file of the engine's hardest historical bugs so you can check whether a symptom was fixed before, find the exact fix commit, and avoid repeating failed strategies. ## Core Features & Use Cases - Incident history with commit hashes: Each entry records the symptom, root cause, the exact fix commit (verifiable via git show), and current landed/open status across eras covering the Great Revert, ICF type-id folding, DLL/module lifetime crashes, editor undo convergence, and networking trust-boundary fixes. - Failed-approach registry: Documents approaches that must not be retried in the same shape, such as the big-bang abstraction migration reverted in 7851ee38. - Deferred-work ledger: Tracks which harden-fleet items remain open (e.g., the NetworkManager per-module fallback, ConsoleApp.cpp split) versus those already landed. - Use Case: A Windows Release-only CI failure reappears and feels familiar. Consult this Skill to discover it matches the /OPT:ICF type-id folding incident fixed in 21b1a689, then run git show 21b1a689 for the full reasoning instead of re-debugging from scratch. ## Quick Start Ask whether the bug you are investigating has happened before in SparkEngine and request the fix commit and current status for that incident.

Frequently Asked Questions about sparkengine-failure-archaeology

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

FAQPage Schema
How do I check if a SparkEngine bug was already fixed before?

Search this case-file for the symptom or subsystem, then verify the cited fix commit with git show <hash> and confirm it is an ancestor of HEAD via git merge-base --is-ancestor. Each entry lists symptom, root cause, fix commit, and current status.

What is the difference between this skill and the debugging playbook?

This skill is a chronological history of past incidents and failed approaches, while sparkengine-debugging-playbook provides symptom-to-fix triage for new live bugs. Use the playbook for a brand-new symptom; use this skill to avoid re-solving solved problems.

Why does a Release-only test failure happen when Debug passes?

A documented cause is MSVC /OPT:ICF folding byte-identical COMDATs, which collapsed all GetTypeId<T>() addresses to one in Release builds. The fix uses a non-const static char marker; see commit 21b1a689 for full reasoning.

Which harden-fleet deferred items are still open in SparkEngine?

The ledger lists two open items: the intentional NetworkManager per-module fallback kept for bootstrap, and the ConsoleApp.cpp split with a hardcoded version string. Most other deferred items were resolved in commits 52636dda, 4b42b8d9, and c412f05b.

When should I not use this failure history skill?

Do not use it for a brand-new live symptom needing a fix recipe; that belongs in the debugging playbook. It also does not cover build/CI mechanics, DLL ABI rules going forward, or test-suite health, which have their own sibling skills.