repo-intelligence-brief

name	repo-intelligence-brief
description	Inspect a GitHub or local repository and produce a compact Codex-ready architecture/task brief. Use for repo onboarding, weekend project selection, fork analysis, setup discovery, extension ideas, or turning a source repo into a useful build plan.

Repo Intelligence Brief

Use this to turn a repo into a practical Codex work unit.

Intake

If the repo is remote, prefer a shallow clone into a bounded sources/ or vendor/ folder. Inspect before installing.

Run:

scripts/repo_snapshot.sh <repo>

Then read:

• README and docs index
• package manifests and lockfiles
• entry points
• tests and CI config
• license

Output

# Repo Intelligence Brief

## What It Is
## Why It Matters
## Architecture
## Setup Commands
## Extension Points
## Useful Patterns To Steal
## Risks And Trust Notes
## First Three Codex Projects
## Smallest Valuable Build

Rules

• Mark unverifiable trend claims as unverified.
• Do not run install scripts until the source-intake safety pass is complete.
• Keep the brief under 1200 words unless the user asks for deep research.
• Prefer actionable project ideas over generic summaries.

Use $sandbox-source-intake first when a repo asks for broad permissions, downloads binaries, or has suspicious install instructions.

Validation

• README, license, manifests, entry points, tests/CI, and docs index were checked when present.
• Setup commands are marked inspect-only unless actually run.
• Trend or popularity claims are verified or labeled unverified.