Skip to content

Pilot: adopt core:setup-repo in a Python repo #5

Description

@jonnyspicer

First real-world adoption of the core:setup-repo skill (shipped in PR #1) to validate it end-to-end and start the org-wide consistency rollout.

Goal

Run core:setup-repo against one existing Python repo and land the standard setup: .claude/settings.json (marketplace + core), CLAUDE.md, shared rules, the corrected Claude review workflows, and the Python tooling (ruff/pytest, uv-based CI).

Candidate repos

retina-gui or retina-tracker (both Python; retina-gui already trends to the SF/ruff defaults).

Steps

  • Ensure core@offworld is installed at user scope (/plugin marketplace add offworldlabs/claude-shared, /plugin install core@offworld).
  • In the target repo, run "set this repo up per claude-shared" (invokes core:setup-repo).
  • Review the scaffolded files; reconcile anything the skill skipped because a file already existed.
  • Add the CLAUDE_CODE_OAUTH_TOKEN repo secret and land the review workflows on the default branch (see docs/runbooks/github-actions-claude-review.md).
  • Open a normal PR and confirm a claude[bot] review comment posts (also fixes the "green review, no comment" permission issue on that repo).

Acceptance criteria

  • The repo has the standard .claude/, workflows, and tooling with no clobbered pre-existing files.
  • A PR gets an automated Claude review comment.
  • Any friction found in the skill's interactive procedure is filed as a follow-up.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions