# Repo Intake

> Project initialization inventory (one-time), for first onboarding a project or rebuilding cache after structural changes. Not for: day-to-day development (read cache directly), finding specific files (use code-trace). Output: project map with entrypoints + test map + next steps.

- Skill: `hmj1026/repo-intake` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add hmj1026/repo-intake`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hmj1026/repo-intake/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hmj1026 (https://skillmd.com/u/hmj1026)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/hmj1026/repo-intake

---


# Repo Intake

`$SKILL_DIR` denotes the physical directory containing the selected `SKILL.md`;
it is path notation, not an ambient environment variable or repository-root
lookup. Resolve it before running intake from an arbitrary consumer cwd.

## When to Use

- First time onboarding a project
- Rebuilding cache after major project structural changes
- Cache expired, needs updating

## When NOT to Use

- Already familiar with project structure (read cache directly)
- Only need to find specific files (use Glob/Grep)
- Day-to-day development (cache already exists)

## Workflow

```
Docs -> Entrypoints -> Tests Map -> Next Steps
```

## Usage

```bash
node "$SKILL_DIR/scripts/intake_cached.js" --mode auto --top 10
```

## Cache Location

Cache stored at: `~/.claude/cache/repo-intake/<repoKey>/`

| File          | Description             |
| ------------- | ----------------------- |
| `latest.md`   | Latest scan results     |
| `latest.json` | Latest scan results (JSON) |
| `LATEST.json` | Cache metadata          |

## Output

```markdown
## Overview

<summary>

## Entrypoints

- {CONFIG_FILE}
- {BOOTSTRAP_FILE}

## Test Map

| Type        | Pattern           |
| ----------- | ----------------- |
| Unit        | test/unit/        |
| Integration | test/integration/ |
| E2E         | test/e2e/         |

## Next Steps

- <questions>
```

## Verification

- Output includes Overview, Entrypoints, Test Map, Next Steps
- Entrypoints correctly identify `{CONFIG_FILE}`, `{BOOTSTRAP_FILE}`
- Test Map covers Unit/Integration/E2E layers

## References

- `references/archived/MIDWAY_HEURISTICS.md` — Legacy MidwayJS heuristics (archived, for reference only)

## Scripts

| Script | Purpose |
|--------|---------|
| `scripts/intake_cached.js` | Main intake with caching |
| `scripts/scan_repo.js` | Full repo scanner (framework-agnostic) |
| `scripts/scan_delta.js` | Delta scan for changed files |

## Examples

```
Input: repo-intake
Action: Execute intake script -> Output project map
```

```
Input: repo-intake save
Action: Execute intake script -> Output and write to docs/ai/intake/
```

