Skip to content

fix: write generated guidance as positive instructions - #613

Open
chubes4 wants to merge 1 commit into
mainfrom
fix/positive-guidance-wording
Open

chubes4 wants to merge 1 commit into
mainfrom
fix/positive-guidance-wording

Conversation

@chubes4

@chubes4 chubes4 commented Sep 20, 2026

Copy link
Copy Markdown
Member

Rewrite the generated WordPress Source and Homeboy AGENTS.md sections as positive capability/instruction statements, without weakening the installed-tree, checkout, Homeboy-ownership, or authorized-fallback boundaries.

What changed

  • guidance/wordpress-source.workspace.sh: treat installed WordPress as reference material and send edits to the configured repository checkout.
  • guidance/homeboy.sh: keep Homeboy as the normal owner; use --help-full for configured alternative-route syntax; complete an authorized fallback in an isolated linked worktree with verification and retained evidence, then resume subsequent tracked work through Homeboy.
  • Related tests now pin the positive phrasing.

Boundaries preserved

  • Installed WordPress remains reference material.
  • Code changes belong in configured repository checkouts.
  • homeboy release / homeboy deploy still run only when the user explicitly asks.
  • Direct runtime fallback still requires explicit operator authorization, an isolated tracker-linked worktree, deterministic verification, AI disclosure, and recorded evidence.
  • Homeboy remains the owner of subsequent tracked coding work.

Verification

  • bash tests/workspace-installation.sh — pass
  • bash tests/source-mode.sh — pass
  • bash tests/verify.sh — pass
  • bash tests/agents-md-guidance.sh — all guidance-content assertions pass (Homeboy ownership, --help-full, authorization, isolated worktree, verification, AI disclosure, fallback finalization)

AI assistance

This PR was written with AI assistance from OpenCode using xai/grok-4.6. The model inspected the guidance sources and related tests, rewrote the user-facing prose as positive instructions, updated the pinned assertions, ran the relevant shell tests, and opened this pull request.

Tell agents to use installed WordPress as reference material and to
edit configured checkouts. Keep Homeboy as the owner of tracked work
and route authorized fallback through documented help, isolated
worktrees, and retained evidence.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant