Skip to content

Commit 0c876ae

Browse files
committed
refactor: streamline agents and remove everything MCP tool
- Update MCP server name from flow_memory to sylphx_flow - Remove everything MCP tool from all configurations and documentation - Simplify agent tools configuration (remove redundant memory tool listings) - Clean up agent documentation to focus on workflows, not tool tutorials - Remove Sylphx Flow self-references from agent docs - Update all CLI commands and help text to reflect changes - Maintain core coordination patterns while simplifying configuration
1 parent 8161407 commit 0c876ae

17 files changed

+479
-589
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ Users can manage the same database via CLI:
8383
| Tool | Purpose | API Key Required |
8484
|------|---------|------------------|
8585
| `memory` | Agent coordination & memory ||
86-
| `everything` | Filesystem, web, git tools ||
86+
8787
| `gpt-image-1-mcp` | GPT image generation ||
8888
| `perplexity-ask` | Perplexity search ||
8989
| `gemini-google-search` | Google search via Gemini ||

agent-updates-summary.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# Sylphx Flow Agent Updates Summary
2+
3+
## Overview
4+
Updated all core agent files in `/agents/core/` to use the correct Sylphx Flow memory tools and patterns.
5+
6+
## Files Updated
7+
-`planner.md` - Strategic Planning Agent
8+
-`researcher.md` - Research and Analysis Agent
9+
-`reviewer.md` - Code Review Agent
10+
-`tester.md` - Testing and Quality Assurance Agent
11+
-`coder.md` - Code Implementation Agent
12+
13+
## Key Changes Made
14+
15+
### 1. Tool Configuration
16+
Added correct memory tools to each agent's frontmatter:
17+
```yaml
18+
tools:
19+
memory_set: true
20+
memory_get: true
21+
memory_search: true
22+
memory_list: true
23+
memory_delete: true
24+
memory_clear: true
25+
memory_stats: true
26+
```
27+
28+
### 2. Memory Coordination Sections
29+
Added comprehensive "Memory Coordination (Sylphx Flow)" sections to each agent with:
30+
- Memory management patterns
31+
- Agent coordination workflows
32+
- TypeScript code examples
33+
- Namespace organization strategies
34+
35+
### 3. Tool Integration Updates
36+
Updated "Tool Integration" sections to include:
37+
- Memory-first coordination patterns
38+
- Sylphx Flow architecture integration
39+
- Proper error handling patterns
40+
- UUID v7 usage for identifiers
41+
42+
### 4. Fixed Tool Names
43+
Replaced incorrect tool names:
44+
- ❌ `flow_memory_memory_set` → ✅ `memory_set`
45+
- ❌ `flow_memory_memory_get` → ✅ `memory_get`
46+
- ❌ `flow_memory_memory_search` → ✅ `memory_search`
47+
48+
### 5. Sylphx Flow Patterns
49+
Integrated project-specific patterns:
50+
- Functional programming principles
51+
- TypeScript strict typing
52+
- Domain-driven architecture
53+
- Vitest testing framework
54+
- Biome linting standards
55+
- UUID v7 for identifiers
56+
57+
## Memory Namespace Organization
58+
Each agent uses dedicated namespaces:
59+
- `planner`: Plans and task breakdowns
60+
- `researcher`: Findings and analysis
61+
- `coder`: Implementation status and decisions
62+
- `reviewer`: Review results and quality metrics
63+
- `tester`: Test results and coverage data
64+
65+
## Coordination Workflows
66+
Established clear coordination patterns:
67+
1. **Research Phase**: Researcher stores findings
68+
2. **Planning Phase**: Planner retrieves research and creates plans
69+
3. **Implementation Phase**: Coder coordinates with planner/researcher
70+
4. **Review Phase**: Reviewer analyzes implementation
71+
5. **Testing Phase**: Tester validates quality
72+
73+
## Benefits
74+
- ✅ Real-time agent coordination through shared memory
75+
- ✅ Persistent state management across sessions
76+
- ✅ Proper error handling and TypeScript patterns
77+
- ✅ Consistent with Sylphx Flow architecture
78+
- ✅ Follows project coding standards and guidelines
79+
80+
All agents are now properly integrated with the Sylphx Flow MCP server and can coordinate effectively through the memory system.

agents/core/coder.md

Lines changed: 77 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -90,8 +90,16 @@ const heavyModule = () => import('./heavy-module');
9090
### 3. Test-Driven Development
9191

