freeshard-failure-archaeology

Chronicle historical incidents and settled decisions in the Freeshard project.

47|2|Updated Feb 11, 2025
One-click install
npx skills add https://github.com/FreeshardBase/freeshard --skill freeshard-failure-archaeology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freeshard-failure-archaeology
Source: https://github.com/FreeshardBase/freeshard/tree/main/.claude/skills/freeshard-failure-archaeology
Command: npx skills add https://github.com/FreeshardBase/freeshard --skill freeshard-failure-archaeology

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents the repetition of historical technical failures, dead-end development branches, and rejected architectural decisions within the Freeshard project.

Core Features & Use Cases

  • Incident Chronicle: Provides a searchable history of major outages, including rclone backup failures, database migration issues, and Traefik proxy incidents.
  • Decision Guardrails: Documents settled architectural choices, such as the rejection of Authelia and the move to embedded OIDC, preventing wasted effort on abandoned paths.
  • Use Case: Before starting work on storage or backup systems, use this Skill to review the specific "standing rules" and known traps to ensure your implementation avoids recurring bugs like silent CronTask death or incorrect rclone log parsing.

Quick Start

Trigger the freeshard-failure-archaeology skill to review the known failure patterns and standing rules before modifying the backup or database subsystems.

Frequently Asked Questions about freeshard-failure-archaeology

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

FAQPage Schema
What is a post-mortem incident chronicle for Freeshard infrastructure?

A post-mortem incident chronicle records historical outages and rejected architectural decisions within the Freeshard project. It documents major failures like rclone backup issues and Traefik proxy incidents to prevent repeating past technical mistakes.

How do I prevent recurring rclone backup failures in my infrastructure?

To prevent rclone backup failures, review the archived incident chronicle for known traps like incorrect log parsing and silent CronTask death. It provides specific standing rules to ensure your backup pipeline implementation avoids previously resolved bugs.

Why does the Freeshard project use embedded OIDC instead of Authelia?

Freeshard uses embedded OIDC because Authelia was a rejected architectural decision. Reviewing the decision guardrails reveals this settled choice, preventing wasted development effort on abandoned integration paths.

How do I check standing rules before modifying database migration systems?

Check standing rules by triggering the failure archaeology skill to review known failure patterns before modifying database subsystems. This ensures your infrastructure migration complies with established guardrails and avoids historical database migration issues.

What are the limitations of relying on historical architectural decisions for debugging?

The limitation is that historical records only prevent re-introducing resolved bugs and abandoned paths; they do not address novel infrastructure issues. You must still actively debug new incidents while using the chronicle to avoid repeating known Traefik or rclone failures.