pyrs-diff

Compare code against pyramid specifications and manage diff sidecars.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyrs-foundation, and includes scripts (resource) components.

What problem does it solve?

The pyrs-diff skill helps identify discrepancies between code and pyramid specifications, ensuring that code aligns with the intended architecture and contracts.

Core Features & Use Cases

  • Code Pyramid Comparison: Compare code against pyramid specifications to detect drift and discrepancies.
  • Unresolved Gap Diff Management: Generate and manage diff sidecars that document unresolved discrepancies.
  • Audit Loop Integration: Integrate with the audit loop to provide evidence-backed findings and recommendations.
  • Change Flow Handoff: Connect users to the appropriate commands for resolving discrepancies.

Quick Start

To initiate a diff comparison for a specific pyramid, use the command ::diff @.event-bus.

Frequently Asked Questions about pyrs-diff

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

FAQPage Schema
How do I detect architectural drift between code and pyramid specifications?

You detect drift by comparing code against pyramid specifications, which identifies discrepancies where implementation diverges from intended architecture and contracts.

What is the best way to manage unresolved discrepancies found during a code comparison?

The best way to manage unresolved discrepancies is by generating and managing diff sidecars. These sidecars document the gaps for later resolution within the architectural audit loop.

Do I need pyrs-foundation to run pyramid alignment checks?

Yes, you need pyrs-foundation to run pyramid alignment checks. It is a required dependency for executing code comparisons and managing the architectural diff sidecars.

How does code comparison integrate with the audit loop for architectural contracts?

Code comparison integrates with the audit loop by providing evidence-backed findings and recommendations. This ensures identified discrepancies are tracked and resolved through change flow handoffs.

How do I initiate a diff comparison for a specific pyramid specification?

You initiate a diff comparison for a specific pyramid specification by using the command `::diff @.event-bus`, passing the target pyramid to check for alignment.