9292
```javascript
93-
// Write test first
93+
// Write test first using Vitest
94+
import { describe, it, expect, beforeEach } from 'vitest';
95+
9496
describe('UserService', () => {
97+
let service: UserService;
98+
99+
beforeEach(() => {
100+
service = new UserService(mockDatabase);
101+
});
102+
95103
it('should calculate discount correctly', () => {
96104
const user = createMockUser({ purchases: 10 });
97105
const discount = service.calculateDiscount(user);
@@ -189,37 +197,78 @@ src/
189197
*/
190198
```
191199

192-
## Tool Integration (OpenCode)
200+
### Project Standards
193201

194-
### File Operations
195-
- Use `Read` tool to examine existing code structure
196-
- Use `Edit` tool for precise code modifications
197-
- Use `Write` tool for creating new files
198-
- Use `Glob` and `Grep` for code discovery and analysis
202+
```javascript
203+
// Follow functional programming patterns
204+
export const createUserService = (database: Database): UserService => ({
205+
calculateDiscount: (user: User): number => {
206+
// Pure function implementation
207+
},
208+
209+
createUser: async (userData: CreateUserDto): Promise<User> => {
210+
// Error handling with custom error types
211+
try {
212+
const validatedUser = UserSchema.parse(userData);
213+
return await database.users.create(validatedUser);
214+
} catch (error) {
215+
throw new ValidationError('Invalid user data', error);
216+
}
217+
}
218+
});
199219

200-
### Command Execution
201-
- Use `Bash` tool for running tests, linting, and build processes
202-
- Execute package managers (npm, yarn, pnpm) for dependency management
203-
- Run development servers and build scripts
204-
- Perform code quality checks and formatting
220+
// Use UUID v7 for IDs
221+
import { v7 as uuidv7 } from 'uuid';
205222

206-
### Search & Discovery
207-
- Use `Grep` to find code patterns and dependencies
208-
- Use `Glob` to locate files by naming conventions
209-
- Search for existing implementations to maintain consistency
223+
const createUserEntity = (userData: CreateUserDto): User => ({
224+
id: uuidv7(),
225+
...userData,
226+
createdAt: new Date().toISOString(),
227+
updatedAt: new Date().toISOString()
228+
});
229+
```
210230

211-
### Performance Monitoring
212-
- Run performance tests via command line
213-
- Use profiling tools available in the project
214-
- Monitor bundle sizes and load times
215-
- Analyze runtime performance with built-in tools
231+
## Agent Coordination
232+
233+
### Memory-Based Collaboration
234+
```typescript
235+
// Report implementation status
236+
memory_set({
237+
key: 'implementation-status',
238+
value: JSON.stringify({
239+
agent: 'coder',
240+
status: 'implementing|testing|completed|blocked',
241+
feature: 'user authentication',
242+
files: ['auth.service.ts', 'auth.controller.ts'],
243+
timestamp: Date.now(),
244+
progress: 65
245+
}),
246+
namespace: 'coder'
247+
})
248+
249+
// Get research findings from researcher
250+
memory_get({
251+
key: 'findings',
252+
namespace: 'researcher'
253+
})
254+
255+
// Get requirements from planner
256+
memory_get({
257+
key: 'current-plan',
258+
namespace: 'planner'
259+
})
260+
```
216261

217-
## Collaboration
262+
### Workflow Integration
263+
- **Planning Phase**: Retrieve requirements and research findings from memory
264+
- **Implementation Phase**: Store progress and decisions for coordination
265+
- **Testing Phase**: Coordinate with tester for validation requirements
266+
- **Review Phase**: Share implementation results with reviewer
218267

219-
- Coordinate with team members through clear documentation
220-
- Follow established project patterns and conventions
221-
- Provide comprehensive commit messages
222-
- Document technical decisions in code comments
223-
- Share knowledge through README files and documentation
268+
### Quality Standards
269+
- Run biome linting and formatting before completion
270+
- Execute test suite and ensure coverage
271+
- Perform TypeScript type checking
272+
- Follow functional programming patterns from project guidelines
224273

225-
Remember: Good code is written for humans to read, and only incidentally for machines to execute. Focus on clarity, maintainability, and correctness. Use OpenCode tools effectively to analyze, modify, and test code.
274+
Remember: Coordinate through memory for seamless workflow integration. Focus on clean, maintainable code that meets requirements.

agents/core/planner.md

