# mindfold-ai/Trellis 研究域 Agent 指南

本目录维护 `mindfold-ai/Trellis` 的独立研究域。

## 目录职责

```text
mindfold-ai-trellis/
├── README.md  # 研究域入口和判断层
├── AGENTS.md  # 本目录维护规则
├── domain.yml # 事实摘要层：仓库元数据、研究角色、来源证据
├── analysis.md # L1 结构化研究结论、可迁移做法、风险和验证动作
├── deep-dive.md # L2 结构深度研究、关键机制和本仓应用建议
└── raw/       # 原始事实层：拉取到本地的一手材料快照
```

## 维护规则

- 本目录只研究 `mindfold-ai/Trellis`，不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`，并更新 `observed_at`。
- `raw/` 保存原始事实层，必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件；稳定事实摘要再同步到 `domain.yml`。
- README 只写判断、定位、使用方式和后续观察点，不堆外部 README 全文。
- `analysis.md` 写 L1 结构化理解；`deep-dive.md` 写 L2 结构证据、关键机制和可迁移模式。
- Trellis 使用 AGPL-3.0 许可证；本仓只能研究机制和引用事实，不直接复制代码或模板实现。
- 与通用 Harness 范式的横向比较放到 `docs/research/harness/` 或独立对比文档，不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc` 和 `make test`。