Skip to content

Peer Code Review — Submission Template

Your Name: Partner's Name: Partner's Product: Date:


What URL
Partner's GitHub repo
Partner's live product
Your GitHub repo (for reference)

Part 1: AI-Assisted Analysis

Run each prompt in Claude Code on your partner's repo. Paste the key output below.

Prompt 1: Project Structure

Analyze this project structure. List all directories and their purposes,
identify frontend vs backend files, and count total lines of code.

Paste output or summary here:


Prompt 2: Data Flow

Trace the main user flow from UI to database.
What happens when a user performs the core action?

Paste output or summary here:


Prompt 3: Architecture & Security

Identify the architecture pattern, code organization,
and any potential security concerns or code smells.

Paste output or summary here:


One claim I checked by hand

Pick one specific claim from the AI output above (for example, "the API key is only used on the server" or "the payments table has row level security"). Say where in the code you looked and whether the claim was true.


Part 2: Written Review

Architecture Observations

What patterns did you notice? How is the code organized?


Code Quality

What's done well? What could be cleaner?


Security Considerations

Any obvious vulnerabilities or concerns?


3 Specific Suggestions

# Suggestion Rationale
1
2
3

Part 3: Kick the Tires

Sign up and use the app as a real user for 10-15 minutes.

Did signup/onboarding work?

Core task — did it work?

What broke or errored?

What was confusing?

What worked well?

Screenshots of issues (paste below or link to images):


Overall Assessment

In 2-3 sentences: What's the strongest part of this codebase, and what's the single highest-impact thing your partner could improve?