feat: make SuperPaper the family parent of superfig and supertensor
House the two figure toolkits as git submodules under SuperPaper. The parent owns paper-note orchestration; children keep their own history, macros, and lint. DESIGN.md is the family contract.
This commit is contained in:
@@ -0,0 +1,50 @@
|
||||
# SuperPaper
|
||||
|
||||
母仓库:把一篇论文编成带 ledger 的中文讲义,并把图路由到独立的子仓库。
|
||||
|
||||
子仓库各自保有自己的 git 历史、lint 和不变量。母仓库只编排,不往任何一个 `.sty` 里塞笔记宏。
|
||||
|
||||
```
|
||||
superpaper/ this repo (orchestration)
|
||||
├── DESIGN.md family spec
|
||||
├── SKILL.md document-layer skill
|
||||
├── superfig/ submodule — architecture / pipeline / flow
|
||||
├── supertensor/ submodule — tensor faces / axes / shards
|
||||
└── superderive/ later — stepwise rewrite figures
|
||||
```
|
||||
|
||||
| 子仓库 | 画什么 | 远程 |
|
||||
|---|---|---|
|
||||
| [`superfig`](superfig/) | 节点、边、分组、机制框图 | `carrydela/SuperFig` |
|
||||
| [`supertensor`](supertensor/) | 形状对齐的张量公式图 | `carrydela/SuperTensor` |
|
||||
| `superderive` | 逐步代数改写图 | 尚未建 |
|
||||
|
||||
## Clone
|
||||
|
||||
```bash
|
||||
git clone --recurse-submodules \
|
||||
ssh://git@ssh.gitea.mygoband.com:2222/carrydela/SuperPaper.git
|
||||
# 已有工作副本:
|
||||
git submodule update --init --recursive
|
||||
```
|
||||
|
||||
Each child is also a standalone skill. Point an agent at `superfig/` or
|
||||
`supertensor/` when you only need that figure grammar. Point at this
|
||||
directory when the job is 读论文 / 脉络 / 推导 / 出图路由.
|
||||
|
||||
## Layout on disk
|
||||
|
||||
Under `/home/carry/myprj/tools/skills/` the old sibling paths are
|
||||
symlinks into this repo:
|
||||
|
||||
```
|
||||
skills/superpaper/ SuperPaper
|
||||
skills/superfig -> superpaper/superfig
|
||||
skills/supertensor -> superpaper/supertensor
|
||||
```
|
||||
|
||||
## Status
|
||||
|
||||
The family contract lives in [`DESIGN.md`](DESIGN.md). Figure children
|
||||
are usable now. The notes scaffold (`scripts/`, ledger, template) is
|
||||
the SuperPaper v1 PR chain in that document — not in this commit.
|
||||
Reference in New Issue
Block a user