用途：在用户要求编写 Flix 代码、把其他语言翻译为 Flix、搭建 Flix 项目、修复编译器错误或添加 Java 互操作时使用。它是一份上下文工程手册，而非 Flix 教程，因为 Flix 在训练语料中样本稀少，直接套用 Scala/Haskell/Java 习惯会写出无法编译的代码。
主要能力：提供主动上下文加载规则，写非平凡代码前先读 references/design-principles.md，按导航地图抓取对应官方文档章节，并在 https://api.flix.dev/ 查标准库；按任务条件加载效果系统、互操作模式、标准库映射及 TypeScript/Python/Rust 翻译参考。给出标准库优先规则与任务到模块的速查表，并列出真正需要 Java 互操作的场景（HTTP、JSON、日期时间、加密、进程执行、标准输入）。
使用方式：按需抓取文档后再写代码；项目命令包括 flix init、flix check、flix run、flix test、flix build-fatjar，清单文件为 flix.toml。
关键限制：布尔运算用 and/or/not，禁止变量遮蔽、null、隐式转换、通配符导入、无用表达式，标准库参数主体在最后，记录字段用 # 访问，纯函数与带效果函数需在类型中区分。
适用场景：Flix 项目开发、跨语言迁移、效果系统与 Java 互操作。其他细节暂未提供。