sd0xdev Repo Intake
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 scripts/run-skill.sh repo-intake intake_cached.js --mode auto --top 10
Manifest Map（宣告依賴地圖）
Monorepo / multi-package repo 的 workspace 拓撲與宣告依賴圖。邊語義是
declares_dependency——manifest 裡寫了什麼，不證明 import、呼叫或 runtime 影響。
一律 fail-closed：整份檔案無法讀取／UTF-8 解碼、或 JSON document 無法解析則記
coverage skipped；已進入 Go/TOML recognizer 的相關不支援 construct 則記
partial。絕不產生猜測邊。
bash scripts/run-skill.sh repo-intake manifest_map.js # overview (md)
bash scripts/run-skill.sh repo-intake manifest_map.js --format json # 完整 envelope
bash scripts/run-skill.sh repo-intake manifest_map.js --reverse <selector> # 誰宣告依賴它
bash scripts/run-skill.sh repo-intake manifest_map.js --cycles # 宣告環偵測
| Flag | 說明 |
|---|---|
--format md|json |
預設 md；json 為完整 artifact，不受 --top 截斷 |
--top N |
md 清單截斷（預設 12） |
--reverse <sel> |
selector：節點 ID（ws:node:packages/a）或名稱（node:lodash / lodash）；多重匹配 exit 2 並列出候選 |
--cycles |
與 --reverse 互斥 |
--include-candidates |
把未經 controller 確認的 candidate workspace 納入架構節點集（預設排除） |
生態系：node / php / go / rust / python（辨識 manifest 見
scripts/config/repo-intake.json 的 manifest_map 段）。無效參數 exit 2。
資料模型、解析矩陣與凍結語法契約：references/manifest-map.md；完整規格：
docs/features/repo-intake-manifest-map/2-tech-spec.md。
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
## 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/manifest-map.md— Manifest map 資料模型、解析矩陣、凍結契約摘要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 |
scripts/manifest_map.js |
Workspace 拓撲 + 宣告依賴圖（overview / reverse / cycles） |
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/