reversa-resume

Swap a paused feature into active status using .reversa state files.

Updated May 5, 2026
One-click install
npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-resume-alexandrepontesjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-resume
Source: https://github.com/AlexandrePontesjr/calculadora-Juridica/tree/main/.agents/skills/reversa-resume
Command: npx skills add https://github.com/AlexandrePontesjr/calculadora-Juridica --skill reversa-resume-alexandrepontesjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Esta Skill resolve o problema de ficar com trabalho interrompido ao ter uma feature pausada, ajudando você a retomar a continuação correta sem criar nada novo nem apagar progresso.

Core Features & Use Cases

  • Retomada guiada de features pausadas: lista todas as entradas em paused-features, detecta o estágio físico (vazio/requirements/plan/coding-em-progresso/done) e permite que você escolha manualmente.
  • Swap seguro entre feature ativa e pausadas: troca a feature ativa pela escolhida, movendo o contexto para paused-features quando faz sentido e descartando do ativo quando estiver finalizada ou vazia.
  • Tratamento de “entry órfã”: se a pasta da feature pausada foi apagada, oferece a remoção dessa entry de paused-features (sem fazer swap).
  • Ganchos antes/depois: aplica before-resume e after-resume conforme as regras de hooks definidas no projeto.
  • Atualização atômica do estado: escreve active-requirements.json atomicamente usando estratégia de tempfile + rename para reduzir risco de corrupção.

Quick Start

Abra o diretório do projeto e execute o comando de ativação do Skill digitando /reversa-resume, depois selecione pelo número a feature pausada que você quer retomar.

Frequently Asked Questions about reversa-resume

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

FAQPage Schema
How do I resume a paused project feature without losing my current progress?

To resume a paused feature, you swap it with the currently active one safely and deterministically. The process updates the active-requirements.json file atomically and moves the previous active context to paused, preserving your progress.

What happens to the active feature when I switch to a paused one?

When you switch to a paused feature, the currently active feature is safely swapped into the paused-features list. If the active feature is finished or empty, it is discarded instead of being paused.

How do I handle orphan entries in paused-features if the directory was deleted?

When a paused feature directory is missing, the system identifies it as an orphan entry. You can safely remove the orphan from the paused-features list without performing any context swaps.

How are project state files updated during a feature resume to prevent corruption?

The active-requirements.json file is updated atomically during a feature resume. This process uses a tempfile and rename strategy to write the versioned state, significantly reducing the risk of file corruption.

Can I execute custom hooks before or after resuming a paused feature?

Yes, the feature resume process applies before-resume and after-resume hooks. These hooks are executed according to the specific rules defined within your project configuration.

Does the system detect the workflow stage of a paused feature automatically?

Yes, the system detects the physical stage of a paused feature automatically by reading its directory. It identifies whether the feature is empty, in requirements, in plan, coding in progress, or done.