pr-lessons

Extract coding-convention patterns from merged PR review comments into CLAUDE.md guidelines.

13|Updated May 19, 2024

Search Tags:#analysis #patterns #claude.md #guidelines #pr #pull-request #coding-conventions

Ready to run

npx skills add https://github.com/david-crespo/dotfiles --skill pr-lessons

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: pr-lessons
Source: https://github.com/david-crespo/dotfiles/tree/main/claude/skills/pr-lessons
Command: npx skills add https://github.com/david-crespo/dotfiles --skill pr-lessons

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes merged PR review comments to extract coding conventions and distill new CLAUDE.md guidelines for documentation.

Core Features & Use Cases

PR review pattern extraction: identify recurring feedback and conventions from merged PRs.
Change- and question-pattern classification: categorize threads into actionable guidance.
Guidelines distillation: produce concrete CLAUDE.md updates with examples.

Quick Start

Run the PR-mining workflow on a batch of merged PRs to surface new CLAUDE.md guidelines.

Frequently Asked Questions about pr-lessons

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I extract coding conventions from pull-request review comments?▼

To extract coding conventions from pull-request review comments, aggregate a batch of 30-50 merged PRs to surface recurring change requests and questions. The skill categorizes these threads and distills them into actionable CLAUDE.md guidelines with supporting PR examples.

How do I generate CLAUDE.md guidelines from merged PRs?▼

You generate CLAUDE.md guidelines from merged PRs by running a mining workflow that identifies recurring feedback patterns. It targets recent PRs, classifies change requests and questions, and produces concrete documentation updates not already captured in CLAUDE.md.

How many merged PRs do I need to analyze for coding-convention patterns?▼

You need a batch of roughly 30-50 merged PRs to accurately analyze coding-convention patterns across a monorepo. This batch size surfaces enough recurring review feedback to identify actionable conventions for generating new CLAUDE.md guidelines.

What is the best way to document undocumented coding conventions across a monorepo?▼

The best way to document undocumented coding conventions across a monorepo is to mine merged PR review threads for recurring feedback. This process categorizes change requests and questions, generating new CLAUDE.md guidelines with supporting PR examples.

Does the PR-mining workflow identify duplicate guidelines already in CLAUDE.md?▼

Yes, the PR-mining workflow identifies duplicate guidelines already in CLAUDE.md by generating new actionable guidelines that are not already documented. It distills coding-convention patterns from PR review comments while ensuring no redundant documentation is produced.