tinysocs-failure-archaeology

Chronicles TinySocs repository failure history with verified commit SHAs, root causes, and statuses.

Updated Oct 12, 2025
One-click install
npx skills add https://github.com/lukefitzg/tinysocs --skill tinysocs-failure-archaeology-lukefitzg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tinysocs-failure-archaeology
Source: https://github.com/lukefitzg/tinysocs/tree/main/.claude/skills/tinysocs-failure-archaeology
Command: npx skills add https://github.com/lukefitzg/tinysocs --skill tinysocs-failure-archaeology-lukefitzg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on the TinySocs codebase, you often need to know whether a bug is a known recurrence or genuinely new, why code looks unusual, or how a subsystem reached its current state. This Skill provides a verified chronicle of every major investigation, revert, and recurring bug class across the repo's 366-commit history, so you avoid repeating past mistakes and misquoting superseded figures. ## Core Features & Use Cases - Episode-based failure catalog: Each entry follows a SYMPTOM -> ROOT CAUSE -> EVIDENCE -> STATUS structure with commit SHAs re-verified directly against the repository. - Recurring bug class tracking: Documents patterns like em-dash characters breaking PowerShell 5.1, stale MIT licence claims, doubled directories, and silently red CI, with their current status. - Timeline and pivot history: Maps commit-volume evidence across Oct 2025 to Jul 2026, including the April 2026 zero-commit gap and the v2 pivot restart. - Use Case: Before modifying the dashboard's inline script block, consult this Skill to learn that a two-script split was already tried and reverted (commit dd95fbd), and that a widget-load ordering test should be added first. ## Quick Start Ask the AI to check the TinySocs failure history to determine whether the bug you are investigating has occurred before and what its root cause was.

Frequently Asked Questions about tinysocs-failure-archaeology

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

FAQPage Schema
How do I check if a TinySocs bug has happened before?

Consult the failure archaeology chronicle, which catalogs every major investigation as symptom, root cause, evidence, and status entries with verified commit SHAs. It distinguishes known recurrences from genuinely new bugs in one lookup.

What recurring bug patterns exist in the TinySocs repository?

Documented recurring patterns include non-ASCII characters like em-dashes breaking PowerShell 5.1 scripts, stale MIT licence claims after the BSL switch, doubled directory structures from restructures, and CI silently failing for a month.

When should I not use the failure archaeology skill?

Do not use it for diagnosing a live symptom happening right now; that belongs to the debugging playbook skill. It is also not for scope decisions, which belong to change control, or for current design contracts, which belong to the architecture contract skill.

Why do PowerShell 5.1 scripts break with em-dash characters?

PowerShell 5.1 reads .ps1 files without a UTF-8 BOM using the system codepage Windows-1252. The em-dash byte 0x94 maps to a right-double-quote character, which PowerShell treats as a string delimiter, corrupting the rest of the line.

Can I quote the 100% detection efficacy figure from March 2026?

No, that figure is banned from quoting because it predates the pilot ruleset redefinitions and no longer describes the current ruleset. Every efficacy percentage in the repo's history has been superseded by a later, more honest measurement.