git-practices

A personal grab-bag of git workflow tooling, shell config, Claude Code skills, SQL helpers, and an AI-pairing methodology for junior engineers. Each top-level directory is independent — clone the repo and pull in only what you want.

What's here

Path	What it is
scripts/	Git workflow scripts (merge into ephemeral branches, reset branches, send notifications, AWS SSM helpers).
dotfiles/	Shell config: bashrc.overrides (aliases, git/AWS shortcuts) and repohue (per-repo terminal colours). See dotfiles/README.md.
skills/	Claude Code skills: dependabot-triage + dependabot-triage-py (automated CVE triage), session-loop (multi-day project pause/resume toolkit). Built from SKILL.md.tmpl templates via a {{include}} resolver, with reusable fragments under skills/_shared/.
socratic-method/	Makes an AI coding agent (Claude Code, Codex, etc.) act as a Socratic tutor for a junior engineer — question-first across 7 phases (pre-coding, design review, PR review, postmortems, estimation) instead of just generating code. See socratic-method/README.md.
.claude/ and .agents/	Claude Code project configuration and agent definitions.
LLM Custom Instructions.md	Custom instructions / coding protocol used with LLMs (skeptical-sparring persona, phased workflow).
idempotent_constraints.sql	Example pattern for idempotent Postgres ADD CONSTRAINT migrations.

Quick install paths

Pick the parts you want — none of them depend on each other.

Shell config + per-repo terminal colours

git clone https://github.com/<your-fork>/git-practices ~/tern-work/git-practices

# Theme engine
ln -s ~/tern-work/git-practices/dotfiles/repohue.sh ~/.config/repohue.sh

# Aliases + helpers (bash)
ln -s ~/tern-work/git-practices/dotfiles/bashrc.overrides ~/rao_bashrc_overrides
echo 'if [ -f ~/rao_bashrc_overrides ]; then . ~/rao_bashrc_overrides; fi' >> ~/.bashrc

# Open a new terminal. cd into any git repo to see colours kick in.

Full details and customisation knobs: dotfiles/README.md.

Git workflow scripts

Put scripts/ on your PATH:

echo 'export PATH=$PATH:$HOME/tern-work/git-practices/scripts' >> ~/.bashrc

Then use them directly: merge_into.sh <target-branch>, new_pr.sh, ssm_login.py, etc. Most scripts have inline --help or are short enough to read.

Claude Code skills

Each skill lives under skills/<name>/. Skills with a SKILL.md.tmpl are compiled to SKILL.md by resolving {{include ...}} directives against shared fragments:

scripts/build-skill.sh skills/dependabot-triage    # one skill
scripts/build-all-skills.sh                          # every templated skill

Publish a skill to its dedicated repo (and auto-build first):

scripts/publish-skill.sh skills/dependabot-triage
scripts/publish-skill.sh skills/dependabot-triage-py
scripts/publish-skill.sh skills/session-loop

Socratic method (AI pair-teaching for junior engineers)

Read socratic-method/README.md first — status and which phases have seen less real-world use. Setup (Claude Code, Codex, or any AGENTS.md-reading tool) is covered there in full: socratic-method/README.md#setup.

License

MIT — see LICENSE.