Rename SOFTWARE_FACTORY_INTENSIVE_PATH to SFI_PATH

Replaces all 90 occurrences of the environment variable across the eleven
files that set or read it. The shorter name matches the SFI_BOX and SFI_KEY
convention the repo already uses.

City: city · Agent: local-core.manager

Author: austinborn

CLOUD_BOX_GUIDE.md

@@ -54,7 +54,7 @@ Put `sfbox` on your `PATH`, from the directory holding your clone.
 **Copy and paste**
 
 ```bash
-export PATH="$SOFTWARE_FACTORY_INTENSIVE_PATH/sf-tutorial/participant-box-cli:$PATH"
+export PATH="$SFI_PATH/sf-tutorial/participant-box-cli:$PATH"
 sfbox --help
 ```
 

bootstrap/.env.example

@@ -2,7 +2,7 @@
 # 1. Copy this file: `cp .env.example ./.env`
 # 2. Update .env with your account name, preferred git clone method, etc.
 
-SOFTWARE_FACTORY_INTENSIVE_PATH=~/software-factory-intensive
+SFI_PATH=~/software-factory-intensive
 MODEL_PROVIDER=claude # codex, gemini, etc.
 GITHUB_USERNAME=username
 GITHUB_CLONE_METHOD=https # ssh, https, or gh

bootstrap/README.md

@@ -70,18 +70,18 @@ This script is destructive and meant to be re-runnable. **If you made any change
 **Confirmation prompt.** On launch, you'll see:
 
 ```
-Are you comfortable with resetting all of $SOFTWARE_FACTORY_INTENSIVE_PATH? (Y/n)
+Are you comfortable with resetting all of $SFI_PATH? (Y/n)
 ```
 
 You must type a **capital `Y`** to continue — `y`, `yes`, or just pressing Enter all abort the script. Nothing has been deleted at the prompt.
 
-**What gets `rm -rf`'d on every run.** Inside `$SOFTWARE_FACTORY_INTENSIVE_PATH` only:
+**What gets `rm -rf`'d on every run.** Inside `$SFI_PATH` only:
 
 - `factory*/` — every directory whose name starts with `factory` (e.g. `factory1`, `factory2`)
 - `ascii-art/`
 - `sf-tutorial/`
 
-Anything outside `$SOFTWARE_FACTORY_INTENSIVE_PATH` is untouched. Anything inside it that doesn't match those names (e.g. `mp-skills/`, pulled by step 05.2) is also untouched.
+Anything outside `$SFI_PATH` is untouched. Anything inside it that doesn't match those names (e.g. `mp-skills/`, pulled by step 05.2) is also untouched.
 
 **Other cleanup the script performs.**
 

bootstrap/bootstrap.sh

@@ -34,7 +34,7 @@ if [ -z "$BD_PINNED" ] || [ -z "$DOLT_PINNED" ] || [ -z "$GC_PINNED" ]; then
   exit 1
 fi
 
-read -p "Are you comfortable with resetting all of \$SOFTWARE_FACTORY_INTENSIVE_PATH? (Y/n) " confirm
+read -p "Are you comfortable with resetting all of \$SFI_PATH? (Y/n) " confirm
 if [ "$confirm" != "Y" ]; then
   echo "==> Exiting script."
   exit 1
