tianole/docs/agents

Agent 文档

这个目录专门放面向 AI / agent 的项目材料，不和内核设计文档混放。

根入口文档在仓库根目录的 AGENTS.md。

建议内容：

• code-style.md：agent 修改代码时必须遵守的代码组织和风格规则。
• kernel-design.md：顶层内核设计约束，说明子系统边界、调用方向、生命周期和设计变更流程。
• linux-layout.md：Tianole 和 Linux 顶层目录的映射与取舍。
• session-notes/：实现日志和阶段结论。
• tasks/：适合 agent 执行的边界清晰任务，按路线阶段拆分。
• prompts/：可复用提示词和约束。
• checklists/：启动、验证、回归检查单。

正式架构决策仍然放在 docs/，然后在 agent 任务文档里引用它们。

当前任务入口：

• code-style.md：代码风格和文件组织规则。
• kernel-design.md：顶层内核设计约束。
• linux-layout.md：Linux 顶层目录映射。
• tasks/README.md：agent 任务索引。
• tasks/02-cpu-interrupts.md：下一阶段，GDT/TSS/IDT、异常入口和 trap frame。
• ../roadmap.md：总路线和阶段依赖。

当 agent 修改代码且影响下列内容时，应该同步更新这里或 docs/：

• 架构边界
• 目录结构
• 构建方式
• 阶段计划
• 协作约定