Verified:GitHub

reversa-principles

Manage durable project principles with consistent numbering and audited history.

Updated May 5, 2026

Search Tags:#governance #principles #human-in-the-loop #project consistency #reversa #template impact #versioned documentation

Ready to run

npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-principles-alexandrepontesjr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reversa-principles
Source: https://github.com/AlexandrePontesjr/calculadora-Juridica/tree/main/.agents/skills/reversa-principles
Command: npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-principles-alexandrepontesjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps long-lived project principles consistent, traceable, and safely propagated across dependent templates to prevent drift and misalignment.

Core Features & Use Cases

Create or update durable principles: Collect new principles, revise existing ones without breaking numbering, or retire principles while preserving history.
Controlled impact propagation: Generates a dated impact report and provides textual suggestions for template adjustments instead of rewriting templates automatically.
Pipeline-safe governance: Runs independently of feature pipelines and supports bootstrapping even before the first feature.

Quick Start

Ask the agent to run reversa-principles to create or update the project’s durable principles and generate an impact report for affected templates.

Frequently Asked Questions about reversa-principles

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

FAQPage Schema

How do I manage durable project principles without breaking existing numbering?▼

Project principles governance involves standardizing durable rules that guide long-lived project decisions. The Reversa principles skill manages this by updating .reversa/principles.md with consistent numbering, ensuring long-lived project principles remain traceable and aligned across dependent templates.

What is the best way to propagate project governance changes to dependent templates?▼

Propagating governance changes safely requires generating a timestamped principles-impact report. This skill assesses affected templates and provides textual suggestions for adjustments, prompting human-in-the-loop decisions rather than automatically rewriting dependent template files.

When do I need to establish project principles in the governance workflow?▼

You need to establish project principles before any feature work starts. This skill runs independently of feature pipelines, supporting governance bootstrapping early to ensure project consistency and prevent template drift before development begins.

Can I retire project principles without losing the audited history?▼

Yes, you can retire project principles without losing the audited history. This skill safely retires principles while preserving their historical context within the versioned documentation, maintaining full traceability and consistent numbering in the .reversa/principles.md file.

Does the Reversa principles skill automatically rewrite dependent templates?▼

No, the Reversa principles skill does not automatically rewrite dependent templates. It follows human-in-the-loop conventions by generating a dated principles-impact report with textual suggestions, prompting for human decisions on applying the suggested template adjustments.