<!-- Written by Gardener 0.1.21. `gardener generate` rewrites this file; do not edit it. -->

Gardener tasks

Gardener runs AI maintenance tasks on this repository from GitHub Actions. Each task is one Markdown file: YAML frontmatter says when it runs, what the model may read, and exactly which changes it may make; the body is the model's instructions. A planning job runs the model with only the declared tools and lets it plan only the declared effects. A separate job then applies that plan. Nothing outside the declaration is possible, whatever the instructions say.

Files

.gardener/
  gardener.json            project settings (release pin, optional "handle"); edit only "handle"
  gardener.lock.json       generated; never edit
  SKILL.md                 this file; generated
  tasks/<dir>/TASK.md      one task per directory; the only files you write
.github/workflows/
  gardener-<id>.yml        generated, one per task; never edit
  gardener-sync.yml        generated (or the "syncWorkflow" name in gardener.json); never edit

Workflow

1. Create .gardener/tasks/<dir>/TASK.md. Start from the template below or an existing task.
2. Run npx @scuffi/gardener@0.1.21 generate from the repository root (or the repository's own package.json script, if it has one). Use this exact version: a different one produces files the pull request's Check tasks check rejects.
3. Fix every error generate prints and read its warnings. Repeat until it succeeds.
4. Commit the TASK.md, .gardener/gardener.lock.json and the .github/workflows/gardener-*.yml changes together. When they reach the default branch, the sync workflow enables the task.

To change a task, edit its TASK.md and run generate again. To remove one, delete its directory and run generate. Never hand-edit generated files.

Template