Use when updating, reviewing, prioritizing, or turning ideas into tasks for this repository's ROADMAP.md. Applies to roadmap status markers, dependency-aware ordering, scope clarification, completion criteria, and keeping README.md or CHANGELOG.md aligned with shipped roadmap work.
Install
mkdir -p .claude/skills/roadmap-maintainer && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13554" && unzip -o skill.zip -d .claude/skills/roadmap-maintainer && rm skill.zipInstalls to .claude/skills/roadmap-maintainer
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use when updating, reviewing, prioritizing, or turning ideas into tasks for this repository's ROADMAP.md. Applies to roadmap status markers, dependency-aware ordering, scope clarification, completion criteria, and keeping README.md or CHANGELOG.md aligned with shipped roadmap work.About this skill
Roadmap Maintainer
Use this skill when the user asks to add to, revise, prioritize, review, or turn
items from ROADMAP.md into implementation tasks.
Workflow
- Read
ROADMAP.mdbefore changing roadmap content. - Preserve dependency-aware priority order unless the user asks to reorganize it.
- Place new items in the earliest section where their prerequisites are already represented.
- Clarify vague ideas into implementation-facing roadmap bullets.
- Prefer small, independently shippable items over broad bundled initiatives.
- Check for duplicates before adding new items.
- Keep wording high level, but include enough scope to avoid later ambiguity.
Status Markers
- Use
[ ]for planned work. - Use
[~]for work in progress. - Use
[x]for shipped work. - Use
[?]for research or decision items. - Check completed items off in place instead of moving them to a separate completed section.
Prioritization Rules
Order work to minimize blockers, dependencies, and conflicts:
- Privacy, storage, data model, and documentation foundations.
- Recording reliability and user feedback.
- Transcript correction, dictionaries, and profile primitives.
- File workflows, search, import/export, batch jobs, and CLI.
- Local and remote post-processing providers.
- Advanced transcription and app-aware workflows.
- Distribution, updates, onboarding, CI, and operational polish.
If a feature affects privacy, storage, transcript metadata, import/export, CLI, or post-processing, make sure the relevant foundation is already captured before placing the feature later in the roadmap.
Completion Hygiene
When a roadmap item ships:
- Mark it
[x]inROADMAP.md. - Add or update user-facing documentation in
README.mdwhen users need to know how to use the behavior. - Add a
CHANGELOG.mdentry for shipped user-facing behavior when appropriate. - Prune completed roadmap items only after the shipped behavior is documented.
Task Breakdown Guidance
When turning roadmap items into tasks, include:
- Prerequisites and dependencies.
- Suggested implementation order.
- Acceptance criteria.
- Privacy/security implications.
- Documentation and changelog updates.
- Focused verification steps.