@@ -138,29 +138,29 @@ if ! [[ "$TUTORIAL_STEP" =~ ^(00\.1-setup-foundation|00\.2-setup-foundation|00\.
   exit 1
 fi
 
-if [ -z "$SOFTWARE_FACTORY_INTENSIVE_PATH" ]; then
-  echo "==> SOFTWARE_FACTORY_INTENSIVE_PATH environment variable not found"
-  echo "==> Please set the SOFTWARE_FACTORY_INTENSIVE_PATH environment variable in the .env file."
+if [ -z "$SFI_PATH" ]; then
+  echo "==> SFI_PATH environment variable not found"
+  echo "==> Please set the SFI_PATH environment variable in the .env file."
   exit 1
 fi
 
-# Sanity check: warn if .env's SOFTWARE_FACTORY_INTENSIVE_PATH doesn't match
+# Sanity check: warn if .env's SFI_PATH doesn't match
 # the parent directory of sf-tutorial. A mismatch typically means the user
 # has sf-tutorial cloned somewhere other than what .env says, which would
 # create two parallel software-factory-intensive trees (one with sf-tutorial,
 # another with factory1/ascii-art). Most of the time this is misconfiguration,
 # not intent — so stop and let the user confirm or abort.
 DERIVED_SFI_PATH="$(cd "$TUTORIAL_PATH/.." && pwd -P)"
-if [ -d "$SOFTWARE_FACTORY_INTENSIVE_PATH" ]; then
-  NORMALIZED_ENV_SFI="$(cd "$SOFTWARE_FACTORY_INTENSIVE_PATH" && pwd -P)"
+if [ -d "$SFI_PATH" ]; then
+  NORMALIZED_ENV_SFI="$(cd "$SFI_PATH" && pwd -P)"
 else
-  NORMALIZED_ENV_SFI="${SOFTWARE_FACTORY_INTENSIVE_PATH%/}"
+  NORMALIZED_ENV_SFI="${SFI_PATH%/}"
 fi
 if [ "$NORMALIZED_ENV_SFI" != "$DERIVED_SFI_PATH" ]; then
   echo ""
-  echo "==> WARNING: SOFTWARE_FACTORY_INTENSIVE_PATH does not match the parent of sf-tutorial."
+  echo "==> WARNING: SFI_PATH does not match the parent of sf-tutorial."
   echo ""
-  echo "    .env SOFTWARE_FACTORY_INTENSIVE_PATH : $SOFTWARE_FACTORY_INTENSIVE_PATH"
+  echo "    .env SFI_PATH : $SFI_PATH"
   echo "    sf-tutorial parent directory         : $DERIVED_SFI_PATH"
   echo ""
   echo "    Continuing will run the bootstrap against the .env path, leaving"
@@ -262,15 +262,15 @@ print_beads_dolt_hint() {
 }
 trap print_beads_dolt_hint EXIT
 
-mkdir -p $SOFTWARE_FACTORY_INTENSIVE_PATH
-cd $SOFTWARE_FACTORY_INTENSIVE_PATH
+mkdir -p $SFI_PATH
+cd $SFI_PATH
 
 if gc cities | grep -q "factory"; then
   for city in $(gc cities | grep "factory" | awk '{print $2}'); do
     # Subshell so `cd` doesn't leak. `gc cities` returns absolute paths that may
-    # point outside $SOFTWARE_FACTORY_INTENSIVE_PATH (stale registrations from
+    # point outside $SFI_PATH (stale registrations from
     # prior runs with a different .env). Leaking cwd here caused subsequent
-    # rm -rf calls to nuke directories outside $SOFTWARE_FACTORY_INTENSIVE_PATH.
+    # rm -rf calls to nuke directories outside $SFI_PATH.
     (cd "$city" 2>/dev/null && gc stop) || true
   done
 fi
@@ -623,13 +623,13 @@ fi
 
 # Run 05.2-bead-gate-checks
 
-if [ ! -d $SOFTWARE_FACTORY_INTENSIVE_PATH/mp-skills ]; then
+if [ ! -d $SFI_PATH/mp-skills ]; then
   if [ "$GITHUB_CLONE_METHOD" == "https" ]; then
-    git clone https://github.com/mattpocock/skills.git $SOFTWARE_FACTORY_INTENSIVE_PATH/mp-skills
+    git clone https://github.com/mattpocock/skills.git $SFI_PATH/mp-skills
   elif [ "$GITHUB_CLONE_METHOD" == "ssh" ]; then
-    git clone git@github.com:mattpocock/skills.git $SOFTWARE_FACTORY_INTENSIVE_PATH/mp-skills
+    git clone git@github.com:mattpocock/skills.git $SFI_PATH/mp-skills
   elif [ "$GITHUB_CLONE_METHOD" == "gh" ]; then
-    gh repo clone mattpocock/skills $SOFTWARE_FACTORY_INTENSIVE_PATH/mp-skills
+    gh repo clone mattpocock/skills $SFI_PATH/mp-skills
   else
     echo "==> GITHUB_CLONE_METHOD environment variable is not valid"
     echo "==> Please set the GITHUB_CLONE_METHOD environment variable to a valid value (https, ssh, gh)."
@@ -639,7 +639,7 @@ fi
 cd "$ASCII_ART_PATH"
 mkdir -p .claude/skills/grill-me
 if [ ! -f .claude/skills/grill-me/SKILL.md ]; then
-  cp $SOFTWARE_FACTORY_INTENSIVE_PATH/mp-skills/skills/productivity/grill-me/SKILL.md \
+  cp $SFI_PATH/mp-skills/skills/productivity/grill-me/SKILL.md \
      .claude/skills/grill-me/SKILL.md
 fi
 

bootstrap/preflight.sh

@@ -187,14 +187,14 @@ fi
 # --------------------------------------------------------------------------
 head2 "Local path"
 
-if [ -n "${SOFTWARE_FACTORY_INTENSIVE_PATH:-}" ]; then
-  if [ -d "$SOFTWARE_FACTORY_INTENSIVE_PATH" ]; then
-    ok "workspace: $SOFTWARE_FACTORY_INTENSIVE_PATH"
+if [ -n "${SFI_PATH:-}" ]; then
+  if [ -d "$SFI_PATH" ]; then
+    ok "workspace: $SFI_PATH"
   else
-    fail "workspace: \$SOFTWARE_FACTORY_INTENSIVE_PATH is set but does not exist"
+    fail "workspace: \$SFI_PATH is set but does not exist"
   fi
 else
-  warn "workspace: \$SOFTWARE_FACTORY_INTENSIVE_PATH is unset — bootstrap.sh needs it, the progression pages do not"
+  warn "workspace: \$SFI_PATH is unset — bootstrap.sh needs it, the progression pages do not"
 fi
 
 if [ -w "$HOME" ]; then ok "home directory is writable"; else fail "home directory is not writable"; fi

progression/L1-plan-your-factory.md

@@ -57,7 +57,7 @@ Register the rig as a **sibling** of the city, the same shape [W3](./W3-run-your
 **Copy and paste**
 
 ```bash
-cd "$SOFTWARE_FACTORY_INTENSIVE_PATH/factory1"
+cd "$SFI_PATH/factory1"
 git clone <your-repo-url> ../<your-rig-name>
 gc rig add ../<your-rig-name> <your-rig-name>
 export MY_RIG_PATH="$(cd ../<your-rig-name> && pwd)"
@@ -76,7 +76,7 @@ Then install the base factory into it, so your own rig has the same machinery `a
 **Copy and paste**
 
 ```bash
-gc import add --rig <your-rig-name> "$SOFTWARE_FACTORY_INTENSIVE_PATH/sf-tutorial/artifacts/packs/base-factory"
+gc import add --rig <your-rig-name> "$SFI_PATH/sf-tutorial/artifacts/packs/base-factory"
 gc import list --rig <your-rig-name>
 ```
 
@@ -88,7 +88,7 @@ A **project overview** is a loosely structured document answering a few question
 
 ```bash
 mkdir -p "$MY_RIG_PATH/docs/current"
-cp "$SOFTWARE_FACTORY_INTENSIVE_PATH/sf-tutorial/artifacts/docs/PROJECT_OVERVIEW.template.md" "$MY_RIG_PATH/docs/PROJECT_OVERVIEW.md"
+cp "$SFI_PATH/sf-tutorial/artifacts/docs/PROJECT_OVERVIEW.template.md" "$MY_RIG_PATH/docs/PROJECT_OVERVIEW.md"
 nano "$MY_RIG_PATH/docs/PROJECT_OVERVIEW.md"
 ```
 
@@ -140,7 +140,7 @@ bd create --title "<something you would struggle to explain to a new hire>" --ty
 The third one is deliberate. Sling it and watch what your factory does with an under-specified ask:
 
 ```bash
-cd "$SOFTWARE_FACTORY_INTENSIVE_PATH/factory1"
+cd "$SFI_PATH/factory1"
 gc sling --rig <your-rig-name> polecat <the-third-bead-id>
 ```
 

progression/L2-capability-map.md

@@ -49,7 +49,7 @@ Thirty minutes at the end of Day 1 to get the rows down, and thirty on Day 2 mor
 **Copy and paste**
 
 ```bash
-cp "$SOFTWARE_FACTORY_INTENSIVE_PATH/sf-tutorial/artifacts/docs/capability-map.template.md" "$MY_RIG_PATH/docs/current/capability-map.md"
+cp "$SFI_PATH/sf-tutorial/artifacts/docs/capability-map.template.md" "$MY_RIG_PATH/docs/current/capability-map.md"
 nano "$MY_RIG_PATH/docs/current/capability-map.md"
 ```
 

progression/W2-cloud-box-and-preflight.md

@@ -45,7 +45,7 @@ Regardless of whether you choose to run the factory in our instructor-provided c
 ```bash
 cd $HOME && mkdir software-factory-intensive
 cd software-factory-intensive
-export SOFTWARE_FACTORY_INTENSIVE_PATH="$(pwd)"
+export SFI_PATH="$(pwd)"
 gh repo fork https://github.com/actual-software/sf-tutorial.git --clone
 cd sf-tutorial/bootstrap
 ```
@@ -87,7 +87,7 @@ Then, add the variables to `~/.zshrc` or `~/.bashrc` too so new session windows
 
 ```bash
 cat <<EOF >> ~/.zshrc
-export SOFTWARE_FACTORY_INTENSIVE_PATH="$SOFTWARE_FACTORY_INTENSIVE_PATH"
+export SFI_PATH="$SFI_PATH"
 export PATH="$HOME/.local/bin:$PATH"
 EOF
 ```
@@ -96,7 +96,7 @@ EOF
 
 ```bash
 cat <<EOF >> ~/.bashrc
-export SOFTWARE_FACTORY_INTENSIVE_PATH="$SOFTWARE_FACTORY_INTENSIVE_PATH"
+export SFI_PATH="$SFI_PATH"
 export PATH="$HOME/.local/bin:$PATH"
 EOF
 ```