freeshard-domain-reference

Document Freeshard Shard Core control-plane protocols and architectural contracts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides the essential technical theory and architectural context required to safely modify, debug, or extend the Shard Core control-plane without violating critical system contracts.

Core Features & Use Cases

  • Protocol Deep-Dives: Understands the mechanics of RSA-PSS HTTP message signatures, Traefik forwardAuth, and terminal JWT pairing.
  • Operational Guardrails: Explains the specific constraints of rclone backups, Docker Compose orchestration, and yoyo-migrations to prevent production outages.
  • Use Case: When investigating why peer authentication is failing or why a new app container is failing to mount volumes, this Skill provides the exact file-level references and "classic mistakes" to avoid.

Quick Start

Ask the freeshard-domain-reference skill to explain the protocol mechanics for peer signature authentication and the associated file locations in the codebase.

Frequently Asked Questions about freeshard-domain-reference

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

FAQPage Schema
How does RSA-PSS HTTP message signature authentication work in a FastAPI control-plane?

RSA-PSS HTTP message signatures authenticate peers by cryptographically signing request payloads. This Skill provides the exact protocol mechanics and file-level codebase references for implementing and debugging these signatures within the Freeshard Shard Core.

Why is my Traefik forwardAuth configuration failing to route traffic to my Docker Compose app containers?

Traefik forwardAuth failures often stem from misconfigured terminal JWT pairing or volume mounting mistakes. This Skill provides operational guardrails and classic mistake references for debugging Traefik and Docker Compose orchestration issues.

How do I safely debug database transaction semantics and Pydantic v2 data modeling without violating wire contracts?

Safely debugging database transaction semantics and Pydantic v2 models requires strict adherence to established wire contracts. This Skill documents the specific architectural constraints and data modeling standards to prevent contract violations during development.

What are the limitations and common mistakes when configuring yoyo-migrations and rclone backups for production?

Limitations of yoyo-migrations and rclone backups include specific operational constraints that can cause production outages if ignored. This Skill explains these exact guardrails to prevent data loss and ensure safe backup orchestration.

Can I use this architectural reference to investigate peer authentication failures in my FastAPI proxy?

Yes, you can use this reference to investigate peer authentication failures in your FastAPI proxy. It provides the architectural documentation needed to trace RSA-PSS signature validation and terminal JWT pairing logic across the codebase.