Frappe Customizations — Writer

Scope: Customisations are needed when an app must change the schema of a DocType that belongs to a different app. They work by creating Custom Field and Property Setter documents that Frappe syncs on bench migrate. This skill handles writing those definitions into the correct JSON file.

Workflow

1. Collect the spec — interview if anything is missing (see checklist below)
2. Locate the target file apps/{app}/{app}/{module_scrubbed}/custom/{dt_scrubbed}.json Infer module from existing custom/ files in the app, or ask the user.
3. Write a minimal spec to a temp file (/tmp/spec.json) — only the fields that matter
4. Run the skill script to merge the spec into the target file:

   # Run from the bench root; script location is discovered automatically
   BENCH_DIR=$(pwd)
   PYTHON="$BENCH_DIR/env/bin/python"
   SCRIPT=$(find "$BENCH_DIR" -path "*/frappe-customizations-writer/scripts/add_customization.py" 2>/dev/null | head -1)