reversa-sync

Generates post-coding addenda in _reversa_sdd/addenda to keep reverse-engineering extractions current.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-sync-lacsousa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-sync
Source: https://github.com/lacsousa/mediclaw-system/tree/main/.agents/skills/reversa-sync
Command: npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-sync-lacsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a feature is delivered in the Reversa forward cycle, the extraction artifacts in _reversa_sdd/ (architecture.md, domain.md) become stale because the code has already changed. This Skill closes that gap by distilling each delivered feature into a dated addendum, so anyone reading the extraction sees the system as it exists today—without modifying the original artifacts. ## Core Features & Use Cases - Addendum Generation: Creates a structured Markdown addendum per feature in _reversa_sdd/addenda/ with vigência tracking, delivery summary, and per-artifact impact tables. - Scenario Detection: Automatically distinguishes legacy scenarios (impacts mapped to architecture.md/domain.md sections) from greenfield scenarios (impacts mapped to prd.md and sdd/ specs). - Append-Only Updates: On re-execution for the same feature, appends a dated update section instead of overwriting, preserving the full synchronization history. - Use Case: After running /reversa-coding on a feature that changed a business rule, run this Skill to produce an addendum pointing readers to the new rule behavior until the next full /reversa re-extraction supersedes it. ## Quick Start Run the reversa-sync step after /reversa-coding completes to generate the feature addendum in _reversa_sdd/addenda.

Frequently Asked Questions about reversa-sync

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

FAQPage Schema
How do I keep reverse-engineering documentation in sync after coding a feature?▼

Run this Skill after /reversa-coding completes. It reads the feature's legacy-impact.md and generates a dated addendum in _reversa_sdd/addenda describing how each extraction artifact should now be read, bridging the gap until the next full re-extraction.

What is a Reversa addendum and when is it superseded?▼

An addendum is a per-feature Markdown file recording delivered impacts on extraction artifacts. It stays vigente (current) until the next /reversa re-extraction runs, which marks it as superseded and regenerates the extraction as the single source of truth.

Does reversa-sync modify the original architecture.md or domain.md files?▼

No. The Skill writes only to _reversa_sdd/addenda/ and treats architecture.md, domain.md, prd.md, specs, and feature artifacts as strictly read-only. The addendum annotates impacts rather than correcting the original extraction.

What happens if I run reversa-sync before /reversa-coding finishes?▼

If legacy-impact.md is missing, the Skill aborts and instructs you to run /reversa-coding first. If actions remain open in actions.md, it presents a menu letting you choose a partial sync, wait, or another option.

Can reversa-sync handle greenfield projects without legacy code?▼

Yes. It detects greenfield scenarios via the legacy-impact.md header or the presence of prd.md and sdd/ specs, then maps impacts to those artifacts with the componente-novo type instead of legacy architecture and domain sections.