Sync: add agent design notes

wiki/concepts/Agent-Design-Principles.md

@@ -0,0 +1,50 @@
+---
+title: "Agent Design Principles"
+type: concept
+tags: [multi-agent, agent-design, the-agency]
+sources: [contributing_zh-cn, contributing-to-the-agency]
+last_updated: 2026-04-24
+---
+
+# Agent Design Principles
+
+The five core design principles for building high-quality AI agents in The Agency framework.
+
+## Five Principles
+
+### 1. 🎭 Distinct Personality
+- Give each agent a unique tone and persona
+- Avoid generic "I am a helpful assistant" — be specific and memorable
+- Example: "I will find 3-5 problems by default and ask for visual evidence" (Evidence Collector)
+
+### 2. 📋 Clear Deliverables
+- Provide actionable code examples
+- Include templates and frameworks
+- Show real output, not vague descriptions
+
+### 3. ✅ Success Metrics
+- Include specific, quantifiable metrics
+- Example: "Page load time under 3 seconds on 3G network"
+- Example: "10,000+ combined karma points across accounts"
+
+### 4. 🔄 Verified Workflows
+- Step-by-step processes that are clear
+- Validated in real-world scenarios
+- Reject pure theory without testing
+
+### 5. 💡 Learning & Memory
+- Agents identify which patterns to recognize
+- How they iterate and optimize over time
+- What they remember between sessions
+
+## Anti-Patterns (Avoid)
+- ❌ Generic "helpful assistant" persona
+- ❌ Vague "I will help you..." descriptions
+- ❌ No code examples or deliverables
+- ❌ Too broad scope (jack of all trades)
+- ❌ Untested theoretical solutions
+
+## Connections
+- Extends [[Multi-Agent-System-Reliability]] — design-time quality standards complement runtime reliability patterns
+- Used by [[Multi-Agent-Team]] — standardized agent creation framework
+- Related to [[Agent-Template]] — the structural template implementing these principles

wiki/concepts/Agent-Template.md

@@ -0,0 +1,77 @@
+---
+title: "Agent Template"
+type: concept
+tags: [multi-agent, agent-design, the-agency]
+sources: [contributing_zh-cn, contributing-to-the-agency]
+last_updated: 2026-04-24
+---
+
+# Agent Template
+
+The standardized YAML frontmatter + structured document template for creating The Agency agents.
+
+## YAML Frontmatter
+
+```yaml
+---
+name: Agent Name
+description: One-sentence description of agent's specialty and positioning
+color: Color Name or "#hex-value"
+---
+```
+
+## Document Structure
+
+### 🧠 Identity & Memory
+- **Role**: Clear role description
+- **Personality**: Personality traits and communication style
+- **Memory**: What the agent needs to remember and learn
+- **Experience**: Domain expertise and perspective
+
+### 🎯 Core Mission
+- Core Responsibility 1 (with clear deliverables)
+- Core Responsibility 2 (with clear deliverables)
+- Core Responsibility 3 (with clear deliverables)
+- **Default Requirement**: Always follow best practices
+
+### 🚨 Critical Rules
+Domain-specific rules and constraints that define how the agent operates.
+
+### 📋 Technical Deliverables
+Concrete outputs the agent produces:
+- Code examples
+- Templates
+- Frameworks
+- Documentation
+
+### 🔄 Workflow
+Step-by-step process the agent follows:
+1. Phase 1: Exploration & Research
+2. Phase 2: Planning & Strategy
+3. Phase 3: Execution & Implementation
+4. Phase 4: Review & Optimization
+
+### 💭 Communication Style
+- How the agent communicates
+- Example phrases and expression patterns
+- Tone and style
+
+### 🔄 Learning & Memory
+What the agent continuously learns from:
+- Success patterns
+- Failure cases
+- User feedback
+- Domain evolution
+
+### 🎯 Success Metrics
+Quantifiable outcomes:
+- Quantitative metrics (with specific values)
+- Qualitative metrics
+- Performance benchmarks
+
+### 🚀 Advanced Capabilities
+Advanced techniques and methods the agent masters.
+
+## Connections
+- Implements [[Agent-Design-Principles]] — structural template for the five design principles
+- Used in [[Multi-Agent-Team]] — standardized agent creation