# How to study

**Offline.** Open `../index.html` or read this tree. No network.  
`make test` uses stdlib only. **xai** = explainable AI.

Order: map → Inkling → Laguna S 2.1 → Kimi K3 → compare.

## 1. Map (20 min)

1. [README.md](README.md)  
2. [derived/DASHBOARD.md](derived/DASHBOARD.md)  
3. [shared/GLOSSARY.md](shared/GLOSSARY.md)  
4. [compare](shared/comparisons/inkling-vs-kimi-k3.md) — skim  

## 2. Inkling (half day)

Weights + code → implementation truth.

1. [models/inkling/README.md](models/inkling/README.md)  
2. [book/00-map.md](models/inkling/book/00-map.md)  
3. [derived/SPEC.md](models/inkling/derived/SPEC.md) + [layer_schedule.md](models/inkling/derived/layer_schedule.md)  
4. [book/01-architecture.md](models/inkling/book/01-architecture.md)  
5. [code-study/01-modular-walkthrough.md](models/inkling/code-study/01-modular-walkthrough.md) + `reference/transformers-inkling/modular_inkling.py`  
6. code-study 02–03 · book 02–04  

## 3. Laguna S 2.1 (half day)

Open mid-size MoE + day-0 serve stack → agentic coding truth.

1. [models/laguna-s-2.1/README.md](models/laguna-s-2.1/README.md)  
2. [book/00-map.md](models/laguna-s-2.1/book/00-map.md)  
3. [derived/SPEC.md](models/laguna-s-2.1/derived/SPEC.md) + [layer_schedule.md](models/laguna-s-2.1/derived/layer_schedule.md) + [class_index.md](models/laguna-s-2.1/derived/class_index.md)  
4. [book/01-architecture.md](models/laguna-s-2.1/book/01-architecture.md)  
5. [code-study/01-config-walkthrough.md](models/laguna-s-2.1/code-study/01-config-walkthrough.md)  
6. [code-study/02-modeling-walkthrough.md](models/laguna-s-2.1/code-study/02-modeling-walkthrough.md)  
7. [code-study/03-serve-and-thinking.md](models/laguna-s-2.1/code-study/03-serve-and-thinking.md)  
8. [code-study/04-chat-and-tools.md](models/laguna-s-2.1/code-study/04-chat-and-tools.md) · [special_tokens](models/laguna-s-2.1/derived/special_tokens.md)  


7. benches + limits: book 03–04  

## 4. Kimi K3 (half day)

API live → product + KDA theory.

1. [models/kimi-k3/README.md](models/kimi-k3/README.md)  
2. [book/00-map.md](models/kimi-k3/book/00-map.md)  
3. [derived/SPEC.md](models/kimi-k3/derived/SPEC.md) + [lineage.md](models/kimi-k3/derived/lineage.md)  
4. [book/01-architecture.md](models/kimi-k3/book/01-architecture.md)  
5. [code-study/02-kda-background.md](models/kimi-k3/code-study/02-kda-background.md) + arXiv:2510.26692  
6. [code-study/01-api-protocol.md](models/kimi-k3/code-study/01-api-protocol.md)  
7. book 03–04 · [open_questions.md](models/kimi-k3/derived/open_questions.md)  

## 5. Compare (30 min)

Re-read [inkling↔kimi](shared/comparisons/inkling-vs-kimi-k3.md) and [tri-compare](shared/comparisons/laguna-s-vs-inkling-vs-kimi.md):

- Long-context bet: relative+SWA vs YaRN+SWA vs KDA?  
- MoE for production: 8B active open vs 41B open vs 16/896 without disclosed active?  
- What would you fine-tune first, on which base?  

## 6. After K3 weights / Laguna refresh

```
make refresh MODEL=kimi-k3
make check
```

Then add a real code walkthrough under `models/kimi-k3/code-study/` (mirror Inkling).