# 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/            submodule — stepwise rewrite figures
```

| 子仓库 | 画什么 | 远程 |
|---|---|---|
| [`superfig`](superfig/) | 节点、边、分组、机制框图 | `carrydela/SuperFig` |
| [`supertensor`](supertensor/) | 形状对齐的张量公式图 | `carrydela/SuperTensor` |
| [`superderive`](superderive/) | 逐步代数改写图 | `carrydela/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
skills/superderive        -> superpaper/superderive
```

## Status

v1 notes scaffold plus v2 `superderive` (phase default 2). Examples:
`excerpt-toy` (`align`), `pipeline-delegate`, `tensor-delegate`,
`derive-delegate`.

```bash
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
./scripts/preflight.sh
./scripts/test.sh
./scripts/build.sh --work examples/excerpt-toy
```