Skip to content

Repository Quality Review Prompt V2

A prompt for performing repository-wide quality verification in checklist format.

Intended Use

  • Repository-wide quality verification
  • README.md quality check
  • Documentation consistency verification
  • Environment settings and security check
  • Code quality check
  • Project structure evaluation

Prompt Text

text
# Repository Quality Review Prompt V2

You are an expert in code review and repository structure analysis. Please perform a quality check of the entire repository according to the following checklist. Evaluate each item as "✅" (no problem), "❌" (problem exists), or "⚠️" (partial problem), and provide specific improvement suggestions for any issues found.

## Checklist

### 📝 README.md Quality Check
- [ ] Is the title centered?
- [ ] Is the header image centered? (use existing header image if present)
- [ ] Are tech stack badges properly placed and centered?
- [ ] Are emojis used effectively in each section to improve readability?
- [ ] Is documentation properly split and appropriately linked?
- [ ] Are installation instructions clearly documented?
- [ ] Are usage instructions clearly documented?
- [ ] Are screenshots and diagrams appropriately used?

### 📚 Overall Documentation Consistency
- [ ] Does README.md exist at each level? (create if missing)
- [ ] Does each level's README.md appropriately reference the upper level's README.md?
- [ ] Is each README.md content properly split without duplication?
- [ ] Is each README.md not too heavy, properly split into files?
- [ ] Are appropriate links placed in split files?
- [ ] Are consistent terms used across all documentation?
- [ ] Is the documentation structure logical across the entire repository?

### 🔒 Environment Configuration and Security
- [ ] Are `.env` and environment variables appropriately used?
- [ ] Are no API keys or passwords directly written in code? (OK in `.env`)
- [ ] Is `.env` properly listed in `.gitignore` file?
- [ ] Does `.env.example` exist with examples of required environment variables?

### 💻 Code Quality
- [ ] Are code comments appropriately documented?
- [ ] Are naming conventions consistent?
- [ ] Are there no unused code or commented-out code left behind?

### 📂 Project Structure
- [ ] Is the folder structure logical and easy to understand?
- [ ] Are dependencies appropriately managed?

## Output Format

Please output the checklist results in the following format:

### 📝 README.md Quality Check
- [✅/❌/⚠️] Is the title centered?
  - Problem and improvement suggestion (if problem exists)
- [✅/❌/⚠️] Is the header image centered?
  - Problem and improvement suggestion (if problem exists)
- ... (similarly for others)

### 📚 Overall Documentation Consistency
- [✅/❌/⚠️] Does README.md exist at each level?
  - Problem and improvement suggestion (if problem exists)
- [✅/❌/⚠️] Does each level's README.md appropriately reference the upper level's README.md?
  - Problem and improvement suggestion (if problem exists)
- ... (similarly for others)

(other sections in similar format)

### 🔍 Overall Assessment
Provide a concise overall assessment of the repository's current state, and suggest the top 3 most important improvements that should be prioritized.

### 📝 Specific Correction Examples
Provide specific code or markdown correction examples for the most important improvement points.

#### README.md Hierarchy Structure Check
Pay special attention to the following points:
1. Check if each directory has a README.md, and suggest creating one if missing
2. Confirm that each README.md appropriately references the upper README.md to avoid duplication
3. If a README.md is too long, suggest appropriate file splitting and link setup

---

Analyze the entire repository according to this checklist and clarify necessary improvements as a closing process for the development cycle.

How to Use

  1. Paste the prompt to AI
  2. Provide repository information to check
  3. Receive evaluation according to the checklist

Input Example

Simply provide the repository URL or file structure, and the checklist-based evaluation will be performed.

Output Example

Evaluation results (✅/❌/⚠️) for each checklist item, and specific improvement suggestions for any issues found.

Notes

  • Pay special attention to README.md hierarchy structure
  • It's important to properly split documentation and avoid duplication