GSD Pi Presets

Community preset gallery for GSD Pi Config, used by the web config editor and desktop app.

Presets help users start from known-good GSD Pi workflow settings instead of hand-tuning every preference. Each file under presets/ is a .preset.md document with YAML frontmatter, using the same format produced by Export preset in the config manager.

Included presets

This repository currently ships six baseline presets:

Preset	Best for
Solo · Budget	Fast solo work with lower token use and minimal automation.
Solo · Balanced	Everyday single-developer work with smart context and standard verification.
Solo · Quality	High-stakes solo changes with stricter verification and fuller context.
Team · Budget	Team workflows with git isolation while keeping research and verification lighter.
Team · Balanced	Default team setup with worktrees, PR automation, notifications, and standard verification.
Team · Quality	Team workflow tuned for stricter verification and quality-focused defaults.

How the gallery works

The web gallery loads index.json and the raw preset files from this repository.

index.json is generated from:

• presets/*.preset.md for the actual configuration payloads.
• presets/meta.json for gallery metadata such as title, description, tags, and author.

When changes are pushed to main, the Build preset index workflow regenerates index.json if needed.

Repository layout

.
├── index.json                 # Generated gallery index
├── presets/
│   ├── meta.json              # Human-maintained gallery metadata
│   └── *.preset.md            # Importable GSD Pi preset files
└── scripts/
    └── build-index.mjs        # Local/CI index generator

Rebuild the index locally

After adding or editing presets, regenerate the gallery index:

node scripts/build-index.mjs

Commit both the preset changes and the resulting index.json update.

Add a preset

1. Export a preset from GSD Pi Config.
2. Remove secrets, private URLs, local-only paths, and environment-specific values.
3. Add the file as presets/<slug>.preset.md.
4. Add matching metadata for <slug> in presets/meta.json.
5. Run node scripts/build-index.mjs.
6. Open a pull request.

Contribute

See CONTRIBUTING.md for preset format details, review expectations, and submission options.