docs: update Antigravity porting guidance#1710
Open
anhtnt90dev wants to merge 1 commit into
Open
Conversation
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.
Who is submitting this PR? (required)
What problem are you trying to solve?
docs/porting-to-a-new-harness.mdstill described Antigravity as if it used a repo-local.antigravity-plugin/install.shscaffold that generated acontextFileNamebootstrap file.That is stale after #1657. The merged Antigravity support installs the existing repository directly:
The #1657 commit message explicitly says no scaffold, installer, or generated context file is needed. The current tree also has no
.antigravity-plugin/directory; Antigravity support consists of the README install command, theantigravity-tools.mdmapping, andtests/antigravity/.What does this PR change?
Updates the porting guide so Antigravity is described as a direct plugin install that runs the existing session-start hook. Removes the stale
.antigravity-plugin/install.sh/ generated context-file example from the generic context-file guidance.Is this change appropriate for the core library?
Yes. This is documentation for the core repo's own harness-porting guide, and it keeps that guide aligned with the Antigravity support that already landed in #1657.
What alternatives did you consider?
I considered adding an
.antigravity-plugin/scaffold to match the guide, but that would contradict the accepted #1657 implementation, which intentionally avoided a scaffold. I also considered removing Antigravity from the guide entirely, but it is a useful current reference integration; the guide just needs to describe its actual shape.Does this PR contain multiple unrelated changes?
No. It only updates Antigravity references in
docs/porting-to-a-new-harness.md.Existing PRs
#1656 added the porting guide before the final Antigravity implementation landed. #1657 added Antigravity support and states that no scaffold/installer/generated context file is needed. #1583 was a closed prior Antigravity attempt. This PR only reconciles the guide with the merged #1657 implementation.
Environment tested
Authoring environment disclosure: generated with GPT-5 in Codex CLI 0.137.0. Installed Codex plugins available in the session: Browser, Documents, Presentations, Sites, Spreadsheets, Superpowers.
New harness support (required if this PR adds a new harness)
Not applicable. This PR does not add a new harness.
Clean-session transcript for "Let's make a react todo list"
Evaluation
.antigravity-plugin/install.shand a generated context file path that do not exist in the accepted Antigravity implementation.agy plugin install https://github.com/obra/superpowersflow and no longer references the nonexistent Antigravity scaffold.Verification run after the change:
Rigor
superpowers:writing-skillsand completed adversarial pressure testing (paste results below)This is not a skills change. No skill text, prompts, red flags, rationalization lists, or behavior-shaping content were modified.
Human review