reversa-to-do

Decompose roadmap items into atomic actions with dependencies and parallel hints.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-to-do-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-to-do
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-to-do
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-to-do-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of translating a high-level roadmap into an executable, atomic to-do plan with stable IDs, explicit dependencies, and clear parallelization markers.

Core Features & Use Cases

  • Roadmap → Atomic Actions: Decomposes each roadmap item into single-turn, coherent actions suitable for agent execution.
  • Stable Execution Plan: Generates sequential IDs (T001, T002, …), dependency mapping, and per-action primary target file tracking.
  • Parallelism Guidance: Marks tasks that can run in parallel when they touch different files and do not depend on each other.
  • Guardrails via Validations: Ensures required inputs exist (active requirements and roadmap), aborting with clear guidance when prerequisites are missing.

Quick Start

Use the command "/reversa-to-do" after you have prepared the roadmap with "/reversa-plan" so the Skill can generate feature-dir/actions.md.

Frequently Asked Questions about reversa-to-do

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

FAQPage Schema
How do I convert a roadmap into parallel-ready tasks for agent execution?

To convert a roadmap into executable actions, load the roadmap.md file and decompose each item into single-turn atomic actions. The process generates sequential IDs, dependency mappings, and per-action file tracking, outputting a complete actions.md file for agent execution.

What is task decomposition with a dependency graph for agent planning?

Task decomposition with a dependency graph breaks feature work into atomic actions linked by explicit dependencies. This mechanism ensures agent-driven implementation follows clear sequencing across phases while marking independent tasks touching different files for parallel execution.

Do I need a state.json file to generate an actions.md task plan?

Yes, generating an actions.md task plan requires reading .reversa/state.json for output paths and validating .reversa/active-requirements.json. The process aborts with clear guidance if these prerequisite inputs are missing, ensuring the roadmap has proper context before decomposition begins.

How are parallel execution hints determined when decomposing tasks?

Parallel execution hints are determined by checking if tasks touch different files and have no explicit dependencies on each other. Tasks meeting both criteria get marked for parallel execution, enabling efficient agent-driven implementation without file conflicts or sequencing blockages.

What happens if active requirements are missing when preparing a task plan?

When active requirements are missing, the task plan generation aborts with clear guidance. The validation checks .reversa/active-requirements.json before processing the roadmap, ensuring all prerequisite inputs exist and preventing incomplete action generation.

Can I apply custom hooks before or after generating the actions.md plan?

Yes, custom hooks can be applied before and after generating the actions.md plan. The Skill applies before-to-do and after-to-do hooks during the roadmap decomposition process, enabling customization of the task generation workflow and output handling.