Instruction file imported from dan-snelson/DDM-OS-Reminder (.github/instructions/preference-handling.instructions.md). Copyright stays with the author.

Preference Handling Rules

Name: Preference Handling Rules
Author: dan-snelson

1. Precedence (Highest Priority)

Always preserve strict precedence: Managed Preferences → Local Preferences → Defaults.
When starting from Resources/sample.plist, ensure all changes respect the precedence order above.

2. Tool Usage

Always use PlistBuddy for preference reads — never defaults read.
If PlistBuddy is unavailable or fails: Log an error and halt the operation.
If PlistBuddy produces partial or inconsistent output: Log a warning and retry the operation up to 3 times before halting.

3. Starting Point & Missing Files

Start from Resources/sample.plist when making localization or preference changes.
If Resources/sample.plist is missing or inaccessible: Log an error and halt the operation.

4. Localization

Validate fallback behavior for English and all languages listed in Resources/README.md.
If a language family is unsupported or missing: Default to English and log a warning.
Update relevant docs (README.md, Resources/README.md, CHANGELOG.md) when operator-facing behavior changes.

{ "ocm": "1", "id": "dan-snelson-ddm-os-reminder-preference-handling-instructions", "kind": "skill", "name": "Preference Handling Rules", "description": "Rules for preference reads, precedence, and localization", "publisher": "dan-snelson", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Rules for preference reads, precedence, and localization" ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/dan-snelson/DDM-OS-Reminder", "path": ".github/instructions/preference-handling.instructions.md", "ref": "736401ea8b8b712fcd37c55ef4475d4a2d6cfcc9", "url": "https://github.com/dan-snelson/DDM-OS-Reminder/blob/736401ea8b8b712fcd37c55ef4475d4a2d6cfcc9/.github/instructions/preference-handling.instructions.md", "key": "dan-snelson/DDM-OS-Reminder/.github/instructions/preference-handling.instructions.md" }, "applies_to": "**/*Preference*.zsh,Resources/**/*.plist,Resources/sample.plist" }, "instructions": "# Preference Handling Rules\n\n## 1. Precedence (Highest Priority)\n- Always preserve strict precedence: **Managed Preferences → Local Preferences → Defaults**.\n- When starting from `Resources/sample.plist`, ensure all changes respect the precedence order above.\n\n## 2. Tool Usage\n- Always use `PlistBuddy` for preference reads — never `defaults read`.\n- If `PlistBuddy` is unavailable or fails: Log an error and halt the operation.\n- If `PlistBuddy` produces partial or inconsistent output: Log a warning and retry the operation up to 3 times before halting.\n\n## 3. Starting Point & Missing Files\n- Sta", "cost": { "context_tokens": 272 } }

Preference Handling Rules

About

Preference Handling Rules

1. Precedence (Highest Priority)

2. Tool Usage

3. Starting Point & Missing Files

4. Localization

Use it

Manifest

Reviews