Future: fully automate scoped token / GitHub App credential provisioning during repo bootstrap

Open
#264 0 comments 0 reactions 1 assignee View on GitHub

@jdfalk is already working on this.

Since Apr 25, 2026.

Assessment

This issue has not been assessed yet.

Description

ci/cd documentation enhancement priority: medium

Tracked from bootstrap-repo skill design discussion (2026-04-24).

Context

The new bootstrap-repo skill (see .claude/skills/bootstrap-repo/) creates and configures repos to ghcommon standards but stops short of provisioning the secrets the release workflow needs (CI_APP_ID, CI_APP_PRIVATE_KEY, etc). Today it prints a manual checklist directing the user to setup-ci-app.sh.

Desired end state

Single-command bootstrap that ends with a fully-functional release workflow on first push:

  • Skill creates or attaches a scoped GitHub App with the minimum permissions needed by the workflows in the chosen flavor (action / library / service).
  • Generates and installs the App's private key as a repo secret.
  • Records App installation IDs where workflows expect them.
  • Idempotent: re-running on an already-bootstrapped repo is a no-op.

Why deferred

Secret provisioning has higher blast radius than the rest of bootstrap and benefits from settling the skill's other surface area first. Doing it manually via setup-ci-app.sh is acceptable for now.

Acceptance

  • bootstrap_repo.sh --with-secrets (or equivalent) succeeds end-to-end on a fresh repo with no manual steps after.
  • Documented in docs/standards/ under each flavor's "secrets" section.
Dominant language
Python
Stars
2
Forks
0
Avg merge
18h 8m
Merged PRs (30d)
14

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from falkcorp/github-common

All issues in falkcorp/github-common

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.