Skip to content

DavidROliverBA/ArchitectKB / .claude/skills/system-roadmap

system-roadmap

Verified

Skill: /system-roadmap

Generate a visual system lifecycle roadmap from System notes in the vault.

Trigger

  • /system-roadmap - Generate default roadmap
  • /system-roadmap --list - List systems without generating
  • /system-roadmap --svg - Generate SVG format
  • /system-roadmap --theme GREENTURTLE - Use different colour theme

Description

This skill generates a PNG or SVG roadmap visualisation showing system lifecycles grouped by Gartner TIME category (Invest, Tolerate, Migrate, Eliminate). It reads System notes from the vault and uses their lifecycle frontmatter fields.

Prerequisites

The following Python packages must be installed:

pip3 install roadmapper python-frontmatter

Execution Steps

  1. Run the script with appropriate options:
# Default - generates PNG to +Attachments/
python3 scripts/system_roadmap.py

# List systems found (dry run)
python3 scripts/system_roadmap.py --list

# Generate SVG format
python3 scripts/system_roadmap.py --format svg

# Custom output location
python3 scripts/system_roadmap.py --output +Attachments/custom-roadmap.png

# Different theme (DEFAULT, GREYWOOF, ORANGEPEEL, GREENTURTLE, BLUEMOUNTAIN)
python3 scripts/system_roadmap.py --theme GREENTURTLE

# Custom timeline
python3 scripts/system_roadmap.py --start-year 2020 --years 15
  1. Report the output location to the user

  2. Provide embed syntax for Obsidian:

    ![[system-lifecycle-roadmap.png]]
    

System Frontmatter Fields

The script reads these fields from System notes:

FieldPurposeExample
typeMust be "System"type: System
titleSystem display nametitle: Core ERP
statusCurrent statusstatus: active
timeCategoryTIME classificationtimeCategory: migrate
launchDateWhen system went livelaunchDate: 2005-01-01
sunsetDatePlanned retirementsunsetDate: 2030-06-01
replacedBySuccessor systemreplacedBy: "[[System - New ERP]]"
criticalityBusiness criticalitycriticality: critical

TIME Category Inference

If timeCategory is not set, the script infers it:

  • status: planned → invest
  • status: deprecated or retired → eliminate
  • Has sunsetDate → migrate
  • Default → tolerate

Output

  • Default location: +Attachments/system-lifecycle-roadmap.png
  • Grouped by TIME category (Invest, Tolerate, Migrate, Eliminate)
  • Shows launch dates and sunset milestones
  • Current date marker indicated

Example Output

The roadmap shows:

  • Strategic Investment - Systems we are actively growing (New CRM, Data Platform)
  • Maintain (Tolerate) - Stable systems (Core ERP, Identity Platform)
  • Transition (Migrate) - Systems being replaced (Legacy HR System)
  • Retire (Eliminate) - Systems being decommissioned (Old Reporting Tool)

Troubleshooting

No systems found:

  • Ensure System notes have type: System in frontmatter
  • Check notes are in vault root (not archived)

Roadmapper not installed:

pip3 install roadmapper python-frontmatter

Image not rendering in Obsidian:

  • Ensure file is in +Attachments/ folder
  • Use correct embed syntax: ![[filename.png]]

Related

  • [[MOC - Systems]]
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 193kUpdated Claude CodeCodexVerifiedInstall