Skip to content

chore(agents): add codex-review and ship-pr skills, vendor frontend-design - #13

Merged
daniel-tsx merged 1 commit into
mainfrom
chore/review-and-ship-skills
Oct 24, 2026
Merged

daniel-tsx merged 1 commit into
mainfrom
chore/review-and-ship-skills

Conversation

@daniel-tsx

Copy link
Copy Markdown
Owner

What and why

Encode the two procedures every task repeats as local skills, and add a design skill for the UI revamp. codex-review runs the T2 cross-model review (Codex read-only against origin/main, fallback subagent, triage). ship-pr prepares and opens PRs only after explicit authorization. frontend-design (anthropics/skills) guides visual direction. grill-me is removed because grilling covers it. AGENTS.md now routes to these skills, fixes the stale codex review --base main (local main can lag in worktrees) and adds /security-review for auth, tenancy, billing/payments or secrets.

Review guide

  • Read carefully: .agents/skills/codex-review/SKILL.md and .agents/skills/ship-pr/SKILL.md (the .claude copies are identical and CI-checked). Check that the procedures match AGENTS.md and never push without authorization.
  • Read carefully: scripts/sync-agent-skills.mjs (grill-me adapter removed, LICENSE or LICENSE.txt accepted) and scripts/check-engineering-workflow.mjs (mirror check for the two local skills).
  • Skim: frontend-design files (byte-identical to upstream, Apache-2.0), manifest entry and hashes, removed grill-me directories, docs/AI_WORKFLOW.md provenance edits.
  • Least confident about: the exact codex exec invocation across Codex CLI versions (-c model_reasoning_effort, saving the final message). It was verified on this machine with codex review, not with this exact exec command.
  • Tests removed, weakened or skipped: none.

Task size

T1: agent workflow files, docs and skill-sync scripts. No application code and no T2 paths (Review signals: no T2-area files).

Checks

Result Command Scope / notes
PASS node scripts/sync-agent-skills.mjs --check 8 vendored skills, both hosts
PASS node scripts/check-engineering-workflow.mjs engineering-workflow plus codex-review and ship-pr mirrored
PASS frontmatter parse 3 new skills on both hosts
PASS node --test scripts/*.test.mjs 33/34; the dotenv test needs installed dependencies (not installed in the worktree)
PASS node scripts/check-migration-history.mjs origin/main HEAD no migration changes
PASS node scripts/check-pr-review-signals.mjs origin/main HEAD no T2-area or guard files
PASS git diff --check, relative link check changed Markdown files
NOT RUN pnpm lint/test/build/typecheck no application code changed; dependencies not installed in the worktree
NOT RUN hosted CI runs on this PR

Unverified boundaries

Agent behavior with the new skills (whether Claude invokes codex-review at the T2 review step on its own) is untested until the first real T2 task.

Review

T1 self-review by the author. No independent review: no T2 or guard paths changed.

Docs and temporary files

AGENTS.md and docs/AI_WORKFLOW.md updated as owning documents. Local task directory .tmp/review-and-ship-skills/ (worktree and transfer bundle) stays until merge.


Generated by Claude Code

…esign

- codex-review (local): package a factual brief and the reviewed SHA,
  run Codex read-only against origin/main (designs too), fall back to a
  fresh read-only subagent when Codex cannot run, triage each finding
  (accept/reject with evidence/human decision), max two correction rounds
- ship-pr (local): rebase onto origin/main, migration and review-signal
  guards, pre-PR checks, review prerequisites, PR description from the
  template, push and gh pr create only after explicit authorization,
  worktree cleanup after merge
- Vendor frontend-design from anthropics/skills@dbd4588f (Apache-2.0,
  LICENSE.txt) for both hosts; sync accepts LICENSE or LICENSE.txt
- Remove grill-me (grilling covers it) and its Codex adapter in sync
- AGENTS.md: Review uses codex-review (fixes the stale `--base main`),
  /security-review for auth, tenancy, billing/payments or secrets;
  ship-pr for PRs; frontend-design for visual direction
- check-engineering-workflow also verifies the two local skills mirror

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015v69WpyGF25M7eMDxFThpE
@daniel-tsx
daniel-tsx merged commit 7f5e1c2 into main Oct 24, 2026
5 checks passed
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