From 0135a78dbaaa25eefb94b55a06aa4577acfe9038 Mon Sep 17 00:00:00 2001 From: Gio Lodi Date: Tue, 26 May 2026 19:41:54 +1000 Subject: [PATCH 1/3] Add Bootstrap section to AGENTS.md Agents reading `AGENTS.md` had no canonical entry point for getting the repo to a buildable state. The information lived in `README.md`'s "Getting Started" section but wasn't surfaced where agents look. Surfacing `bundle exec rake dependencies` as the bootstrap command is especially useful in a worktree workflow, where `WordPress/Frameworks/` is gitignored and must be re-populated per worktree. --- Generated with the help of Claude Code, https://code.claude.com Co-Authored-By: Claude Code Opus 4.7 --- AGENTS.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index ece341428a1c..a8218ecf82a5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,6 +8,28 @@ WordPress for iOS is the official mobile app for WordPress that lets users creat Minimum requires iOS version is iOS 17. The latest iOS version is iOS 26. +## Bootstrap + +Before building or running tests — including in any newly created worktree — run: + +```sh +bundle exec rake dependencies +``` + +This is the canonical entry point for getting the repo ready to build. +It checks Ruby/Bundler, applies mobile-secrets credentials (when configured), downloads the Gutenberg xcframeworks, and generates the internal app icon. + +`WordPress/Frameworks/` is gitignored and per-worktree, so this must be re-run in every fresh worktree. +The Gutenberg xcframeworks themselves are cached at `~/Library/Caches/WordPress-iOS/Gutenberg/`, so the network download only happens once per version. + +Other common task-runner entry points: + +- `bundle exec rake lint` / `bundle exec rake lintfix` — SwiftLint +- `bundle exec rake xcode` — open the workspace (runs `dependencies` first) +- `bundle exec rake mocks` — start the API mock server on port 8282 + +For first-time machine setup (Xcode, Homebrew tools, credentials, GPG), see the "Getting Started" section in `README.md`. + ## High-Level Architecture ### Project Structure From e6a1a3dd88f4fd0447248015f166b033c1d75def Mon Sep 17 00:00:00 2001 From: Gio Lodi Date: Tue, 26 May 2026 19:53:23 +1000 Subject: [PATCH 2/3] Remove AI verboseness Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Gio Lodi --- AGENTS.md | 17 ++--------------- 1 file changed, 2 insertions(+), 15 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index a8218ecf82a5..3a09720b7664 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,26 +10,13 @@ Minimum requires iOS version is iOS 17. The latest iOS version is iOS 26. ## Bootstrap -Before building or running tests — including in any newly created worktree — run: +To prepare a fresh clone or worktree to build the app, run: ```sh -bundle exec rake dependencies +rake dependencies ``` This is the canonical entry point for getting the repo ready to build. -It checks Ruby/Bundler, applies mobile-secrets credentials (when configured), downloads the Gutenberg xcframeworks, and generates the internal app icon. - -`WordPress/Frameworks/` is gitignored and per-worktree, so this must be re-run in every fresh worktree. -The Gutenberg xcframeworks themselves are cached at `~/Library/Caches/WordPress-iOS/Gutenberg/`, so the network download only happens once per version. - -Other common task-runner entry points: - -- `bundle exec rake lint` / `bundle exec rake lintfix` — SwiftLint -- `bundle exec rake xcode` — open the workspace (runs `dependencies` first) -- `bundle exec rake mocks` — start the API mock server on port 8282 - -For first-time machine setup (Xcode, Homebrew tools, credentials, GPG), see the "Getting Started" section in `README.md`. - ## High-Level Architecture ### Project Structure From fa14f40e95388aab7305ec7f8c6b913554d07aab Mon Sep 17 00:00:00 2001 From: Gio Lodi Date: Tue, 26 May 2026 19:54:25 +1000 Subject: [PATCH 3/3] Add missing new line --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index 3a09720b7664..d72c9837f51b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -17,6 +17,7 @@ rake dependencies ``` This is the canonical entry point for getting the repo ready to build. + ## High-Level Architecture ### Project Structure