devisland-change-verification

name	devisland-change-verification
description	Verify DevIsland repository changes before commit or handoff. Use when Claude Code changes DevIsland code, tests, project.yml, scripts, docs, packaging, skills, plugin architecture, or agent instructions and needs the project-specific build, test, documentation, and working-tree checks.

DevIsland Change Verification

Use this as the common finish line for DevIsland changes. Keep the check proportional to the risk, but do not skip verification silently.

Start

Read AGENTS.md first. For build details, read docs/agent/build-and-test.md.

Check the worktree before editing and before final handoff:

git status --short

Do not revert or stage unrelated user changes.

Standard Verification

Run the existing unit test wrapper before committing code changes:

./scripts/run-tests.sh

Prefer this over ad hoc xcodebuild test; it runs in isolated mode and avoids interfering with a running DevIsland instance.

For quick compile verification without killing or launching the app:

./scripts/build_and_run.sh --no-kill --no-run

Use this when tests are too broad for the immediate task, after project generation changes, or when the change is UI/runtime-facing.

Project File Changes

If project.yml changes, regenerate the Xcode project:

xcodegen generate

Never hand-edit generated .xcodeproj content. If source membership, resources, entitlements, build settings, or package dependencies need to change, update project.yml.

Documentation Check

After code, behavior, settings, commands, architecture, hook semantics, or packaging changes, decide whether docs must change. Check these docs by area:

• Build and tests: docs/agent/build-and-test.md
• Hooks and provider semantics: docs/agent/hook-providers.md
• Approval proxy, IPC, SQLite, PTY: docs/agent/approval-proxy.md
• Notch settings and UI behavior: docs/agent/ui-customization.md
• Plugin platform changes: docs/agent/plugin-architecture.md and docs/agent/plugin-architecture-implementation-plan.md
• Terminal focus and AoE navigation: docs/agent/terminal-focus-aoe.md
• Caffeine power behavior: docs/agent/caffeine.md
• OpenPeon CESP: docs/agent/openpeon-cesp.md
• Stability rules: docs/agent/stability-standards.md
• Top-level agent rules: AGENTS.md

If docs do not need changes, state that explicitly in the handoff.

When editing any SKILL.md, apply the same change to both skill trees (.claude/skills/ and .codex/skills/) unless the content is tool-specific. Diverged trees cause stale guidance for the other agent.

Handoff

Report:

• Changed behavior and important files.
• Verification commands run and their result.
• Any skipped checks and why.
• Remaining untracked or unrelated files.