zeus-debugging-playbook

Diagnose recurring Zeus Lightning wallet failures using a symptom-to-triage table.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-debugging-playbook-aswin-dev-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zeus-debugging-playbook
Source: https://github.com/aswin-dev-debug/Ai-Finance-analyzer/tree/main/lib/zeus-contrib/zeus/.claude/skills/zeus-debugging-playbook
Command: npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-debugging-playbook-aswin-dev-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging the Zeus Lightning wallet involves recurring, non-obvious failure modes: features that silently no-op on certain backends, settings that vanish after updates, CI checks that fail despite passing locally, and native crashes in embedded LND. This Skill maps each known symptom directly to its first check, likely cause, and fix pattern, eliminating hours of blind investigation. ## Core Features & Use Cases - Symptom-to-Triage Table: Sixteen documented failure modes (silent no-ops, .then is not a function errors, stuck connecting screens, Tor dedup-cache replay, Hermes regex stack overflows, Fabric layout crashes) each paired with discriminating experiments and fix patterns. - Discriminating Experiments: Concrete grep commands and runtime checks to distinguish root causes, such as telling a missing backend method apart from a missing supports*() capability gate. - Provenance & Re-verification: Every cited commit hash and code fact ships with a one-liner command to re-verify it against the current master branch. - Use Case: A developer sees TypeError: x.then is not a function on the LndHub backend. The playbook identifies that BackendUtils.call() returns false synchronously for missing methods, and provides the exact grep commands to confirm and gate the feature correctly. ## Quick Start Ask the assistant to triage your Zeus bug by describing the symptom, for example: my Zeus app is stuck on the connecting screen after the latest update, help me find the cause.

Frequently Asked Questions about zeus-debugging-playbook

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

FAQPage Schema
How do I debug a Zeus feature that silently does nothing?

Check whether the active backend class implements the method by grepping backends/<ActiveBackend>.ts. BackendUtils.call() returns false synchronously for missing methods, so also verify the view gates the feature behind the correct supports*() capability flag.

Why does Zeus CI lint fail when eslint passes locally?

The yarn lint script runs eslint plus a Jest test called check-styles.test.ts that bans themeColor() inside static StyleSheet.create blocks. Run yarn lint locally instead of bare eslint to reproduce the failure.

Why did Zeus user settings disappear after an app update?

SettingsStore.updateSettings performs a shallow top-level merge, so passing a partial nested group replaces the entire group. The fix spreads the existing group, for example updateSettings({ payments: { ...settings.payments, newField } }).

Why does the same Tor request error repeat instantly on retry in Zeus?

The Tor branch of restReq in backends/LND.ts and CLNRest.ts deletes the dedup-cache entry only on success, so rejected promises stay cached and replay. Reconnecting clears the cache via BackendUtils.clearCachedCalls().

When should I not use the Zeus debugging playbook?

Do not use it for build environment setup, log capture tooling, full incident histories, storage migrations, or the node lifecycle race problem. Each of those belongs to a dedicated sibling skill such as zeus-build-and-env or zeus-failure-archaeology.