Soham Patankar
fbe1e9977f
All-platform progressive-disclosure skill split + generator (addresses #1106). Splits each platform's skill into a lean core (~615 lines, full default pipeline inline) + on-demand references/, generated from a single source via tools/skillgen with a CI/pre-commit drift gate. 13 hosts split, aider/devin stay monoliths. Also fixes the stale bare-path bugs across the previously hand-maintained variants and moves the always-on blocks into packaged markdown. Verified: all 5 generator guards pass, byte-verbatim load-bearing slices, lean cores self-sufficient on the default path across all 13 split hosts, references gated to non-default branches, description preserves the graphify-out-query-first clause. Supersedes #1119 (Claude-first subset). Known follow-up applied on top: harden _always_on() against a missing packaged file so a partial install can't brick the CLI.
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# graphify reference: GitHub clone and cross-repo merge
|
|
|
|
Load this when the user passed one or more `https://github.com/...` URLs, or named several local subfolders to merge into one graph.
|
|
|
|
### Step 0 - Clone GitHub repo(s) (only if a GitHub URL was given)
|
|
|
|
**Single repo:**
|
|
```bash
|
|
LOCAL_PATH=$(graphify clone <github-url> [--branch <branch>])
|
|
# Use LOCAL_PATH as the target for all subsequent steps
|
|
```
|
|
|
|
**Multiple repos (cross-repo graph):**
|
|
```bash
|
|
# Clone each repo, run the full pipeline on each, then merge
|
|
graphify clone <url1> # → ~/.graphify/repos/<owner1>/<repo1>
|
|
graphify clone <url2> # → ~/.graphify/repos/<owner2>/<repo2>
|
|
# Run /graphify on each local path to produce their graph.json files
|
|
# Then merge:
|
|
graphify merge-graphs \
|
|
~/.graphify/repos/<owner1>/<repo1>/graphify-out/graph.json \
|
|
~/.graphify/repos/<owner2>/<repo2>/graphify-out/graph.json \
|
|
--out graphify-out/cross-repo-graph.json
|
|
```
|
|
|
|
Graphify clones into `~/.graphify/repos/<owner>/<repo>` and reuses existing clones on repeat runs. Each node in the merged graph carries a `repo` attribute so you can filter by origin.
|
|
|
|
**Multiple local subfolders (monorepo or multi-service layout):**
|
|
|
|
The skill pipeline writes all intermediate and final outputs to `graphify-out/` in the current working directory. Running the skill on each subfolder separately will clobber the same output dir. Instead, use the CLI directly for each subfolder — it places `graphify-out/` *inside* the scanned path:
|
|
|
|
```bash
|
|
graphify extract ./core/ # → ./core/graphify-out/graph.json
|
|
graphify extract ./service/ # → ./service/graphify-out/graph.json
|
|
graphify extract ./platform/ # → ./platform/graphify-out/graph.json
|
|
# Add --backend gemini|kimi|openai|deepseek|claude-cli depending on which API key you have set
|
|
|
|
# Then merge at the project root:
|
|
graphify merge-graphs \
|
|
./core/graphify-out/graph.json \
|
|
./service/graphify-out/graph.json \
|
|
./platform/graphify-out/graph.json \
|
|
--out graphify-out/graph.json
|
|
```
|
|
|
|
Once `graphify-out/graph.json` exists, the fast path above takes over: any codebase question runs `graphify query` directly on the merged graph — no re-extraction, no size gate.
|