File format

.plan.md

A project timeline as a Markdown file. A Mermaid Gantt chart that renders as a real plan — and diffs like text.

q4.plan.mdplain text · git-diffable
1## @plan
2
3```mermaid
4gantt
5 title Q4 RevOps Initiatives
6 dateFormat YYYY-MM-DD
7 section Reporting
8 MRR digest automation :done, 1, 2026-01-10, 3d
9 Pipeline weekly digest :2, 2026-01-13, 5d
10 section Renewals
11 Q1 outreach :active, 3, 2026-01-13, 4d
12 Churn playbook v2 :4, 2026-01-15, 5d
13```
q4.plan.md — rendered

Using it

Let your AI plan the quarter.

Mermaid Gantt is already in every model's vocabulary — ask for a plan and Arg0 renders the reply.

1

Paste the spec

Copy the format reference into ChatGPT or Claude.

2

Describe the plan

"Lay out our Q4 launches" — it writes a .plan.md.

3

Save the reply

Drop the file into any folder Arg0 can see.

4

Timeline draws itself

Swimlanes, dates and states land on the chart.

Mermaid
Markdown
@plan
01

Mark a @plan section

An ## @plan heading plus a Mermaid gantt block — that is the whole format.

02

Arg0 draws the timeline

Sections become swimlanes, bars get done/active states, dates become the axis.

03

Edit either side

Drag in the app or edit the text — both write the same file.

Gantt syntax

Standard Mermaid — nothing to learn.

The same gantt syntax you already know from Mermaid — sections, states, dates and milestones.

ganttsectiondoneactivecritmilestonedateFormatYYYY-MM-DD7dafter

A Gantt chart in a file

The plan is a mermaid block inside Markdown — review a slipped deadline as a one-line diff.

Sections are swimlanes

Group initiatives by team or stream — each section becomes its own lane on the timeline.

Done / active states

Tag a bar done or active and the timeline shades it — progress visible at a glance.

Pairs with .tasks.md

The task list and the timeline read the same dates — keep them side by side in one plan/ folder.

A plan you can diff.

Timeline in a Markdown file — no roadmap tool lock-in, no exported screenshots.