Promote todo.txt to OpenSpec

Arcantry 1.0.0promote-todo-to-openspec

Group selected todo.txt items into privacy-safe OpenSpec transformations and hold every proposed change for approval.

When to use

Group and transform selected todo.txt items into approval-gated OpenSpec changes while preserving privacy and avoiding one-to-one promotion assumptions.

Link this skill

arcantry skills link promote-todo-to-openspec --scope user

The standard destination is ~/.agents/skills. Codex reads this universal Agent Skills location directly.

Claude compatibility

arcantry skills link promote-todo-to-openspec --scope user --compat claude

This keeps the universal link and adds a Claude alias to the same canonical package.

Compatibility

Source kinds: openspec, todo-txt.

Learning outcomes

• Classify todo.txt items before deciding whether they belong in OpenSpec.
• Propose zero-to-many and many-to-many transformations without losing operational or private work.

Examples

Review a mixed todo queue

Prompt

Use the promote-todo-to-openspec skill to classify this todo.txt and propose separate transformations for my approval before changing files.

Expected outcome

Every item is accounted for while operational, unclear, private, and sensitive work remains outside shared specifications.

Consolidate overlapping product intent

Prompt

Use the promote-todo-to-openspec skill to map these overlapping todo.txt entries into existing or new OpenSpec changes without assuming one-to-one promotion.

Expected outcome

A coverage ledger presents merge, split, relocation, and preservation choices that can be accepted independently.