Runnable examples
Four plugins, smallest → largest, each one a complete walkthrough you can copy-paste and run. Three are mirrored from the upstream SDK repo's examples/ directory; the fourth is a worked illustration of an apply hook.
| Example | Role | ~LOC | What it demonstrates |
|---|---|---|---|
hello-scaffold | CustomScaffold | 30 | The minimum viable plugin: one file output, one entry-point, ~20 inherited tests |
gitlab-ci-scaffold | CustomScaffold | 140 | Realistic multi-file plugin: README + .gitlab-ci.yml + per-env config |
steward-validator | Validator | 90 | Governance rule with severity bucketing; runs at fluid validate |
apply-hook-prod-key-guard | apply hook | ~60 | Runtime invariant check at fluid apply; not a class, just a function |
If you're new, read them in this order. Each one builds on the concepts in the previous; by the apply-hook example the three entry-point groups and the role taxonomy should feel familiar.
Source
Three of the four ship as runnable Python projects inside the SDK repo:
Each has its own pyproject.toml, runnable demo.py, and full test suite. pip install -e .[dev] && pytest works in any of them out of the box.
After the examples — pick your journey
The examples are reference; the journeys are how-tos framed by the problem you're solving:
- You have your own CI/CD setup → your-own-ci
- You have a strict project layout → your-own-scaffolding
- You have governance rules → custom-validator
- You want a check at apply time → apply-hook