Flujo de trabajo de Session Beta

Session es el segundo modelo de datos central de Forge. Cada discusión de producto se almacena en una Session, que recoge la línea de tiempo completa de la conversación, las decisiones y los resultados producidos por los Agents.

Relación entre Session y Ontology

Session es la línea de tiempo dinámica; Ontology es el conocimiento estructurado estático. Las decisiones de una Session → se escriben o modifican en los nodos de Ontology.

Modelo de Session

Session {
  id            // sess_...
  title         // "添加成本告警"
  participants  // [人类, PM Agent, Architect Agent, Code Agent]
  ontology      // 关联的 Ontology 节点列表
  turns         // 对话轮次
  artifacts     // 产出物：PRD、ADR、PR 链接
  status        // active / paused / shipped
}

---

Roles

Tres tipos de Agent

Desde un requisito difuso hasta un PR fusionado, tres tipos de Agent colaboran por relevos.

PM Agent

Descompone requisitos difusos en historias de usuario, criterios de aceptación y prioridades.

Architect Agent

Modelado de arquitectura, selección de tecnología e identificación de riesgos; escribe en el subárbol Architecture de Ontology.

Code Agent

Escribe código, ejecuta pruebas y abre PR a partir de los resultados de los dos anteriores.

---

De extremo a extremo

El flujo completo de 0 a PR

flowchart TD
    H["人类: 想做一个成本超 50 元每日告警"]
    H --> PM["PM Agent: 拆为 3 个 UserStory"]
    PM --> US1["US-1 实时聚合每日成本"]
    PM --> US2["US-2 超阈值触发通知"]
    PM --> US3["US-3 通知模板配置"]
    US1 --> AR["Architect Agent: 决定技术方案"]
    US2 --> AR
    US3 --> AR
    AR --> A1["数据源: Lumen CostTracker API"]
    AR --> A2["调度: 每 1 分钟 cron"]
    AR --> A3["通知渠道: Webhook + 邮件（复用 Lurus Platform）"]
    AR --> A4["写入 Ontology: Architecture/cost-alert.md"]
    A1 --> CD["Code Agent: 代码实现"]
    A2 --> CD
    A3 --> CD
    A4 --> CD
    CD --> C1["生成 Go handler + test"]
    CD --> C2["生成 DB migration"]
    CD --> C3["开 PR: feat(cost-alert): add daily threshold"]
    C3 --> C4["等待人类 review & merge"]

---

Trazable

Trazabilidad de decisiones con WAL

Gracias al WAL del motor Kova, cada paso de conversación y cada decisión quedan persistidos. En cualquier momento puedes:

Rastrear "por qué se eligió NATS en lugar de Redis Streams"

Localizar "qué Session escribió por última vez en Architecture/auth.md"

Reproducir (Replay) una Session completa, para realizar retrospectivas

---

Próximos pasos

Próximos pasos

Profundizar en OntologyHoja de rutaMotor Kova