Trunk-based development workflow template

Components in this architecture diagram

• Pick up task
• Pull latest main
• Create short-lived branch, under 1 day
• Small commits with tests
• Feature incomplete but mergeable?
• Wrap code behind feature flag
• Open pull request
• CI: lint, unit tests & build under 10 minutes
• CI green?
• Quick peer review
• Approved?
• Rebase & merge to main
• Main pipeline: integration tests & artifact
• Auto-deploy to staging then production
• Production healthy?
• Roll back or disable flag
• Gradually enable flag for users
• Remove flag & dead code
• Task done

How to use this architecture diagram template

1. Click Open in the editor. The architecture diagram opens on a new page in FlowDiagram — nothing is uploaded and there is no sign-up.
2. Rename, add or delete shapes and drag them where you want; connectors stay attached as things move.
3. Drop in vendor logos from the library — 1,160 of them, including every AWS, Azure and Google Cloud service icon — or restyle it with the colour and theme controls.
4. Prefer text? Edit the Mermaid source below and paste it in through ☰ → Import diagram (see the Mermaid editor); it imports as an editable diagram.
5. Export to PNG, SVG or PDF, or press Ctrl+L for a link that carries the whole diagram.

Mermaid source

The whole template is the text below. Paste it into FlowDiagram, keep it in Git next to the code it describes, or hand it to an AI assistant to extend.

flowchart TD
  A((Pick up task)) --> B[Pull latest main]
  B --> C[Create short-lived branch, under 1 day]
  C --> D[Small commits with tests]
  D --> E{Feature incomplete but mergeable?}
  E -->|Yes| F[Wrap code behind feature flag]
  E -->|No| G[Open pull request]
  F --> G
  G --> H[CI: lint, unit tests & build under 10 minutes]
  H --> I{CI green?}
  I -->|No| D
  I -->|Yes| J[Quick peer review]
  J --> K{Approved?}
  K -->|No| D
  K -->|Yes| L[Rebase & merge to main]
  L --> M[Main pipeline: integration tests & artifact]
  M --> N[Auto-deploy to staging then production]
  N --> O{Production healthy?}
  O -->|No| P[Roll back or disable flag]
  P --> D
  O -->|Yes| Q[Gradually enable flag for users]
  Q --> R[Remove flag & dead code]
  R --> S((Task done))

Related: System architecture diagram tool · Mermaid editor · All software engineering & state machines templates · All 521 templates