Migrate essential GDP slash commands into .agents/commands

[raychrisgdp]

Problem

This repo has good agent operating guidance in AGENTS.md, but it does not yet have a repo-local slash-command surface. The GDP SDK repo (https://github.com/GDP-ADMIN/glaip-sdk/) already has a mature .agents/commands/ command system with provider adapters symlinked into Cursor/OpenCode/Windsurf/Copilot paths.

We should migrate the small, crucial subset into this repo so agents can use the same delivery workflow without copying the whole GDP command tree.

Goal

Create a simplified .agents/commands/ setup for this repo, adapted from GDP-ADMIN/glaip-sdk, with only the commands that matter for day-to-day issue-to-PR work.

Commands to migrate and simplify

Primary commands:

• /issue — create/refine a GitHub issue from a problem statement; check existing issues first; keep scope small and linked to current repo context.
• /goal — end-to-end implementation loop for a ready issue/slice: plan, implement, validate, commit/push, create/update PR, run local review unless explicitly stopped.
• /finish — merge-readiness gate: verify review/checks/status, merge only when approved, then cleanup worktree/branch.
• /review — local repo-native PR/code review that writes reviews/REVIEW_<branch>.md using the repo's review format.

Required dependencies/helpers, but simplified:

• _common-git-steps.md
• _common-github-steps.md
• _common-test-steps.md
• _common-review-workflow.md
• _common-review-report-format.md
• _common-closing-gate.md
• _goal-defaults.md
• _goal-cycle.md
• _goal-worker-dispatch.md only if still needed after simplification
• _finish-readiness-gates.md
• any tiny command-local helpers needed by /issue, /goal, /finish, /review

Avoid migrating the full GDP command catalog. Do not copy commands like release, learn, cleanup, explain, update-specs, fix-integration, etc. unless they are strictly necessary for the four core commands above.

Provider adapter paths

Canonical source should be:

.agents/commands/

Provider adapters should symlink to the canonical source where supported:

.cursor/commands -> ../.agents/commands
.opencode/command -> ../.agents/commands
.windsurf/workflows -> ../.agents/commands
.github/prompts -> ../.agents/commands

If a provider path already exists or has incompatible structure, document the decision instead of overwriting silently.

Adaptation requirements

• Rewrite commands for this repo, not GDP SDK specifics.
• Keep commands short enough that an agent will actually follow them.
• Preserve the local worktree rule from this repo's AGENTS.md.
• Preserve the repo verification commands:

  uv run python -m unittest tests.test_app tests.test_readme -v
  uv run python -m py_compile app.py scripts/snapshot_dashboard.py
  scripts/review.sh

• Preserve source-provenance and token-definition review focus from AGENTS.md.
• /review should write to reviews/REVIEW_<branch>.md and use this repo's concerns: dashboard data provenance, token semantics, cost wording, UI/accessibility, simulated mode, and performance regressions.
• /goal should not create large monolithic changes; it should respect small PRs and stop/ask when scope expands.
• /issue should not implement; it only creates/refines the issue and records next action.

Acceptance criteria

• .agents/commands/ exists and contains simplified /issue, /goal, /finish, /review docs.
• Only necessary helper docs are added; no bulk copy of the whole GDP command tree.
• Provider adapter symlinks are created or documented if intentionally skipped.
• AGENTS.md is updated with a short command map and symlink note.
• README or .agents/commands/README.md explains the command set and recommended order.
• Commands reference this repo's real verification workflow and worktree policy.
• REVIEW_MODE=docs scripts/review.sh passes for command/docs-only changes.

Source reference

Use the existing implementation in:

https://github.com/GDP-ADMIN/glaip-sdk/
.agents/commands/

Local reference path if available:

/home/raymond-christopher/glaip-sdk/.agents/commands/

Treat that repo as a source of patterns, not as a file dump. The deliverable should be a lean, repo-specific command surface.