Add Bootstrap section to AGENTS.md#25586
Open
mokagio wants to merge 3 commits into
Open
Conversation
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 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a “Bootstrap” section to AGENTS.md so automation/agents have an in-repo entry point for getting a fresh checkout/worktree into a buildable state, instead of relying on README.md.
Changes:
- Document running the dependency bootstrap task and what it sets up (credentials, Gutenberg XCFrameworks, internal app icon).
- Note worktree implications for
WordPress/Frameworks/and where Gutenberg downloads are cached. - List common Rake entry points (
lint,lintfix,xcode,mocks) and point toREADME.mdfor full machine setup.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+25
to
+29
| 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 |
mokagio
commented
May 26, 2026
mokagio
commented
May 26, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Gio Lodi <giovanni.lodi42@gmail.com>
mokagio
commented
May 26, 2026
mokagio
commented
May 26, 2026
| To prepare a fresh clone or worktree to build the app, run: | ||
|
|
||
| ```sh | ||
| rake dependencies |
Contributor
Author
There was a problem hiding this comment.
As a follow up, we could rename or alias dependencies to bootstrap which I think is a more established term for this action.
crazytonyli
approved these changes
May 26, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Agents reading
AGENTS.mdhad no canonical entry point for getting the repo to a buildable state.README.md's "Getting Started" section has it, but agents don't look there.This adds a
## Bootstrapsection near the top pointing atbundle exec rake dependencies.I realized I needed something like this as part of my worktree workflow, because
WordPress/Frameworks/is gitignored and must be re-populated per worktree and my build kept failing.Granted, a possible better solution would be to make the setup worktree-compatible somehow. But as far as I understand this is mostly a me problem and I don't think the plumbing and rewiring needed would be a net benefit. Instead, a clearer instruction set seems a net win.