pyrs-sane

Audit pyramid structures for conceptual alignment and drift across software architecture.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/zachbutton/pyrs --skill pyrs-sane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pyrs-sane
Source: https://github.com/zachbutton/pyrs/tree/main/skills/pyrs-sane
Command: npx skills add https://github.com/zachbutton/pyrs --skill pyrs-sane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps maintain conceptual alignment in software architecture by checking the consistency of pyramid references across different levels of the hierarchy.

Core Features & Use Cases

  • Conceptual Alignment Check: Ensures that pyramid references are consistent with their parent pyramids.
  • Drift Detection: Identifies and reports on conceptual drift between a pyramid and its parents.
  • Audit Loop: Provides a structured process for auditing and reconciling discrepancies.
  • Use Case: Before deploying changes to the codebase, use this Skill to ensure that all pyramid references are in line with the system's conceptual model.

Quick Start

Run the ::sane @.event-bus command to check the conceptual alignment of the event-bus pyramid.

Frequently Asked Questions about pyrs-sane

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

FAQPage Schema
How do I check conceptual alignment in software architecture pyramid structures?

To check conceptual alignment in software architecture, you audit pyramid references against their parent pyramids. This process verifies consistency across hierarchy levels and highlights any conceptual drift before system changes are deployed.

What is conceptual drift in pyramid architecture and how do I detect it?

Conceptual drift in pyramid architecture happens when lower-level pyramid references diverge from their parent pyramids. You detect it by running an audit loop that identifies discrepancies between the system's conceptual model and the actual hierarchy.

How do I audit pyramid references for consistency before deploying codebase changes?

You audit pyramid references by running a targeted check command against the specific pyramid, like the event-bus. This initiates a structured audit loop that guides you through reconciling any discrepancies found before deployment.

Can I reconcile discrepancies between a pyramid and its parent pyramids automatically?

You can identify discrepancies automatically, but reconciliation requires user guidance. The audit loop detects conceptual drift and then walks you through a structured process to manually reconcile the inconsistencies with the parent pyramid.

Does this architecture audit require any external dependencies to run?

This architecture audit does not require any external dependencies to run. It operates independently using scripts to check the conceptual alignment of pyramid references within your software architecture.