>''')
prev_node = 'title'
for i, milestone in enumerate(milestones):
color = status_colors.get(milestone.get('status', 'planned'), '#B4C7E7')
items_html = " ".join([f"• {item}" for item in milestone.get('items', [])])
html = f'''<
{milestone['date']}
{milestone['title']}
{items_html}
>'''
node_id = f"m{i}"
dot.node(node_id, html)
dot.edge(prev_node, node_id)
prev_node = node_id
dot.render(cleanup=True)
print(f"Generated: {filename}.png")
# Example
milestones = [
{
'date': 'Jan 2025',
'title': 'Project Kickoff',
'items': ['Team onboarding', 'Environment setup', 'Initial planning'],
'status': 'complete'
},
{
'date': 'Feb 2025',
'title': 'Development Sprint 1',
'items': ['Core platform', 'Authentication', 'Base UI'],
'status': 'in-progress'
},
{
'date': 'Mar 2025',
'title': 'Integration Phase',
'items': ['API integrations', 'Data migration', 'Testing'],
'status': 'planned'
},
{
'date': 'Apr 2025',
'title': 'Go-Live',
'items': ['Production deployment', 'Training', 'Support transition'],
'status': 'planned'
}
]
create_roadmap(milestones, "project-roadmap")
```
## Approach 4: Mermaid Gantt
```python
def generate_mermaid_gantt(title, sections):
"""
Generate Mermaid Gantt chart syntax.
sections: list of dicts with keys:
- name: section name
- tasks: list of (task_name, start_date, duration) tuples
"""
mermaid = f"""gantt
title {title}
dateFormat YYYY-MM-DD
"""
for section in sections:
mermaid += f" section {section['name']}\n"
for task in section['tasks']:
task_name, start, duration = task
mermaid += f" {task_name} : {start}, {duration}\n"
return mermaid
# Example
sections = [
{
'name': 'Discovery',
'tasks': [
('Requirements', '2025-01-01', '7d'),
('Architecture', '2025-01-05', '5d'),
]
},
{
'name': 'Development',
'tasks': [
('Core Platform', '2025-01-10', '21d'),
('Integrations', '2025-01-20', '14d'),
]
},
{
'name': 'Deployment',
'tasks': [
('Testing', '2025-02-01', '10d'),
('Go-Live', '2025-02-10', '3d'),
]
}
]
print(generate_mermaid_gantt("Project Plan", sections))
```
## Parallel Workstreams
For diagrams showing parallel tracks:
```python
import graphviz
def create_parallel_tracks(tracks, filename="parallel-timeline"):
"""
Create a diagram showing parallel workstreams.
tracks: list of dicts with keys:
- name: track name
- phases: list of phase names
- color: optional color
"""
dot = graphviz.Digraph('Parallel', filename=filename, format='png')
dot.attr(rankdir='LR')
colors = ['#4472C4', '#ED7D31', '#70AD47', '#FFC000']
# Create subgraphs for alignment
for i, track in enumerate(tracks):
color = track.get('color', colors[i % len(colors)])
with dot.subgraph() as s:
s.attr(rank='same')
prev_node = None
for j, phase in enumerate(track['phases']):
node_id = f"t{i}p{j}"
s.node(node_id, phase, shape='box', style='filled',
fillcolor=color, fontcolor='white')
if prev_node:
dot.edge(prev_node, node_id)
prev_node = node_id
# Track label
label_id = f"label{i}"
dot.node(label_id, track['name'], shape='plaintext', fontsize='12')
dot.edge(label_id, f"t{i}p0", style='invis')
# Align phases vertically
max_phases = max(len(t['phases']) for t in tracks)
for j in range(max_phases):
with dot.subgraph() as s:
s.attr(rank='same')
for i in range(len(tracks)):
if j < len(tracks[i]['phases']):
s.node(f"t{i}p{j}")
dot.render(cleanup=True)
print(f"Generated: {filename}.png")
# Example: Development vs Migration tracks
tracks = [
{
'name': 'Development',
'phases': ['Design', 'Build', 'Test', 'Deploy'],
'color': '#4472C4'
},
{
'name': 'Migration',
'phases': ['Analysis', 'Extract', 'Transform', 'Load'],
'color': '#70AD47'
}
]
create_parallel_tracks(tracks, "dev-migration-timeline")
```
## Converting ASCII Timelines
When you see:
```
Q1 2025 Q2 2025 Q3 2025 Q4 2025
| | | |
├─ Discovery ────┤ | |
| ├─ Development ──┼────────────────┤
| | ├─ Migration ────┤
| | | ├─ Go-Live
```
Extract:
1. Time periods (quarters, months, weeks)
2. Phase/task names
3. Duration (spans between markers)
4. Dependencies (sequential vs parallel)
5. Milestones (specific dates)