design-harness — evidence board for defensible design

design-harness — evidence board for defensible design

核心判断

design-harness 值得进入 wiki，因为它把“读资料 → 形成想法 → 输出设计”做成一个 evidence board，而不是让 agent 在一次长上下文里直接综合。它强调 source cards、human-owned idea cards、traceable output、append-only logs 和 self-contained HTML canvas。对 Hermes / llm-wiki 来说，它提供了一个重要模式：知识综合不只需要 Markdown 页面，还需要能展示“为什么这个设计是这样”的证据图。

这对用户重要：llm-wiki 目前擅长 raw archive、source/concept pages、wikilinks 和 vector search，但对“一个决策如何由来源和用户判断演化而来”的可视化支持较弱。design-harness 的 source / idea / output 三世界结构，可以启发未来的复杂研究、产品设计、Hermes workflow 改造和 wiki 自我优化文章。

机制：sources / ideas / output 三层分离

README 中最有价值的机制包括：

1. Sources file themselves：用户丢入 papers、repos、blog posts 后，agent 为每个来源建 card、评分并锚定 claims。
2. Ideas are human-owned：只有人类创建 idea card；agent 负责链接证据、聚类邻居、暴露冲突，而不是替人做价值判断。
3. Output assembles on command：只有用户说 go 时，幸存 idea 才组装成 deliverable；后续编辑可流回 ideas。
4. Traceability：每个设计元素都能回溯到 idea 和 source，每张 card 有 append-only log。
5. Plain Markdown + canvas：记录保留在 repo 中的 Markdown，视觉层是可提交、可分享的 self-contained HTML canvas。
6. Agent Skill 包装：作为 Claude Code / Codex / SKILL.md-compatible skill 使用，让 agent 承担归档、链接、聚类和渲染 errands。

一阶原理是：复杂设计不是一次性答案，而是 evidence、human judgment 和 output artifact 的可追溯组合。agent 应该减轻整理和链接负担，而不是隐藏决策来源。

与现有 wiki 概念的关系

• 对 LLM-Wiki：design-harness 更像项目级“决策板”，llm-wiki 更像长期知识库；二者可以互补。
• 对 Context-Engineering：它把 context 从隐式长 prompt 转成源卡、想法卡和输出卡，降低 context rot。
• 对 Harness-Engineering：它定义了设计工作流的 artifact contract、append-only logs、human gate 和 shareable evidence。
• 对 External-Agent-Skills-Design-Patterns：它是 multi-artifact skill pack：Markdown workspace、scripts、canvas、skill commands 共同构成工作流。

对 Hermes / llm-wiki 的可执行启发

1. 复杂 synthesis 可新增 evidence board 模板：当问题涉及 5+ 来源、多个设计选择和冲突时，不应只写一篇 query；可以维护 sources / ideas / output 的轻量目录。
2. 用户判断和 agent 综合分离：llm-wiki 页面应标清哪些是来源事实，哪些是 Hermes synthesis，哪些需要用户裁决。
3. 自我优化文章可更像 design record：不仅总结“今天做了什么”，还记录哪些来源触发了哪些 wiki 结构改进建议。
4. 暂不直接安装：design-harness 会引入新目录/画布生成流程，属于 vault 结构改动；今天只入库模式，后续若用户做产品/系统设计项目再单独启用。

失败模式与边界

• 工作流重量：对单篇文章 ingest 过重；适合多来源、多决策、需要给他人解释 why 的项目。
• visual canvas 可能变成表演层：如果 source/idea card 不严谨，漂亮 canvas 只是包装。
• human-owned ideas 要求用户参与：无人 cron 不能替用户创建真正的价值判断；只能提出候选 idea / open question。
• 目录结构需治理：如果和 llm-wiki vault 混放，需避免 phantom .md 污染 vector index 或统计。

深度判断

晋升理由：它提供了 durable workflow 和可迁移设计模式，能改进 llm-wiki 对复杂综合/设计决策的处理。今天不晋升为概念页或安装项，因为需要用户确认是否要在 vault 中增加 board/workspace 结构。

写入记录

• 2026-07-27 09:07 CST：新增 source 页面，沉淀 design-harness 的 sources/ideas/output 分层、证据画布和 human-owned idea 对 llm-wiki 综合流程的启发。