
Security News
Deno Goes the Way of the Dinosaur
Cloudflare is acquiring Deno’s team, which will provide another year of bug fixes and security updates before ending support for the runtime.
@macheng11/flowmind
Advanced tools
The AI Agent That Learns How You Work - Stop repeating yourself, FlowMind learns your workflows and applies them automatically.
Stop repeating yourself. FlowMind learns your workflows and applies them automatically.
中文 | Quick Start | How It Works | Use Cases | Architecture
Whether you're a developer, architect, product manager, or tech lead, you face these challenges:
❌ Same instructions every single time:
"Format output as table..."
"Use sequential list..."
"Check errors first then..."
"Connect using source_id..."
❌ Constantly switching between platforms:
SLS for logs → RDS for data → Code repo → YApi for APIs → Yuque for docs
❌ Valuable experience cannot be preserved:
Architect's design thinking → Lost with project end
Debugging paths → Have to摸索 again next time
Best practices → Cannot be reused or传承
❌ Repetitive waiting and inefficient operations:
Configure database connection every time
Enter complete conditions for every log query
Manually execute multiple steps for each deployment
FlowMind learns once, applies forever.
✅ First time: You teach FlowMind
✅ Every time after: FlowMind remembers
✅ Smarter with use: AI self-evolution
Code Locate → Data Verify → Problem Analyze → One-Click Fix → Auto Deploy → Archive
↓ ↓ ↓ ↓ ↓ ↓
Local+MCP RDS Read SLS Analysis Code Modify Pipeline OpenSpec+Yuque
npm install -g flowmind
flowmind init
One-time configuration, permanent effect. Configure resource connections, learning preferences, output formats - no need to repeat setup.
# First time - teach FlowMind your preference
flowmind "查询 traceId 日志,用顺序列表格式"
FlowMind: [Executes and learns your preference]
# Next time - FlowMind remembers!
flowmind "查询 traceId abc123 的日志"
FlowMind: [Automatically uses sequential list format] ✓
graph LR
A[Your Request] --> B{Code Location}
B -->|Local| C[Local Codebase]
B -->|MCP| D[Remote Repository]
B -->|SSH| E[Server Code]
C --> F[Smart Matching]
D --> F
E --> F
F --> G[Precise Location]
Supported Modes:
graph TD
A[Historical Data Collection] --> B[Knowledge Base Building]
B --> C[Intelligent Retrieval Matching]
C --> D[Context Generation]
D --> E[Auto Application]
E --> F[Continuous Optimization]
F --> A
RAG Process:
graph LR
A[Your Request] --> B[FlowMind Executes]
B --> C{You Correct?}
C -->|Yes| D[Record Learning]
C -->|No| E[Continue]
D --> F[Apply Next Time]
F --> G[Self Evolution]
Learning Types:
FlowMind uses a pluggable component architecture that supports switching between cloud providers (Alibaba Cloud, Baidu Cloud, ELK, etc.) through configuration, without modifying skill code.
graph TB
A[FlowMind Core] --> R[ComponentRegistry]
R --> LS[logService]
R --> DB[databaseManager]
R --> DQ[databaseQuery]
R --> RD[redisMonitor]
R --> AP[apiDoc]
R --> KB[knowledgeBase]
R --> WF[workflow]
R --> RP[report]
LS --> LS1[Alibaba Cloud SLS]
LS --> LS2[Baidu Cloud Log]
LS --> LS3[ELK]
DB --> DB1[Alibaba Cloud DMS]
KB --> KB1[Yuque]
KB --> KB2[Notion]
AP --> AP1[YApi]
8 Component Types:
| Component Type | Default Provider | Description |
|---|---|---|
logService | aliyun-sls | Cloud log querying and analysis |
databaseManager | aliyun-dms | Database instance management |
databaseQuery | aliyun-rds-query | Direct database SQL queries |
redisMonitor | aliyun-redis | Redis monitoring via Prometheus |
apiDoc | yapi | API documentation management |
knowledgeBase | yuque | Knowledge base and documents |
workflow | friday-flow | Automated workflow and pipelines |
report | friday-report | Test and coverage reporting |
Switching providers is config-only:
{
"components": {
"logService": {
"default": "baidu-sls",
"providers": {
"baidu-sls": { "adapter": "baidu-sls-adapter", "enabled": true }
}
}
}
}
# Traditional way (10+ steps):
1. Login to SLS console
2. Enter query conditions
3. Find traceId
4. Copy traceId
5. Search traces
6. Locate error
7. Connect RDS
8. Query data
9. Analyze cause
10. Modify code
11. Submit deployment
12. Write documentation
# FlowMind way (1 command):
flowmind "排查线上问题 traceId abc123"
# → Auto complete: SLS query → Trace tracking → RDS data validation → Code location → Fix suggestion
# Set your standards (only once)
flowmind "代码审查先检查安全漏洞,再检查代码质量,最后检查性能"
# Every review follows your standards
flowmind "审查这个 PR"
# → Security first → Quality check → Performance analysis
# Generate docs from code
flowmind "从代码注释生成 API 文档"
# Sync to YApi
flowmind "同步接口到 YApi"
# Auto update Yuque
flowmind "同步 API 文档到语雀"
# Connect RDS to validate data
flowmind "验证订单表数据完整性"
# Auto execute checks
# → Referential integrity → Data types → Business logic → State machine
# Full review
flowmind "审查项目整体状况"
# Auto execute:
# → Dependency analysis → Security audit → Code complexity → Test coverage → Technical debt
# New to a project? FlowMind helps you understand fast
flowmind "帮我理解这个项目的整体架构"
# FlowMind learns from senior devs' patterns:
# → Project structure analysis → Core module explanation → Data flow mapping
# → Key design decisions → Development guidelines → Suggested learning path
# Facing a design choice? FlowMind draws from accumulated experience
flowmind "这个功能应该用 Redis 还是 MongoDB?"
# FlowMind applies learned design thinking:
# → Your project context → Current tech stack → Performance requirements
# → Historical similar decisions → Trade-off analysis → Data-driven recommendation
# List all available skills
flowmind skills
flowmind skills --verbose # Show detailed info
flowmind skills --json # JSON output (for tool integration)
flowmind skills --category quality # Filter by category
# View single skill info
flowmind skill log-audit
flowmind skill log-audit --json # JSON output
flowmind skill log-audit --read # Read SKILL.md content
flowmind skill log-audit --config # Show configuration
# Modify skill configuration
flowmind skill log-audit --set defaultFormat sequential-list
flowmind skill code-review --set security.enabled true
# List resource files
flowmind resource --list
flowmind resource --list learning
flowmind resource --list --json # JSON output
# View/edit files
flowmind resource --show config.json
flowmind resource --edit config.json
# Show resource configuration
flowmind resource --config
flowmind resource --config --json
# Process request
flowmind process "your request"
flowmind process --skill log-audit "query logs"
# Manage learning
flowmind learn --list
flowmind learn --export learnings.json
# Scene management
flowmind scenes --list
flowmind scenes --add
# Show statistics
flowmind stats
# Configuration
flowmind config --list
flowmind config --set learning.enabled true
All commands support --json flag for programmatic access:
# Get skills list as JSON
flowmind skills --json
# Get skill info as JSON
flowmind skill log-audit --json
# Get resource list as JSON
flowmind resource --list --json
┌──────────────────────────────────────────────────────────────────┐
│ FlowMind Agent │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Scene Matcher│ │Learning Engine│ │ Skill Loader │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ ComponentRegistry (Pluggable) │ │
│ ├──────────┬──────────┬──────────┬──────────┬──────────────┤ │
│ │logService│database │apiDoc │knowledge │workflow/report│ │
│ │Adapter │Manager │Adapter │Base │Adapters │ │
│ └──────────┴──────────┴──────────┴──────────┴──────────────┘ │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Skill System │ │
│ ├─────────────┬─────────────┬─────────────┬────────────────┤ │
│ │ Analysis │ Integration │ Quality │ Automation │ │
│ └─────────────┴─────────────┴─────────────┴────────────────┘ │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Cloud Provider Adapters │ │
│ ├──────────┬──────────┬──────────┬──────────┬──────────────┤ │
│ │Aliyun SLS│Aliyun DMS│ YApi │ Yuque │Friday Flow │ │
│ │Baidu Log │Baidu DMS │ Swagger │ Notion │Friday Report │ │
│ │ELK │Custom DB │ │Confluence│ │ │
│ └──────────┴──────────┴──────────┴──────────┴──────────────┘ │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Data Persistence Layer │ │
│ ├─────────────┬─────────────┬───────────────────────────────┤ │
│ │Learning │Scene │Component Config │ │
│ │Records │Mappings │& Settings │ │
│ └─────────────┴─────────────┴───────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────┘
flowmind/
├── core/ # Core Engine
│ ├── index.js # Main entry
│ ├── learning-engine.js # Learning engine
│ ├── scene-matcher.js # Scene matching
│ ├── skill-loader.js # Skill loading
│ ├── config-manager.js # Config management
│ ├── component-types.js # Component type definitions
│ ├── component-registry.js # Pluggable component registry
│ ├── mcp-compatibility.js # MCP backward compatibility
│ ├── adapters/ # Adapter interfaces
│ │ ├── base-adapter.js # Abstract base adapter
│ │ ├── mcp-adapter.js # MCP adapter base
│ │ ├── log-service-adapter.js
│ │ ├── database-manager-adapter.js
│ │ ├── database-query-adapter.js
│ │ ├── knowledge-base-adapter.js
│ │ ├── api-doc-adapter.js
│ │ ├── workflow-adapter.js
│ │ └── report-adapter.js
│ └── providers/ # Provider implementations
│ ├── aliyun/ # Alibaba Cloud adapters
│ │ ├── sls-adapter.js
│ │ ├── dms-adapter.js
│ │ └── redis-adapter.js
│ ├── yapi/ # YApi adapter
│ │ └── yapi-adapter.js
│ ├── yuque/ # Yuque adapter
│ │ └── yuque-adapter.js
│ └── friday/ # Friday platform adapters
│ ├── flow-adapter.js
│ └── report-adapter.js
├── scripts/ # Migration tools
│ └── migrate-config.js # Config migration tool
├── skills/ # Skill Modules (17 core skills)
│ ├── log-audit/ # Log audit
│ ├── sls-log-audit/ # SLS log audit (chain tracing)
│ ├── resource-bind/ # Resource binding
│ ├── code-review/ # Code review
│ ├── code-review-audit/ # Code review audit (3D review)
│ ├── data-validation/ # Data validation
│ ├── data-logic-validation/ # Data logic validation
│ ├── api-sync/ # API sync
│ ├── yapi-sync-interface/ # YApi interface sync
│ ├── yuque-sync-design/ # Yuque design doc sync
│ ├── project-review/ # Project review
│ ├── git-review/ # Git review
│ ├── archive-change/ # Change archiving
│ ├── auto-flow/ # Workflow automation
│ ├── learning-engine/ # Learning engine
│ ├── learning-feedback/ # Learning feedback (global)
│ └── requirement-analyst/ # Requirement analyst (6D analysis)
├── learning/ # Learning Storage
│ ├── records/ # Learning records
│ └── scenes.json # Scene mappings
├── templates/ # Output templates
└── config/ # Configuration files
sequenceDiagram
participant U as User
participant A as FlowMind Agent
participant M as Scene Matcher
participant L as Learning Engine
participant S as Skill System
participant MCP as MCP Integration
participant D as Data Persistence
U->>A: Send request
A->>M: Check scene mappings
M->>D: Read history records
D-->>M: Return matching workflows
M-->>A: Return recommended plan
A->>S: Execute skills
S->>MCP: Call external services
MCP-->>S: Return results
S-->>A: Return execution results
A->>U: Present results
U->>A: Provide feedback
A->>L: Record learning
L->>D: Persist storage
L->>L: Optimize matching algorithm
graph TB
A[Problem Discovery] --> B[Code Location]
B --> C[Data Validation]
C --> D[Problem Analysis]
D --> E[One-Click Fix]
E --> F[Auto Deploy]
F --> G[Archive Record]
B --> B1[Local Code]
B --> B2[MCP Remote]
B --> B3[SSH Mode]
C --> C1[RDS Data Read]
C --> C2[Data Integrity Validation]
D --> D1[SLS Log Analysis]
D --> D2[TraceID Tracing]
D --> D3[Root Cause Location]
E --> E1[Code Modification]
E --> E2[Unit Tests]
F --> F1[Pipeline Execution]
F --> F2[Auto Deployment]
G --> G1[OpenSpec Archive]
G --> G2[Yuque Doc Sync]
G --> G3[RAG Data Building]
FlowMind is built on enterprise-grade architecture design standards, incorporating extensive experience from architects and senior developers:
| Skill | Description |
|---|---|
| 🔍 log-audit | Log Audit - Time filtering, service filtering, level filtering, keyword search, TraceID tracing, performance analysis |
| 🔗 sls-log-audit | SLS Log Audit - Alibaba Cloud SLS log query, TraceID chain analysis, Feign call chain extraction, response time analysis |
| 🔎 project-review | Project Review - Dependency analysis, security audit, license compliance, code complexity, test coverage, technical debt assessment |
| 📋 git-review | Git Review - Commit quality analysis, change size assessment, impact analysis, risk evaluation, dependency change detection |
| 📐 requirement-analyst | Requirement Analyst - Historical design principles, iteration rationale, extensibility, market roadmap, req-code deviation, upgrade vulnerabilities |
| Skill | Description |
|---|---|
| 🔗 resource-bind | Resource Bind - MySQL/PostgreSQL connection management, Redis operations, REST API integration, authentication management |
| 📚 api-sync | API Sync - Generate docs from code annotations, OpenAPI/Swagger spec generation, client SDK generation, version management |
| 📋 yapi-sync-interface | YApi Interface Sync - Sync Controller interfaces to YApi, Swagger import/export, interface management |
| 📖 yuque-sync-design | Yuque Design Sync - Sync OpenSpec design docs to Yuque, knowledge base management, document archiving |
| ✅ data-validation | Data Validation - Referential integrity checks, data type validation, business logic verification, state machine validation, duplicate detection |
| 🔬 data-logic-validation | Data Logic Validation - Verify actual SQL queries and Redis logic via MCP database/Redis connections |
| Skill | Description |
|---|---|
| 🔒 code-review | Code Review - SQL injection detection, XSS vulnerability scanning, authentication issues, code style, complexity analysis, design pattern checks |
| 🛡️ code-review-audit | Code Review Audit - Three-dimensional review: security audit, design compliance, mandatory constraint validation before merge/test |
| 📝 archive-change | Archive Change - Archive completed changes, auto-generate change summary, update changelog, create knowledge base entries, link Issue/PR |
| Skill | Description |
|---|---|
| 🔄 auto-flow | Auto Flow - Sequential execution, parallel execution, conditional branching, error handling, workflow templates, team sharing |
| Skill | Description |
|---|---|
| 🎯 learning-engine | Learning Engine - Correction learning, scene learning, preference learning, auto-application, learning loop, knowledge graph construction |
| 📝 learning-feedback | Learning Feedback (Global) - Capture user corrections, scene mapping, auto-bind to relevant skills, continuous optimization |
Standardized skill definitions → Unified interface specifications → Plug and play
Historical data collection → Intelligent retrieval matching → Context generation → Auto application
Learning records → Local storage → Permanent retention → Cross-session reuse
flowmind init → One-time configuration → Permanent effect
flowmind init to complete initializationUser correction → Record learning → Auto apply → Continuous optimization
Component Type → Provider Interface → Cloud Service Adapter → Switch via Config
Key Design Principles:
Component Lifecycle:
flowmind init → Load component-config.json → Register adapters → Activate default providers
↓
Skills call ComponentRegistry.getAdapter(type)
↓
Adapter delegates to MCP server or custom implementation
MCP Server to Component Mapping:
| MCP Server | Component Type | Provider |
|---|---|---|
friday-sls-logs | logService | aliyun-sls |
aliyun-dms-mcp-server | databaseManager | aliyun-dms |
friday-rds-redis-query | databaseQuery | aliyun-rds-query |
friday-aliyun-sz-rds-redis | redisMonitor | aliyun-redis |
yapi-mcp | apiDoc | yapi |
yuque-mcp | knowledgeBase | yuque |
friday-auto-flow | workflow | friday-flow |
friday-auto-report | report | friday-report |
Create your own adapter to integrate proprietary or third-party services.
Step 1: Extend the Base Adapter
// core/providers/custom/my-sls-adapter.js
const LogServiceAdapter = require('../../adapters/log-service-adapter');
class MyCustomSlsAdapter extends LogServiceAdapter {
constructor(config = {}) {
super('my-custom-sls', config);
// Register MCP tool name mappings
this.registerTool('queryLogs', 'myQueryLogsTool');
}
get mcpServer() {
return 'my-custom-mcp-server';
}
async queryLogs(params) {
// Custom implementation
return { mcpServer: this.mcpServer, tool: this.resolveTool('queryLogs'), params };
}
}
module.exports = MyCustomSlsAdapter;
Step 2: Register the Provider Factory
// In your initialization code
const registry = new ComponentRegistry(config);
registry.registerFactory('my-custom-sls', () => {
const MyCustomSlsAdapter = require('./providers/custom/my-sls-adapter');
return new MyCustomSlsAdapter(config.get('components.logService.providers.my-custom-sls'));
});
Step 3: Configure the Provider
{
"components": {
"logService": {
"default": "my-custom-sls",
"providers": {
"my-custom-sls": {
"adapter": "my-custom-sls-adapter",
"enabled": true,
"mcpServer": "my-custom-mcp-server",
"config": {
"endpoint": "my-sls.example.com"
}
}
}
}
}
}
Adapter Interface Requirements by Component Type:
| Component Type | Required Methods | Required Capabilities |
|---|---|---|
logService | queryLogs(), listProjects() | Log querying and project listing |
databaseManager | listInstances(), executeScript(), searchDatabase() | Instance management and SQL execution |
databaseQuery | queryExec(), fetchSource(), fetchTables() | Direct SQL queries |
redisMonitor | query(), queryRange(), getLabelValues() | Prometheus metric queries |
apiDoc | searchApis(), saveApi(), getCategories() | API doc CRUD |
knowledgeBase | getRepos(), getDocs(), createDoc(), updateDoc() | Knowledge base CRUD |
workflow | listPipelines(), startPipelineRun() | Pipeline management |
report | listBuilds(), getBuildInfo() | Build report retrieval |
Migrate existing MCP server configurations to the new component architecture.
# Preview migration (dry run)
node scripts/migrate-config.js --dry-run
# Generate migration config
node scripts/migrate-config.js
# Specify custom output path
node scripts/migrate-config.js --output ./my-config.json
What it does:
.claude/settings.local.jsoncomponent-config.json with proper structureMigration output example:
{
"version": "1.0.0",
"components": {
"logService": {
"default": "aliyun-sls",
"providers": {
"aliyun-sls": {
"adapter": "aliyun-sls-adapter",
"enabled": true,
"mcpServer": "friday-sls-logs"
}
}
}
}
}
| Metric | Before FlowMind | After FlowMind |
|---|---|---|
| Repetitive instructions | 100% | ~5% |
| Workflow consistency | Variable | 98%+ |
| Problem investigation time | 30+ min | 5 min |
| Onboarding new devs | 2 weeks | 2 days |
| Token consumption | High | Reduce 60%+ |
| Experience retention | Cannot preserve | Permanent reuse |
| Design decision quality | Trial and error | Experience-backed |
FlowMind's Core Philosophy: More Users, Smarter Together!
Everyone's work habits → Combined into intelligent knowledge base
Your every use → Makes FlowMind understand developers better
Your every correction → Helps everyone improve efficiency
Let's build smarter developer tools together!
We welcome contributions! See CONTRIBUTING.md for details.
MIT License - see LICENSE for details.
FlowMind becomes a valuable assistant for every role through continuous learning from team experience:
FlowMind doesn't replace anyone—it preserves and transmits team design wisdom, quality standards, and product experience across time and roles, enabling every role to make better decisions standing on the shoulders of those before them.
Built with:
FAQs
The AI Agent That Learns How You Work - Stop repeating yourself, FlowMind learns your workflows and applies them automatically.
The npm package @macheng11/flowmind receives a total of 0 weekly downloads. As such, @macheng11/flowmind popularity was classified as not popular.
We found that @macheng11/flowmind demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.

Security News
Cloudflare is acquiring Deno’s team, which will provide another year of bug fixes and security updates before ending support for the runtime.

Security News
Anthropic’s free OSS Scanner uses Mythos and other Claude models to find open source vulnerabilities and send maintainers reports with proposed fixes.

Security News
On Front Lines’ Early Adopters: CISO podcast, Andrew Becherer shares lessons from Datadog, weighs the long-term costs of AI-built tools, and explains how founders can actually gain a CISO’s trust.