Sync: add design ux architecture notes
This commit is contained in:
@@ -4,6 +4,7 @@
|
||||
- [Overview](overview.md) — living synthesis
|
||||
|
||||
## Sources
|
||||
- [2026-04-24] [ArchitectUX Agent Personality](sources/design-ux-architect.md)
|
||||
- [2026-04-24] [Contributing to The Agency](sources/contributing.md)
|
||||
- [2026-04-24] [为 The Agency 贡献代码](sources/contributing_zh-cn.md)
|
||||
- [2026-04-24] [CTP Topic 12 Using SES SMTP service terraform module](sources/ctp-topic-12-using-ses-smtp-service-terraform-module.md)
|
||||
@@ -413,7 +414,6 @@
|
||||
- [2026-04-20] [design-brand-guardian](sources/design-brand-guardian.md) — (expected: wiki/sources/design-brand-guardian.md — source missing)
|
||||
- [2026-04-20] [design-ux-researcher](sources/design-ux-researcher.md) — (expected: wiki/sources/design-ux-researcher.md — source missing)
|
||||
- [2026-04-20] [design-whimsy-injector](sources/design-whimsy-injector.md) — (expected: wiki/sources/design-whimsy-injector.md — source missing)
|
||||
- [2026-04-20] [design-ux-architect](sources/design-ux-architect.md) — (expected: wiki/sources/design-ux-architect.md — source missing)
|
||||
- [Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog](sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md) — (expected: wiki/sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md — source missing)
|
||||
- [Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend](sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md) — (expected: wiki/sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md — source missing)
|
||||
- [zk-steward](sources/zk-steward.md) — (expected: wiki/sources/zk-steward.md — source missing)
|
||||
|
||||
@@ -28,6 +28,15 @@
|
||||
- Notes: index.md 已替换占位符条目（日期 2026-04-14）；overview.md 已新增独立段落（Terraform 段落末尾，置于 RDS via Terraform 和 Topic 21 之间）；VPC-Endpoint/DKIM-Email-Authentication/SES-Sandbox-Mode 为新创建 Concept 页面；Secrets-Management 已存在，已建立 wikilink；无其他 Entity 需创建
|
||||
- Conflicts: 与 [[ctp-topic-36-sendgrid-as-an-email-service]] 在邮件服务选型上的差异——SendGrid 被选定为新标准云邮件服务，SES 则服务现有应用通过 SMTP 协议平滑迁移上云，两者互补而非互斥
|
||||
|
||||
## [2026-05-05] ingest | design-ux-architect
|
||||
- Source file: Agent/agency-agents/design/design-ux-architect.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: ArchitectUX 智能体角色定义——为 LuxuryDeveloper 提供坚实的技术架构和 UX 基础。核心交付物：CSS 设计系统（颜色/排版/间距令牌，light/dark/system 三模式）、响应式布局框架（Grid/Flexbox/mobile-first）、ThemeManager JS 类、信息架构规范。核心原则：Foundation-First 和消除开发者架构决策疲劳。所有新站点强制要求主题切换功能。
|
||||
- Concepts linked: none（CSS 设计系统/ThemeManager 等属单一来源概念，以 wikilink 形式记录于 Source page，不足建 Concept 页阈值）
|
||||
- Entities linked: [[ArchitectUX]], [[LuxuryDeveloper]], [[The Agency]]
|
||||
- Source page: wiki/sources/design-ux-architect.md
|
||||
- Notes: index.md 已替换占位符条目；overview.md 已新增独立段落（置于 multi-agent-system-reliability 之前）；无新 Entity/Concept 需创建（ArchitectUX/LuxuryDeveloper 仅出现 1 次，不足建 Entity 页阈值）；无实质内容冲突
|
||||
|
||||
## [2026-05-05] ingest | Learning Sessions Cloud Transformation Programme-20230808 183322-Meeting Recording
|
||||
- Source file: Cloud & DevOps/Public-Cloud-Learning-Sessions/03_Terraform/learning-sessions-cloud-transformation-programme-20230808-183322-meeting-recordi.md
|
||||
- Status: ✅ 成功摄入
|
||||
|
||||
@@ -31,6 +31,8 @@ The wiki covers two major multi-agent frameworks: **The Agency** (agency-agents)
|
||||
|
||||
**Recursive Self-Optimizing Generative Systems**（[[a-formalization-of-recursive-self-optimizing-generative-systems]]）：递归自我优化生成系统的形式化理论模型——将 [[养虾日记2]] 中 Self-Improving 的实践经验抽象为严格数学框架：系统目标不是直接产出最优输出，而是通过迭代自我修改构建稳定的生成能力 $G^*$。定义生成器空间 $\mathcal{G}$ → 优化算子 $O$ → 元生成算子 $M$ → 自映射 $\Phi$ → 稳定不动点 $G^*$，最终用 λ-calculus Y 组合子表达自引用结构 $G^* \equiv Y\;\text{STEP}$。核心发现：**递归自我优化自然涌现不动点结构**——当 $\Phi$ 满足收缩性条件时，$G^* = \lim_{n \to \infty} \Phi^n(G_0)$。该框架为 [[Self-Improving-Skill]] 和所有自我改进 AI 架构提供了原则性理论基础。
|
||||
|
||||
**[[design-ux-architect]]**（ArchitectUX）：The Agency 设计部门的 UX 架构专家智能体——在 LuxuryDeveloper 实施前为其提供坚实的技术基础，包括 CSS 设计系统（变量令牌/排版层级/间距体系）、响应式布局框架（Grid/Flexbox/mobile-first）和 ThemeManager 三模式切换（light/dark/system）。核心原则：**Foundation-First**——在动手实现前先建立可扩展 CSS 架构，消除开发者架构决策疲劳；**默认强制要求**——所有新站点必须包含主题切换功能。ArchitectUX 作为 [[The Agency]] 设计部门智能体之一，承接 [[ProjectManager]] 任务列表并添加技术基础层，为 [[LuxuryDeveloper]] 输出清晰的交接规范。与 [[design-ui-designer]]（视觉细节）和 [[design-ux-researcher]]（用户研究）协同，遵循 [[Multi-Agent-System-Reliability]] 的交接协议模式。
|
||||
|
||||
**[[multi-agent-system-reliability]]**（Alex Ewerlöf）：多智能体系统可靠性的架构模式理论——反对拟人化LLM，主张将LLM视为分布式系统中不可靠的组件。核心4模式：[[Hierarchy-Agent-Pattern]]（主管→工作→验证链）、[[Consensus-Voting-Pattern]]（N个LLM多数票消除幻觉）、[[Adversarial-Debate-Pattern]]（Generator→Critic→Judge对抗辩论）、[[Knock-out-Pattern]]（适者生存淘汰制）。核心洞察：不应要求模型"小心"，而应**强制**其正确——通过架构约束而非提示词约束。与 [[Designing for Agentic AI]] 互补（架构 vs 用户体验），与 [[Recursive Self-Optimization]] 共享自引用结构思想。与 [[Genetic-Algorithm]]（遗传算法）有关联——Knock-out/Tree of Thoughts 是 GA 的精简实现。
|
||||
|
||||
Key concepts: [[Recursive Self-Optimization]], [[Generator Space]], [[Self-Referential Computation]], [[Fixed-Point Semantics]], [[Y-Combinator]], [[Self-Improving AI]], [[Automated Prompt Engineering]], [[Email Triage]], [[Newsletter Digest]], [[Preference Learning]], [[Cron Job]], [[Multi-Agent Coordination]], [[Multi-Tool Integration]], [[MCP Tool Interface Design]], [[Workflow Architecture]], [[Shared Memory Architecture]], [[Private Context]], [[Single Control Plane]], [[Scheduled Task Flywheel]], [[Parallel Agent Execution]], [[Topic-Based Routing]], [[Voice Interface]], [[Telephony Integration]], [[Voice Notification Channel]], [[Two-Way Voice Conversation]], [[Call-Worthy Threshold]], [[PSTN Calling]], [[PM Delegation Pattern]], [[CEO Pattern]], [[Shared State Coordination]], [[Git-as-Audit-Log]], [[Dynamic-Dashboard]], [[Alerting]], [[Zero-Friction Capture]], [[Cumulative Memory]], [[Conversational Interface]], [[Text-and-Search]], [[Unified-Inbox]], [[Intent-Classification]], [[Human-Handoff]], [[Test-Mode]], [[Business-Knowledge-Base]], [[Language-Detection]], [[AI-Auto-Response]], [[Heartbeat-Monitoring]], [[Self-Improving-Skill]], [[双层记忆架构]], [[每日复盘机制]], [[Pattern-Key]], [[Recurrence-Count]], [[Self-Improvement-Log]], [[AI-Agent思维方式]], [[批次任务拆分]], [[精确去重]], [[小文件清理]], [[安全删除策略]], [[Telegram通知]], [[Context-Window]], [[Model-Fallback]], [[Compaction]], [[Agent-Routing-Rules]], [[Error-Surface-vs-Root-Cause]], [[Layered-Configuration]], [[Log-Driven-Debugging]], [[Hidden-Failure-Paths]], [[Large Language Model]], [[RAG]], [[AI Agent]], [[ReAct Pattern]], [[Hierarchy-Agent-Pattern]], [[Consensus-Voting-Pattern]], [[Adversarial-Debate-Pattern]], [[Knock-out-Pattern]], [[Tree-of-Thoughts]], [[Genetic-Algorithm]], [[Reliability-Engineering]]
|
||||
|
||||
51
wiki/sources/design-ux-architect.md
Normal file
51
wiki/sources/design-ux-architect.md
Normal file
@@ -0,0 +1,51 @@
|
||||
---
|
||||
title: "ArchitectUX Agent Personality"
|
||||
type: source
|
||||
tags: [agent, design, ux, css, frontend, the-agency]
|
||||
date: 2026-04-20
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/design/design-ux-architect.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：ArchitectUX 智能体的角色定义——为开发者提供坚实的技术架构和 UX 基础，消除架构决策疲劳
|
||||
- 问题域：Web 项目中 CSS 系统混乱、响应式策略缺失、主题切换缺失等开发者痛点
|
||||
- 方法/机制：通过 CSS 设计系统（变量/排版/间距/颜色令牌）、布局框架（Grid/Flexbox）、信息架构、ThemeManager JS 类实现
|
||||
- 结论/价值：ArchitectUX 作为 [[The Agency]] 设计部门的多智能体之一，负责在 LuxuryDeveloper 实施前建立可扩展的技术基础
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- **ArchitectUX** ← 创建 → **CSS 设计系统基础**：通过 CSS 变量令牌体系（颜色/排版/间距/容器）实现跨项目可维护的样式架构，消除硬编码值
|
||||
- **主题切换** ← 强制要求 → **所有新站点必须包含**：light/dark/system 三模式切换，preserves 用户偏好，支持 WCAG 合规
|
||||
- **架构优先** ← 预防 → **CSS 冲突**：在实施前先设计组件层级和命名规范，防止样式冲突和技术债务
|
||||
- **系统架构领导力** ← 负责 → **仓库拓扑/数据契约/API规范**：确保跨系统一致性和 Schema 合规
|
||||
- **开发者生产力** ← 通过 → **消除架构决策疲劳**：提供清晰可实施的规范，减少返工和重复决策
|
||||
|
||||
## Key Quotes
|
||||
> "Create scalable CSS architecture before implementation begins" — Foundation-First Approach 原则，要求在动手前先建立系统
|
||||
> "Eliminate architectural decision fatigue for developers" — Developer Productivity Focus 核心理念，ArchitectUX 存在的核心价值主张
|
||||
|
||||
## Key Concepts
|
||||
- **CSS 设计系统（CSS Design System）**：由 CSS 变量令牌（颜色/排版/间距/组件）构成的标准化样式体系，支持 light/dark/system 主题切换
|
||||
- **布局框架（Layout Framework）**：基于现代 CSS Grid/Flexbox 的容器系统和响应式断点策略（mobile-first）
|
||||
- **ThemeManager**：管理 light/dark/system 三种主题状态切换的 JavaScript 类，持久化用户偏好至 localStorage
|
||||
- **信息架构（Information Architecture）**：页面层级结构、导航策略、内容权重系统（H1 > H2 > H3）
|
||||
- **可访问性基础（Accessibility Foundation）**：WCAG 2.1 AA 合规标准，键盘导航、屏幕阅读器支持
|
||||
- **组件层级（Component Hierarchy）**：Layout Components → Content Components → Interactive Components → Utility Components 四层架构
|
||||
- **交接文档（Developer Handoff Documentation）**：包含优先级顺序、文件结构、实现笔记的完整交付模板
|
||||
|
||||
## Key Entities
|
||||
- **ArchitectUX**：Technical Architecture and UX Foundation Specialist Agent，紫色主题，📐 emoji，为 [[LuxuryDeveloper]] 提供可实施的技术基础
|
||||
- **LuxuryDeveloper**：The Agency 开发智能体，接收 ArchitectUX 的 CSS 系统和架构规范进行具体实现
|
||||
- **ProjectManager**：The Agency 项目管理智能体，提供任务列表，ArchitectUX 在其基础上添加技术基础层
|
||||
|
||||
## Connections
|
||||
- [[design-ui-designer]] ← extends ← [[design-ux-architect]]：UI 设计师在 ArchitectUX 建立的基础层上添加视觉设计细节
|
||||
- [[design-ux-researcher]] ← depends_on ← [[design-ux-architect]]：UX 研究员的原型和交互规范依赖 ArchitectUX 的技术框架实现
|
||||
- [[design-brand-guardian]] ← coordinates ← [[design-ux-architect]]：品牌规范约束 ArchitectUX 的 CSS 颜色令牌和排版系统
|
||||
- [[design-whimsy-injector]] ← adds_on ← [[design-ux-architect]]：趣味元素注入者在基础架构完成后添加动效和个性风格
|
||||
- [[The Agency]] ← contains ← [[design-ux-architect]]：ArchitectUX 是 The Agency 12 大部门之一 Design 部门的重要智能体
|
||||
- [[Multi-Agent-System-Reliability]] ← provides_pattern ← [[design-ux-architect]]：多智能体可靠性模式（如 Handoff Protocol）指导 ArchitectUX 的交接文档规范
|
||||
|
||||
## Contradictions
|
||||
- 与 [[design-ui-designer]] 在实现优先级上可能存在张力：ArchitectUX 主张"先基础后视觉"，UI 设计师可能倾向视觉优先。**当前观点**：基础优先，视觉细节在 CSS 系统稳定后添加，避免重构
|
||||
Reference in New Issue
Block a user