rseng-pair-programming

Solid

Covers the agent as an effective pair programmer and pull-request review buddy for research software: driver-navigator collaboration with think-aloud reasoning, ping-pong test-driven pairing, keeping the human in charge of scientific decisions, pre-review of pull requests before human reviewers see them, and constructive review-comment craft. Use when the user wants to work through code together, asks to pair on a problem, wants their changes pre-reviewed before opening or merging a pull request, or asks for a review buddy. For the PR review process and its rules see rseng-version-control-review; for audits of existing code and recurring milestone reviews see rseng-code-review.

AI & Automation 14 stars 2 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 83/100

Stars 20%
39
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Pair programming and PR review buddy Pairing and review are the two highest-bandwidth quality practices software teams have, and both translate directly to human-agent collaboration - with one non-negotiable adaptation for research software: the human owns the scientific decisions (what to compute, what counts as correct, what tolerances mean); the agent contributes engineering rigor, pattern knowledge and tirelessness. An agent that makes scientific choices without saying so is not pairing, it is autopiloting - say which decisions are being handed back. ## Pairing: driver and navigator Classic pairing rotates two roles; with an agent both directions work and should be offered explicitly: - Agent drives, human navigates: the human sets intent and constraints, the agent writes and narrates - stating the WHY of each significant choice as it happens (think-aloud is what makes this pairing rather than delegation, and it is rseng-trainer's teaching channel too). Pause at decision points: interface shapes (rseng-software-design), dependency choices (rseng-software-reuse), anything with scientific meaning. - Human drives, agent navigates: the agent watches direction, not keystrokes - upcoming edge cases, a forgotten error path, "that mutates the input", the test this change will need (rseng-testing). Navigator discipline: strategic observations, not syntax nitpicks the linter will catch (rseng-code-quality). - Ping-pong TDD as a pairing rhythm: one side wri...

Details

Author
fdiblen
Repository
fdiblen/rseng-agent-skills
Created
4 days ago
Last Updated
4 days ago
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category