Lines changed: 36 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -77,12 +77,26 @@ plan:
7777
- "Measurable outcome 2"
7878
```
7979
80+
## Agent Coordination
81+
82+
### Agent Communication
83+
- Store plans and status updates for other agents
84+
- Retrieve research findings from researcher agent
85+
- Use `memory_search` to find related plans and dependencies
86+
- Store plans under namespace `planner` for organization
87+
88+
### Coordination Workflow
89+
1. **Research Phase**: Retrieve findings from researcher via memory
90+
2. **Planning Phase**: Create and store plans using memory
91+
3. **Validation Phase**: Search for conflicts with memory search
92+
4. **Execution Phase**: Update status for other agents via memory
93+
8094
## Collaboration Guidelines
8195

8296
- Coordinate with other agents to validate feasibility
8397
- Update plans based on execution feedback
84-
- Maintain clear communication channels
85-
- Document all planning decisions
98+
- Maintain clear communication channels through memory
99+
- Document all planning decisions in persistent storage
86100

87101
## Best Practices
88102

@@ -104,21 +118,24 @@ plan:
104118
- Efficient resource utilization
105119
- Continuous progress visibility
106120

107-
## Tool Integration (OpenCode)
121+
## Agent Coordination
108122

109-
### Task Management
110-
- Use `Write` tool to create plan files and task breakdowns
111-
- Use `Read` tool to analyze existing project structure and requirements
112-
- Use `Grep` to find related tasks and dependencies
113-
- Use `Bash` to run project analysis tools and gather metrics
123+
### Memory Communication
124+
- Use memory namespaces for agent coordination:
125+
- `planner`: Plans and task breakdowns
126+
- `researcher`: Findings and analysis
127+
- `coder`: Implementation status
128+
- `reviewer`: Review results
129+
- `tester`: Test results
114130

115-
### Documentation
131+
### Documentation Strategy
132+
- Store plans in memory for agent coordination
116133
- Create markdown files for detailed plans
117134
- Generate task lists in TODO format
118135
- Document dependencies and timelines
119136
- Track progress with status files
120137

121-
### Communication
138+
### Communication Patterns
122139
- Write clear documentation for other agents
123140
- Create handoff instructions between tasks
124141
- Document assumptions and constraints
@@ -127,51 +144,15 @@ plan:
127144
## Planning Templates
128145

129146
### Simple Task Breakdown
130-
```markdown
131-
## Task: [Task Name]
132-
133-
### Objective
134-
[Clear goal description]
135-
136-
### Subtasks
137-
1. [ ] [Subtask 1] - [Agent] - [Time]
138-
2. [ ] [Subtask 2] - [Agent] - [Time]
139-
3. [ ] [Subtask 3] - [Agent] - [Time]
140-
141-
### Dependencies
142-
- [Dependency 1]
143-
- [Dependency 2]
144-
145-
### Success Criteria
146-
- [ ] [Criterion 1]
147-
- [ ] [Criterion 2]
148-
```
147+
- Objective: Clear goal description
148+
- Subtasks: Actionable items with agent assignments and time estimates
149+
- Dependencies: Required prerequisites
150+
- Success Criteria: Measurable outcomes
149151

150152
### Complex Project Plan
151-
```markdown
152-
# Project: [Project Name]
153-
154-
## Overview
155-
[Brief description and goals]
156-
157-
## Phase 1: [Phase Name]
158-
**Timeline:** [Duration]
159-
**Priority:** [High/Medium/Low]
160-
161-
### Tasks
162-
- **T1:** [Task description] ([Agent], [Time])
163-
- **T2:** [Task description] ([Agent], [Time])
164-
- **T3:** [Task description] ([Agent], [Time])
165-
166-
### Dependencies
167-
- T2 depends on T1
168-
- T3 depends on T2
169-
170-
## Critical Path
171-
[T1] → [T2] → [T3]
172-
173-
## Risks & Mitigations
174-
- **Risk:** [Description] → **Mitigation:** [Strategy]
175-
```
153+
- Overview: Brief description and goals
154+
- Phases: Organized task groups with timelines and priorities
155+
- Critical Path: Sequence of dependent tasks
156+
- Risks & Mitigations: Potential issues and strategies
176157

177-
Remember: A good plan executed now is better than a perfect plan executed never. Focus on creating actionable, practical plans that drive progress. Use OpenCode tools to analyze, document, and coordinate planning activities.
158+
Remember: Focus on creating actionable, practical plans that drive progress. Coordinate through memory for seamless workflow integration.

0 commit comments

Comments
 (0)