Multi-Role Spec and Task Breakdown
mylukin/agent-foreman
Runs a requirement through four research-backed specialist agents, a PM, a UX designer, a tech architect and QA, to produce implementable tasks.
Generate phased implementation roadmaps with Epic/Story/Task breakdown, effort estimates, and validation checkpoints.
$ npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install alirezarezvani/claude-cto-team roadmap-generator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/roadmap-generator .claude/skills/roadmap-generator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "roadmap-generator" agent skill from https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generator into .claude/skills/roadmap-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "roadmap-generator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install alirezarezvani/claude-cto-team roadmap-generator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/roadmap-generator .agents/skills/roadmap-generator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "roadmap-generator" agent skill from https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generator into .agents/skills/roadmap-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "roadmap-generator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install alirezarezvani/claude-cto-team roadmap-generator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/roadmap-generator .cursor/skills/roadmap-generator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "roadmap-generator" agent skill from https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generator into .cursor/skills/roadmap-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "roadmap-generator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/alirezarezvani/claude-cto-team.git --path skills/roadmap-generator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install alirezarezvani/claude-cto-team roadmap-generator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/roadmap-generator .gemini/skills/roadmap-generator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "roadmap-generator" agent skill from https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generator into .gemini/skills/roadmap-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "roadmap-generator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install alirezarezvani/claude-cto-team roadmap-generatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/roadmap-generator .github/skills/roadmap-generator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "roadmap-generator" agent skill from https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generator into .github/skills/roadmap-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "roadmap-generator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install alirezarezvani/claude-cto-team roadmap-generator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/roadmap-generator .opencode/skills/roadmap-generator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "roadmap-generator" agent skill from https://github.com/alirezarezvani/claude-cto-team/tree/main/skills/roadmap-generator into .opencode/skills/roadmap-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "roadmap-generator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
roadmap-generatorGenerate phased implementation roadmaps with Epic/Story/Task breakdown, effort estimates, and validation checkpoints.
Roadmap Generator is an agent skill from alirezarezvani/claude-cto-team. Generate phased implementation roadmaps with Epic/Story/Task breakdown, effort estimates, and validation checkpoints. Use when cto-architect needs to create actionable technical roadmaps from architecture designs.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `estimation-guide.md` and `generator.py`).
It sits in Agent Workflows, covering Task breakdown. The repository describes itself as: Your personal CTO Team for Claude Code . These Subagents will help you challenging yourself while you plan and execute. The licence is MIT.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit a5bbb78. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships script files (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Roadmap Generator loads about 1.9k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 475 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from alirezarezvani/claude-cto-team at commit a5bbb78, republished under its MIT licence (© alirezarezvani). 475 words, ~1,852 tokens.
.claude/skills/roadmap-generator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.Creates structured implementation roadmaps that transform architecture designs into actionable plans with clear phases, milestones, and validation gates.
Every roadmap follows MVP → Scale → Advanced phases:
Phase 1: MVP (Foundation)
├── Goal: Prove core value proposition
├── Duration: Typically 6-12 weeks
├── Success Criteria: Core functionality working
└── Exit Gate: User validation / metrics threshold
Phase 2: Scale (Growth)
├── Goal: Handle production load, improve reliability
├── Duration: Typically 8-16 weeks
├── Success Criteria: Performance SLAs met
└── Exit Gate: Load testing passed / uptime targets
Phase 3: Advanced (Optimization)
├── Goal: Competitive features, optimization
├── Duration: Ongoing
├── Success Criteria: Feature parity / differentiation
└── Exit Gate: Business metrics achievedHigh-level capability that delivers business value.
User-facing functionality within an epic.
Technical work to complete a story.
| Size | Story Points | Typical Duration | Characteristics |
|---|---|---|---|
| XS | 1 | 2-4 hours | Trivial change, no unknowns |
| S | 2 | 0.5-1 day | Simple, well-understood |
| M | 3 | 1-2 days | Some complexity, minor unknowns |
| L | 5 | 3-5 days | Complex, some research needed |
| XL | 8 | 1-2 weeks | Very complex, significant unknowns |
| XXL | 13+ | > 2 weeks | Should be broken down |
Effective Capacity = Team Size × Working Days × Focus Factor × Skill Factor
Focus Factor:
- Dedicated team: 0.8
- 50% allocated: 0.4
- Ad-hoc: 0.2
Skill Factor:
- Expert team: 1.0
- Experienced: 0.8
- Learning curve: 0.5Each phase ends with a validation gate:
## Phase 1 Exit Gate
### Go Criteria
- [ ] Core features functional in staging
- [ ] Unit test coverage > 70%
- [ ] Integration tests passing
- [ ] Performance baseline established
- [ ] Security review completed
### No-Go Signals
- Critical bugs unresolved
- Core functionality missing
- Team capacity insufficient for Phase 2
- Business requirements changed significantly
### Decision
[ ] GO - Proceed to Phase 2
[ ] CONDITIONAL GO - Proceed with identified risks
[ ] NO-GO - Address blockers first| Type | Description | Mitigation |
|---|---|---|
| Technical | Service A needs Service B | Start B early, use mocks |
| Team | Need DevOps for deployment | Reserve capacity early |
| External | Third-party API integration | Validate early, have fallback |
| Data | Need production data for testing | Create synthetic data |
# Implementation Roadmap: [Project Name]
**Created**: [Date]
**Owner**: [Team/Person]
**Architecture Reference**: [Link to architecture doc]
## Executive Summary
[2-3 sentences on approach and timeline]
## Timeline Overview
[Visual timeline or Gantt representation]
## Phase 1: MVP (Weeks 1-8)
### Phase Goals
- [Goal 1]
- [Goal 2]
### Epics
#### Epic 1.1: [Name]
**Duration**: [X weeks]
**Dependencies**: [List]
| Story | Points | Owner | Dependencies |
|-------|--------|-------|--------------|
| [Story 1] | M | [Team] | None |
| [Story 2] | L | [Team] | Story 1 |
**Tasks for Story 1**:
- [ ] [Task 1] (S)
- [ ] [Task 2] (M)
### Phase 1 Exit Criteria
- [ ] [Criterion 1]
- [ ] [Criterion 2]
### Phase 1 Risks
| Risk | Probability | Impact | Mitigation |
|------|-------------|--------|------------|
| [Risk] | High/Med/Low | High/Med/Low | [Action] |
---
## Phase 2: Scale (Weeks 9-16)
[Same structure as Phase 1]
---
## Phase 3: Advanced (Weeks 17+)
[Same structure as Phase 1]
---
## Resource Requirements
### Team Composition
| Role | Phase 1 | Phase 2 | Phase 3 |
|------|---------|---------|---------|
| Backend | 2 FTE | 3 FTE | 2 FTE |
| Frontend | 1 FTE | 2 FTE | 1 FTE |
| DevOps | 0.5 FTE | 1 FTE | 0.5 FTE |
### Infrastructure Costs
| Phase | Monthly Cost | Notes |
|-------|-------------|-------|
| Phase 1 | $X | Development environment |
| Phase 2 | $Y | Staging + production |
| Phase 3 | $Z | Full scale |
---
## Success Metrics
| Metric | Phase 1 Target | Phase 2 Target | Phase 3 Target |
|--------|---------------|----------------|----------------|
| [Metric 1] | [Value] | [Value] | [Value] |
| [Metric 2] | [Value] | [Value] | [Value] |
---
## Appendix
### Assumptions
- [Assumption 1]
- [Assumption 2]
### Open Questions
- [Question 1]
- [Question 2]Planning everything in detail upfront without iteration. Fix: Plan Phase 1 in detail, Phase 2 at epic level, Phase 3 at theme level.
Listing features without connecting to business outcomes. Fix: Every epic must connect to a measurable business goal.
No buffer, no risk mitigation, assumes everything goes perfectly. Fix: Add 25-30% buffer, identify top 5 risks with mitigations.
Including every possible feature in MVP. Fix: Ruthlessly cut to core value proposition only.
This skill includes Python utilities for roadmap generation:
generator.py - Core roadmap generation logictemplates/ - Output templates (markdown, JSON)See generator.py for programmatic roadmap generation.
© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files in skills/roadmap-generator of alirezarezvani/claude-cto-team.
Open the folder on GitHubat commit a5bbb78
Roadmap Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Roadmap Generator this skillalirezarezvani/claude-cto-team | 117 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Multi-Role Spec and Task Breakdownmylukin/agent-foreman | 250 | — | ~5.1k | Automated safety check: Notes | None | |
| Scope KnifeMAGA2010/hackathon-run | 367 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Wayfinder Planning Mapsrengwu/wayfinder-maps | 134 | — | ~3.5k | Automated safety check: Pass | MIT | |
| Autospec Tasksariel-frischer/autospec | 144 | — | ~2.5k | Automated safety check: Pass | MIT | |
| Oma Pmfirst-fluke/oh-my-agent | 1.3k | — | ~1.7k | Automated safety check: Pass | MIT |
mylukin/agent-foreman
Runs a requirement through four research-backed specialist agents, a PM, a UX designer, a tech architect and QA, to produce implementable tasks.
MAGA2010/hackathon-run
Forces a KEEP, CUT, or DEFER decision on every feature when scope is too large, no MVP consensus exists, or time is running out.
rengwu/wayfinder-maps
Plans work too big for one agent session as a shared map of investigation tickets, resolved one at a time until the route to the destination is clear.
ariel-frischer/autospec
Generate YAML task breakdown from implementation plan. An agent skill from ariel-frischer/autospec.
first-fluke/oh-my-agent
Product manager that decomposes requirements into actionable tasks with priorities and dependencies.
softspark/ai-toolkit
Breaks features/goals into phased plans with task lists, agent assignments, dependencies.
alirezarezvani/claude-cto-team
Detect common technical and organizational anti-patterns in proposals, architectures, and plans.
alirezarezvani/claude-cto-team
Recommend architecture patterns (monolith, microservices, serverless, modular monolith) based on scale, team size, and constraints.
alirezarezvani/claude-cto-team
Identify and challenge implicit assumptions in plans, proposals, and technical decisions.
alirezarezvani/claude-cto-team
Infrastructure and development cost estimation for technical projects.
alirezarezvani/claude-cto-team
Deep expertise in ML/CV model selection, training pipelines, and inference architecture.
alirezarezvani/claude-cto-team
Analyze incoming user requests to detect intent, request type (design/validate/debug/document), complexity level, and identify vague requirements or buzzwords that need clarification.
Generate phased implementation roadmaps with Epic/Story/Task breakdown, effort estimates, and validation checkpoints. Roadmap Generator is an agent skill from alirezarezvani/claude-cto-team. Generate phased implementation roadmaps with Epic/Story/Task breakdown, effort estimates, and validation checkpoints.
Roadmap Generator fits situations like: cto-architect needs to create actionable technical roadmaps from architecture designs; tasks that involve Task breakdown.
Run `npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a claude-code`. Or copy the skill folder (skills/roadmap-generator in alirezarezvani/claude-cto-team) into .claude/skills/roadmap-generator in your project. Claude Code loads it when a task matches its description.
Run `npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a codex`. Or copy the skill folder (skills/roadmap-generator in alirezarezvani/claude-cto-team) into .agents/skills/roadmap-generator in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-cto-team --skill roadmap-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/roadmap-generator, .gemini/skills/roadmap-generator, .github/skills/roadmap-generator and .opencode/skills/roadmap-generator in your project.
Going by SKILL.md and its folder, Roadmap Generator needs Python for the scripts in its folder. Our summary lists: Python 3.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Roadmap Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Roadmap Generator: Multi-Role Spec and Task Breakdown (mylukin/agent-foreman, 250 stars), Scope Knife (MAGA2010/hackathon-run, 367 stars), Wayfinder Planning Maps (rengwu/wayfinder-maps, 134 stars) and Autospec Tasks (ariel-frischer/autospec, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-cto-team, which has 117 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on December 18, 2025.
Source: alirezarezvani/claude-cto-team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.