maintain-simple_gh_aws_creds-base

Maintenance knowledge of the simple_gh_aws_creds library: its architecture (SetupGitHubRepo steps, the python-fire CLI, config loading), the invariants every change must keep, design decisions and the

SKILL.md

GitHub

simple_gh_aws_creds gives a GitHub repository its own IAM user and stores the user's access key as GitHub Actions secrets. All AWS (boto3 IAM) and GitHub (PyGithub) work is in SetupGitHubRepo in simple_gh_aws_creds/impl.py, as numbered step methods (s1x set up, s2x tear down, s3x maintain). The simple-gh-aws-creds command (cli.py, python-fire) is a thin layer: cli_config.build_setup() turns a JSON config file, an optional AWS profile, and a GitHub token read from a named environment variable into a SetupGitHubRepo, and each of the four commands calls one method on it.

For template conventions (layout, tests, docs, release), load pywf-oss-base.

References

Each cites only earlier ones.

<!-- BEGIN references index: generated by scripts/update_skill_index.py, do not edit by hand -->
  • Architecture (references/01-architecture.md): Read before changing any module, to know where a change belongs.
  • Invariants (references/02-invariants.md): Read before changing a step method or a CLI command.
  • Design Decisions (references/03-design-decisions.md): Read before proposing to change one of these choices.
  • Unit Tests (references/04-unit-tests.md): Read when writing or changing a test of impl.py or cli_config.py.
  • Known Traps (references/05-known-traps.md): Read when a change touches key files, GitHub secret names, PyGithub calls, CLI arguments, or the docs home page.
  • Integration Test (references/06-integration-test.md): Read before running the CLI against real AWS or GitHub, or when changing the config or workflow it uses.
<!-- END references index -->

Which skill to use

Job Skill Reads from this base
Run the integration test against the real AWS account and this GitHub repository, before each release maintain-simple_gh_aws_creds-run-integration-test 05-known-traps.md, 06-integration-test.md
Any other change to this repo this base, then the pywf-oss-* skill for the job the reference that covers the code being changed