Skip to content

feat(core): add adopting-core-setup-repo reconciliation skill - #12

Merged
jonnyspicer merged 1 commit into
mainfrom
add-adopting-core-setup-repo-skill
Jul 20, 2026
Merged

feat(core): add adopting-core-setup-repo reconciliation skill#12
jonnyspicer merged 1 commit into
mainfrom
add-adopting-core-setup-repo-skill

Conversation

@jonnyspicer

Copy link
Copy Markdown
Contributor

Adds a core plugin skill capturing the operator playbook for adopting
core:setup-repo in an existing (partially standardized) repo, extracted from
the retina-tracker pilot (#5). This is the 6th deliverable of that pilot — the
knowledge was worth preserving where the next operator will find it.

Why in core (not the pilot repo or a user dir)

The value is for the next repo standardization (retina-gui, Phase 2 stacks),
so it belongs next to setup-repo and ships via the marketplace — not stranded in
the one repo where the pilot is already done.

What it covers

  • The engine skips existing files → reconcile the skipped ones by hand.
  • ci-python.yml installs deps but not a packaged repo → ModuleNotFoundError in
    CI → pythonpath = ["."].
  • Write perms alone don't post review comments → need track_progress +
    --allowedTools (inline-comment MCP tool).
  • A .gitignore that ignores .claude/ silently drops scaffolded config.
  • Public-repo @claude hardening via author_association guard.
  • permission_denials_count > 0 can be benign; verify via token scope + a real
    comment on a separate non-workflow PR.

Lifecycle note

Several sections describe template gaps tracked in #7#11. As those land, the
corresponding sections here should be pruned — keeping the skill and the template
in the same repo makes that easy. The durable core is the reconciliation playbook
and the verification refinements.

Bumps core 0.2.0 → 0.3.0.

Refs #5.

Operator playbook for piloting core:setup-repo in an EXISTING (partially
standardized) repo, extracted from the retina-tracker pilot (#5). Captures the
files the engine skips, the ci-python.yml packaged-repo import gotcha, the
allowedTools/track_progress requirement for posting review comments, the
.gitignore-swallows-.claude issue, public-repo @claude hardening, and the
permission_denials_count verification refinement.

Bumps core 0.2.0 -> 0.3.0 (new skill).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jonnyspicer
jonnyspicer merged commit d848114 into main Jul 20, 2026
2 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