---
name: repository-onboarding
description: "Build a reliable map of a codebase before changing it."
license: CC0-1.0
metadata:
  author: "SI Editorial"
  version: "1"
---

# Understand an unfamiliar repository

## When to use
Build a reliable map of a codebase before changing it.

## Workflow
1. Read repository instructions, manifests, entry points, and tests.
2. Trace one representative request from UI to persistent data.
3. Summarize boundaries, conventions, commands, and known gaps with file references.
4. Distinguish observed behavior from assumptions. Make no changes unless asked.

## Boundaries
Use only tools and data authorized for the task. Ask for missing requirements when they affect the result. Report what you verified and what you could not verify.

## Try it
Explain how this repository handles sign-in and protected pages.

## Success looks like
A concise map with exact code references and a recommended starting point.