plugins/teamcraft-jcg/skills/define-roadmap/SKILL.md
Produce a multi-sprint product roadmap in Confluence — the planning layer between a baselined PRD and individual sprint planning. Organises what gets built in what order across sprints, with priorities, dependencies, and capacity rationale. Feeds directly into plan-sprint.
npx skillsauth add codingthefuturewithai/claude-code-primitives teamcraft-jcg:define-roadmapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Produce a roadmap that answers: given everything in the PRD, what gets built in what order, over how many sprints, and why in that sequence? The roadmap is the bridge between "here are all the requirements" and "here is what we commit to this sprint." It makes sequencing decisions explicit and visible so sprint planning is selection from a ranked backlog, not improvisation.
The roadmap is an AI-native artifact — it must be structured so an agent loading it for sprint planning can immediately understand priorities, dependencies, and sequencing rationale without human interpretation.
If $ARGUMENTS contains a Confluence page URL or ID, load the PRD directly with mcp__sooperset-mcp-atlassian__confluence_get_page. Otherwise ask the user if they can point at the PRD before searching. If they need to find it, use mcp__sooperset-mcp-atlassian__confluence_search.
Ask whether a Jira project exists — if so, use mcp__sooperset-mcp-atlassian__jira_get_all_projects to identify it, then use mcp__sooperset-mcp-atlassian__jira_get_agile_boards and mcp__sooperset-mcp-atlassian__jira_get_sprints_from_board to load sprint history. Understanding what has already shipped gives the roadmap accurate starting context.
Ask whether tech decisions are available in Confluence. Load if the user can point at them — sequencing often depends on technical prerequisites.
Work conversationally. The PRD contains all requirements — the task is to sequence and group them into cohesive sprint-sized chunks with clear rationale.
For each roadmap item, establish: what it is (capability or feature area from the PRD), why it comes at this point in the sequence (dependency, risk, value), roughly how large it is (sprint count estimate), and what it unlocks next.
See references/example-roadmap.md for the expected structure and depth.
Surface sequencing decisions that need the user's input — when two capabilities have no dependency between them, the PM chooses priority. Do not assume.
Show the complete roadmap for review. Do not store until the user confirms.
Ask which Confluence space to store the roadmap in. Use mcp__sooperset-mcp-atlassian__confluence_search to surface available spaces if the user doesn't know the space key. Once the space is confirmed, use mcp__sooperset-mcp-atlassian__confluence_get_page_children to browse its structure and recommend a parent page location based on what already exists. Confirm the location before creating with mcp__sooperset-mcp-atlassian__confluence_create_page.
Share the Confluence page URL and page ID. The roadmap page ID should be recorded in .teamcraft/project.md alongside the PRD and tech decisions — plan-sprint will load it as context for sprint selection. The natural next step is plan-sprint: select the first sprint's issues from the roadmap's first phase.
tools
Capture feedback about Teamcraft itself and turn it into a well-structured GitHub issue on the plugin's repo. Vets whether the problem is really a Teamcraft skill defect (vs. misuse, the harness, or the user's own project) by root-causing against the actual skill source, then helps the developer decide whether to file and publishes via the GitHub CLI. Use when the user says 'improve teamcraft', 'a teamcraft skill did the wrong thing', 'file feedback on teamcraft', 'report a teamcraft bug', 'I have an idea to make teamcraft better', or when a Teamcraft skill clearly misbehaved and the user wants that captured upstream.
tools
Learn the Teamcraft plugin itself — how its workflow, skills, and artifacts fit together. A guided overview for a human getting started, or a system map for Claude orienting itself to how Teamcraft works before working in a Teamcraft repo. Teaching only; needs no project or environment access. Use when someone wants to understand Teamcraft (the tool, not their specific project), asks "how does Teamcraft work", "explain the workflow", "which skill do I use for X", or when Claude needs the big picture of how the skills hook together.
tools
--- name: teamcraft:work-board description: Launch (or re-launch) the user's live, multi-project work board. The dashboard is a single HTML file copied to a stable user-side location at ~/.claude/teamcraft-board.html and opened in the user's default browser. It has two views via a header toggle — a drag-and-drop Kanban Board and a live Status tab (analytics: work by status, throughput, cycle time, aging, blocked chains, recomputed on every poll). Each project is added via a header dropdown; the
development
Run pre-PR reviews (code health, security, acceptance criteria), address findings, and submit the PR for review. Ends when the PR is ready and CI has passed. Use when implementation is done and ready for review, or when the user says "I'm done coding", "validate this", "ready for review", "submit this for review", "run the pre-PR reviews", or "prepare this for review".