aif-roadmap

Creates and maintains a project roadmap of high-level milestones in a Markdown artifact.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/1t1sCooL/zazyvala-bot --skill aif-roadmap-1t1scool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-roadmap
Source: https://github.com/1t1sCooL/zazyvala-bot/tree/main/.cursor/skills/aif-roadmap
Command: npx skills add https://github.com/1t1sCooL/zazyvala-bot --skill aif-roadmap-1t1scool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose track of strategic direction when project goals live only in scattered notes or memory. This Skill generates and maintains a structured ROADMAP.md file that tracks major milestones, completion status, and project history in one place. ## Core Features & Use Cases - Roadmap Creation: Generates a milestone checklist from your project vision or by analyzing the existing codebase for completed work. - Progress Checking: Scans the codebase and git history to detect which milestones are done, in progress, or not started, then marks them complete with dates. - Roadmap Maintenance: Adds, reprioritizes, or revises milestones interactively while preserving a Completed table with dates. - Use Case: After bootstrapping a NestJS Telegram bot, run the skill to produce a roadmap of 5-15 milestones, then later run it in check mode to automatically mark finished milestones based on code evidence. ## Quick Start Ask the AI to create a project roadmap for this repository based on the current codebase and my product vision.

Frequently Asked Questions about aif-roadmap

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

FAQPage Schema
How do I create a project roadmap from an existing codebase?

Run the skill without arguments and choose the codebase analysis option. It scans project structure, implemented features, and recent git commits to suggest milestones, marking already-finished work as complete with today's date.

How to check roadmap progress automatically against my code?

Invoke the skill with the check argument. It reads the roadmap, searches for evidence of each unchecked milestone using file patterns and git log, then reports items as done, in progress, or not started before marking confirmed completions.

What is the difference between a roadmap milestone and a task?

Milestones are high-level goals representing major features or capabilities, typically 5-15 per project. Granular implementation tasks belong to a separate planning step, not the roadmap, which only tracks strategic progress.

Can I customize where the roadmap file is saved?

Yes. The skill reads a config.yaml file to resolve the roadmap output path and language settings. If no config exists, it defaults to writing ROADMAP.md inside the .ai-factory directory in English.

When should I not use a milestone-based roadmap?

Avoid it for single-task fixes or day-to-day sprint tracking, since milestones are meant for major capabilities. Use issue trackers or task-level planning tools for granular work instead.