ck-debugging-playbook

Diagnose build, linker, AngelScript, and GC failures in CkFoundation ECS.

4|Updated Aug 15, 2023
One-click install
npx skills add https://github.com/chainkemists/CkFoundation --skill ck-debugging-playbook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ck-debugging-playbook
Source: https://github.com/chainkemists/CkFoundation/tree/main/.claude/skills/ck-debugging-playbook
Command: npx skills add https://github.com/chainkemists/CkFoundation --skill ck-debugging-playbook

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, symptom-first triage framework for resolving complex build, linker, AngelScript, and packaged-only failures in the CkFoundation ECS framework, preventing the destruction of diagnostic evidence through trial-and-error fixes.

Core Features & Use Cases

  • Triage Table: Quickly map specific error symptoms (e.g., LNK1104, UHT errors, GC crashes) to ranked causes and verified discriminating experiments.
  • Environment Diagnostics: Includes specific PowerShell probes for identifying DLL locks, stale build artifacts, and multi-session build collisions.
  • Packaged-Only Debugging: Provides a runbook for identifying and fixing GC lifetime violations that only manifest in cooked, non-editor builds.

Quick Start

Use the ck-debugging-playbook skill to diagnose a specific build or runtime error by describing the symptom and providing the relevant error log or code context.

Frequently Asked Questions about ck-debugging-playbook

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

FAQPage Schema
How do I fix Unreal Engine plugin LNK1104 linker errors during CkFoundation ECS builds?

Fix Unreal Engine plugin LNK1104 linker errors by using a symptom-first triage table to map the failure to ranked causes, running PowerShell probes to detect DLL locks, and clearing stale build artifacts before rebuilding.

Why does AngelScript garbage collection crash only in packaged Unreal Engine builds?

AngelScript garbage collection crashes in packaged Unreal Engine builds occur due to GC lifetime violations that remain hidden in the editor, requiring a specific packaged-only debugging runbook to identify and resolve the cooked build divergence.

What is the best way to triage UBT and UHT errors in Unreal Engine plugin development?

The best way to triage UBT and UHT errors is to follow a systematic diagnostic framework that maps specific error symptoms to verified discriminating experiments, preventing the destruction of diagnostic evidence through trial-and-error fixes.

Can I debug multi-session build collisions in CkFoundation without losing diagnostic evidence?

Debug multi-session build collisions in CkFoundation by running targeted environment diagnostics and PowerShell probes to identify concurrent build conflicts, ensuring you preserve diagnostic evidence by avoiding blind trial-and-error fixes.

Does the CkFoundation debugging playbook require a specific project layout to resolve build failures?

The CkFoundation debugging playbook requires adherence to the documented BusterBlock layout and specific CkFoundation build configuration standards to accurately diagnose environment-specific crashes and build failures.