myaidev-method 0.2.2 โ 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/mcp/mcp-config.json +93 -10
- package/.claude/mcp/sparc-orchestrator-server.js +607 -0
- package/DEV_WORKFLOW_GUIDE.md +1353 -0
- package/MCP_INTEGRATION.md +373 -0
- package/README.md +378 -21
- package/bin/cli.js +39 -1
- package/dist/mcp/mcp-config.json +93 -10
- package/dist/mcp/sparc-orchestrator-server.js +607 -0
- package/package.json +22 -3
- package/src/lib/dev-workflow/agent-types.js +163 -0
- package/src/lib/dev-workflow/sparc-workflow.js +302 -0
- package/src/lib/dev-workflow/task-manager.js +313 -0
- package/src/scripts/dev-architect.js +99 -0
- package/src/scripts/dev-code.js +106 -0
- package/src/scripts/dev-docs.js +122 -0
- package/src/scripts/dev-review.js +117 -0
- package/src/scripts/dev-test.js +115 -0
- package/src/scripts/sparc-workflow.js +187 -0
- package/src/templates/claude/agents/dev-architect.md +436 -0
- package/src/templates/claude/agents/dev-coder.md +749 -0
- package/src/templates/claude/agents/dev-documenter.md +939 -0
- package/src/templates/claude/agents/dev-reviewer.md +1152 -0
- package/src/templates/claude/agents/dev-tester.md +600 -0
- package/src/templates/claude/commands/myai-dev-architect.md +80 -0
- package/src/templates/claude/commands/myai-dev-code.md +93 -0
- package/src/templates/claude/commands/myai-dev-docs.md +94 -0
- package/src/templates/claude/commands/myai-dev-review.md +96 -0
- package/src/templates/claude/commands/myai-dev-test.md +95 -0
- package/src/templates/claude/commands/myai-sparc-workflow.md +196 -0
package/README.md
CHANGED
|
@@ -1,22 +1,39 @@
|
|
|
1
1
|
# MyAIDev Method
|
|
2
2
|
|
|
3
|
-
> **๐
|
|
3
|
+
> **๐ A comprehensive development framework for AI-assisted software development with systematic workflows and multi-platform publishing!**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
The **MyAIDev Method** is a complete development framework for AI CLI tools (Claude Code, Gemini CLI, Codex CLI) featuring the **SPARC methodology** for systematic software development, inspired by [GitHub Spec-Kit](https://github.com/github/spec-kit) patterns for agentic software development.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
**๐ What makes this special:**
|
|
8
|
+
|
|
9
|
+
**Comprehensive Development Framework:**
|
|
10
|
+
- **SPARC Methodology**: 5-phase systematic development workflow (Specification โ Pseudocode โ Architecture โ Refinement โ Completion)
|
|
11
|
+
- **Development Agents**: Architect, Coder, Tester, Reviewer, Documenter - complete coverage from design to deployment
|
|
12
|
+
- **Quality-First**: Built-in security (OWASP Top 10), testing (80%+ coverage), and code review standards
|
|
13
|
+
- **Spec-Kit Inspired**: Proven patterns for agentic software development based on GitHub's Spec-Kit framework
|
|
14
|
+
|
|
15
|
+
**Multi-Platform Publishing & Deployment:**
|
|
16
|
+
- **CMS Publishing**: WordPress, PayloadCMS with full content management
|
|
17
|
+
- **Static Site Generators**: Docusaurus, Mintlify, Astro with git-based workflows
|
|
18
|
+
- **Deployment**: Coolify self-hosted PaaS orchestration
|
|
19
|
+
- **Infrastructure**: RamNode.com optimized deployment patterns
|
|
20
|
+
|
|
21
|
+
**Professional Tooling:**
|
|
8
22
|
- **Instant setup**: One `npx` command and you're ready
|
|
9
|
-
- **
|
|
10
|
-
- **
|
|
11
|
-
- **
|
|
23
|
+
- **Claude Code native**: Follows official standards for maximum compatibility
|
|
24
|
+
- **Zero dependencies**: Core features work standalone, optional MCP integrations available
|
|
25
|
+
- **Production-ready**: SOLID principles, Clean Code, comprehensive testing built-in
|
|
12
26
|
|
|
13
27
|
## ๐ Table of Contents
|
|
14
28
|
|
|
15
29
|
- [Features](#features)
|
|
16
30
|
- [Installation](#installation)
|
|
17
31
|
- [Quick Start](#quick-start)
|
|
18
|
-
- [
|
|
32
|
+
- [SPARC Development Workflow](#sparc-development-workflow)
|
|
33
|
+
- [Development Agents](#development-agents)
|
|
34
|
+
- [Content & Publishing Agents](#content--publishing-agents)
|
|
19
35
|
- [Slash Commands](#slash-commands)
|
|
36
|
+
- [MCP Server Integration](#mcp-server-integration)
|
|
20
37
|
- [Configuration](#configuration)
|
|
21
38
|
- [WordPress Integration](#wordpress-integration)
|
|
22
39
|
- [SSH Integration](#ssh-integration)
|
|
@@ -30,16 +47,35 @@ A comprehensive package for AI CLI tools (Claude Code, Gemini CLI, Codex CLI) th
|
|
|
30
47
|
|
|
31
48
|
## โจ Features
|
|
32
49
|
|
|
33
|
-
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
50
|
+
### ๐๏ธ Development Framework (SPARC Methodology)
|
|
51
|
+
- **Systematic Workflow**: 5-phase SPARC methodology (Specification โ Pseudocode โ Architecture โ Refinement โ Completion)
|
|
52
|
+
- **Development Agents**: Complete suite of specialized agents for the full development lifecycle
|
|
53
|
+
- ๐๏ธ **Architect**: System design, API specifications, data modeling, technology selection
|
|
54
|
+
- ๐ป **Coder**: Feature implementation, refactoring, SOLID principles, Clean Code
|
|
55
|
+
- ๐งช **Tester**: Unit/integration testing, 80%+ coverage, quality gates
|
|
56
|
+
- ๐๏ธ **Reviewer**: Code quality, security (OWASP Top 10), performance analysis
|
|
57
|
+
- ๐ **Documenter**: API docs, user guides, architecture documentation
|
|
58
|
+
- **Spec-Kit Patterns**: Proven agentic development patterns inspired by GitHub Spec-Kit
|
|
59
|
+
- **Quality Standards**: Built-in security, testing, code review, and documentation standards
|
|
60
|
+
- **File-Based Workflow**: Sequential agent coordination with `.myaidev-method/sparc/` outputs
|
|
61
|
+
|
|
62
|
+
### ๐ Content & Publishing
|
|
63
|
+
- **Content Writer Agent**: Professional SEO-optimized content creation
|
|
64
|
+
- **Multi-Platform Publishing**: WordPress, PayloadCMS, Docusaurus, Mintlify, Astro
|
|
65
|
+
- **Git-Based Workflows**: Automated publishing for static site generators
|
|
66
|
+
- **WordPress Admin Agent**: Security, performance, health monitoring, and administration
|
|
67
|
+
|
|
68
|
+
### ๐ Deployment & Infrastructure
|
|
69
|
+
- **Coolify Integration**: Self-hosted PaaS deployment and orchestration
|
|
70
|
+
- **RamNode Optimized**: Deployment patterns optimized for RamNode.com infrastructure
|
|
71
|
+
- **SSH Integration**: Server-level operations for advanced administration
|
|
72
|
+
- **MCP Server Integration**: Optional advanced features with SPARC Orchestrator, Chrome DevTools, and WordPress MCP servers
|
|
73
|
+
|
|
74
|
+
### ๐ ๏ธ Development Tools
|
|
75
|
+
- **Slash Commands**: Easy-to-use Markdown-based commands for Claude Code
|
|
76
|
+
- **Custom Subagents**: Pre-configured AI agents following Claude Code 2.0 standards
|
|
77
|
+
- **Standards Compliant**: Full compatibility with Claude Code, Gemini CLI, Codex CLI
|
|
78
|
+
- **Zero Dependencies**: Core features work standalone, optional MCP integrations
|
|
43
79
|
|
|
44
80
|
## ๐ Installation
|
|
45
81
|
|
|
@@ -98,7 +134,269 @@ npx myaidev-method init
|
|
|
98
134
|
/myai-wordpress-admin health-check
|
|
99
135
|
```
|
|
100
136
|
|
|
101
|
-
##
|
|
137
|
+
## ๐๏ธ SPARC Development Workflow
|
|
138
|
+
|
|
139
|
+
The **MyAIDev Method** implements the **SPARC methodology** - a systematic 5-phase approach to software development inspired by [GitHub Spec-Kit](https://github.com/github/spec-kit) patterns for agentic software development.
|
|
140
|
+
|
|
141
|
+
### What is SPARC?
|
|
142
|
+
|
|
143
|
+
**SPARC** stands for:
|
|
144
|
+
- **S**pecification - Define requirements and system boundaries
|
|
145
|
+
- **P**seudocode - Plan implementation approach
|
|
146
|
+
- **A**rchitecture - Design system structure, APIs, and data models
|
|
147
|
+
- **R**efinement - Implement, test, and review code quality
|
|
148
|
+
- **C**ompletion - Document and deliver production-ready software
|
|
149
|
+
|
|
150
|
+
### The 5 Phases
|
|
151
|
+
|
|
152
|
+
```
|
|
153
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
154
|
+
โ SPARC Workflow: Systematic Software Development โ
|
|
155
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
156
|
+
|
|
157
|
+
Phase 1: ๐๏ธ ARCHITECTURE
|
|
158
|
+
โโ Agent: dev-architect
|
|
159
|
+
โโ Output: .myaidev-method/sparc/architecture.md
|
|
160
|
+
โโ Deliverables:
|
|
161
|
+
โ โโ System design with Mermaid diagrams
|
|
162
|
+
โ โโ API specifications (REST/GraphQL/gRPC)
|
|
163
|
+
โ โโ Data models and schemas
|
|
164
|
+
โ โโ Technology stack recommendations
|
|
165
|
+
โ โโ Security and scalability planning
|
|
166
|
+
โโ Command: /myai-dev-architect "Design authentication system"
|
|
167
|
+
|
|
168
|
+
Phase 2: ๐ป IMPLEMENTATION
|
|
169
|
+
โโ Agent: dev-coder
|
|
170
|
+
โโ Output: .myaidev-method/sparc/code-output/
|
|
171
|
+
โโ Standards: SOLID, Clean Code, DRY/KISS/YAGNI
|
|
172
|
+
โโ Features:
|
|
173
|
+
โ โโ Production-ready code implementation
|
|
174
|
+
โ โโ Security best practices (OWASP Top 10)
|
|
175
|
+
โ โโ Error handling and input validation
|
|
176
|
+
โ โโ Inline documentation (JSDoc, etc.)
|
|
177
|
+
โโ Command: /myai-dev-code "Implement JWT authentication"
|
|
178
|
+
|
|
179
|
+
Phase 3: ๐งช TESTING
|
|
180
|
+
โโ Agent: dev-tester
|
|
181
|
+
โโ Output: .myaidev-method/sparc/test-results/
|
|
182
|
+
โโ Coverage: 80%+ critical paths, 60%+ overall
|
|
183
|
+
โโ Deliverables:
|
|
184
|
+
โ โโ Unit test suites
|
|
185
|
+
โ โโ Integration tests
|
|
186
|
+
โ โโ Coverage reports
|
|
187
|
+
โ โโ Quality gate validation
|
|
188
|
+
โโ Command: /myai-dev-test "Test authentication module"
|
|
189
|
+
|
|
190
|
+
Phase 4: ๐๏ธ REVIEW
|
|
191
|
+
โโ Agent: dev-reviewer
|
|
192
|
+
โโ Output: .myaidev-method/sparc/review-report.md
|
|
193
|
+
โโ Analysis:
|
|
194
|
+
โ โโ Code quality and complexity
|
|
195
|
+
โ โโ Security audit (OWASP Top 10)
|
|
196
|
+
โ โโ Performance optimization
|
|
197
|
+
โ โโ Best practices compliance
|
|
198
|
+
โ โโ Technical debt assessment
|
|
199
|
+
โโ Command: /myai-dev-review "Review authentication implementation"
|
|
200
|
+
|
|
201
|
+
Phase 5: ๐ DOCUMENTATION
|
|
202
|
+
โโ Agent: dev-documenter
|
|
203
|
+
โโ Output: .myaidev-method/sparc/documentation/
|
|
204
|
+
โโ Deliverables:
|
|
205
|
+
โ โโ API reference (OpenAPI/Swagger)
|
|
206
|
+
โ โโ User guides and tutorials
|
|
207
|
+
โ โโ Architecture documentation
|
|
208
|
+
โ โโ Code examples and snippets
|
|
209
|
+
โโ Command: /myai-dev-docs "Document authentication API"
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### Complete Workflow Execution
|
|
213
|
+
|
|
214
|
+
Run the entire SPARC workflow with a single command:
|
|
215
|
+
|
|
216
|
+
```bash
|
|
217
|
+
# Slash command (in Claude Code)
|
|
218
|
+
/myai-sparc-workflow "Build user authentication system with JWT"
|
|
219
|
+
|
|
220
|
+
# CLI command
|
|
221
|
+
npx myaidev-method sparc "Build user authentication system with JWT"
|
|
222
|
+
|
|
223
|
+
# With technology preferences
|
|
224
|
+
npx myaidev-method sparc "Build e-commerce checkout" --tech-stack "react,node,stripe,postgres"
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
### Workflow Output Structure
|
|
228
|
+
|
|
229
|
+
```
|
|
230
|
+
.myaidev-method/
|
|
231
|
+
โโโ sparc/
|
|
232
|
+
โ โโโ architecture.md # Phase 1: System design
|
|
233
|
+
โ โโโ code-output/ # Phase 2: Implementation
|
|
234
|
+
โ โ โโโ src/
|
|
235
|
+
โ โ โโโ tests/
|
|
236
|
+
โ โ โโโ ...
|
|
237
|
+
โ โโโ test-results/ # Phase 3: Testing
|
|
238
|
+
โ โ โโโ unit/
|
|
239
|
+
โ โ โโโ integration/
|
|
240
|
+
โ โ โโโ coverage-report.md
|
|
241
|
+
โ โโโ review-report.md # Phase 4: Code review
|
|
242
|
+
โ โโโ documentation/ # Phase 5: Documentation
|
|
243
|
+
โ โโโ api/
|
|
244
|
+
โ โโโ user-guide/
|
|
245
|
+
โ โโโ architecture/
|
|
246
|
+
โโโ tasks/ # Task tracking
|
|
247
|
+
โโโ workflows/ # Workflow execution logs
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
### Quality Standards
|
|
251
|
+
|
|
252
|
+
Every SPARC workflow enforces:
|
|
253
|
+
|
|
254
|
+
- **Code Quality**: SOLID principles, Clean Code, maintainability metrics
|
|
255
|
+
- **Security**: OWASP Top 10 compliance, vulnerability scanning
|
|
256
|
+
- **Testing**: 80%+ critical path coverage, integration tests
|
|
257
|
+
- **Performance**: Algorithm complexity analysis, optimization recommendations
|
|
258
|
+
- **Documentation**: Complete API docs, user guides, architecture specs
|
|
259
|
+
|
|
260
|
+
### GitHub Spec-Kit Inspiration
|
|
261
|
+
|
|
262
|
+
This framework is inspired by [GitHub's Spec-Kit](https://github.com/github/spec-kit) patterns for agentic software development:
|
|
263
|
+
|
|
264
|
+
- **Systematic Approach**: Structured phases with clear deliverables
|
|
265
|
+
- **Quality Gates**: Validation at each phase transition
|
|
266
|
+
- **Agent Specialization**: Dedicated agents with specific expertise
|
|
267
|
+
- **File-Based Coordination**: Agents communicate through well-defined outputs
|
|
268
|
+
- **Reproducible Workflows**: Consistent results across projects
|
|
269
|
+
|
|
270
|
+
### Individual Phase Commands
|
|
271
|
+
|
|
272
|
+
You can also run individual phases:
|
|
273
|
+
|
|
274
|
+
```bash
|
|
275
|
+
# Slash commands (in Claude Code)
|
|
276
|
+
/myai-dev-architect "Design real-time chat app"
|
|
277
|
+
/myai-dev-code "Implement WebSocket server"
|
|
278
|
+
/myai-dev-test "Test chat functionality" --integration
|
|
279
|
+
/myai-dev-review "Review chat implementation" --security
|
|
280
|
+
/myai-dev-docs "Document chat API"
|
|
281
|
+
|
|
282
|
+
# CLI commands
|
|
283
|
+
npx myaidev-method dev:architect "Design microservices architecture"
|
|
284
|
+
npx myaidev-method dev:code "Implement user service" --test-driven
|
|
285
|
+
npx myaidev-method dev:test "Test user service" --coverage
|
|
286
|
+
npx myaidev-method dev:review "Security audit for user service"
|
|
287
|
+
npx myaidev-method dev:docs "Document user service API"
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
## ๐ค Development Agents
|
|
291
|
+
|
|
292
|
+
### Complete Development Lifecycle Coverage
|
|
293
|
+
|
|
294
|
+
The MyAIDev Method provides specialized agents for every phase of the development lifecycle:
|
|
295
|
+
|
|
296
|
+
### ๐๏ธ Architecture Agent
|
|
297
|
+
**File:** `.claude/agents/dev-architect.md`
|
|
298
|
+
**Phase:** Architecture (SPARC Phase 1)
|
|
299
|
+
|
|
300
|
+
System architect specializing in scalable design, API specifications, and technology selection.
|
|
301
|
+
|
|
302
|
+
**Capabilities:**
|
|
303
|
+
- High-level system architecture with Mermaid diagrams
|
|
304
|
+
- API contract definitions (REST, GraphQL, gRPC)
|
|
305
|
+
- Data modeling and schema design
|
|
306
|
+
- Technology stack recommendations
|
|
307
|
+
- Security architecture planning
|
|
308
|
+
- Scalability and performance planning
|
|
309
|
+
|
|
310
|
+
**Output:** `.myaidev-method/sparc/architecture.md`
|
|
311
|
+
|
|
312
|
+
### ๐ป Implementation Agent (Coder)
|
|
313
|
+
**File:** `.claude/agents/dev-coder.md`
|
|
314
|
+
**Phase:** Implementation (SPARC Phase 2)
|
|
315
|
+
|
|
316
|
+
Production code implementer following SOLID principles and Clean Code practices.
|
|
317
|
+
|
|
318
|
+
**Capabilities:**
|
|
319
|
+
- Feature implementation from architecture specs
|
|
320
|
+
- Code refactoring and optimization
|
|
321
|
+
- SOLID principles application
|
|
322
|
+
- Security best practices (OWASP Top 10)
|
|
323
|
+
- Error handling and input validation
|
|
324
|
+
- Inline documentation (JSDoc, Sphinx, etc.)
|
|
325
|
+
|
|
326
|
+
**Output:** `.myaidev-method/sparc/code-output/`
|
|
327
|
+
|
|
328
|
+
**Quality Standards:**
|
|
329
|
+
- 80%+ test coverage target
|
|
330
|
+
- SOLID, DRY, KISS, YAGNI principles
|
|
331
|
+
- Security-first implementation
|
|
332
|
+
- Comprehensive error handling
|
|
333
|
+
|
|
334
|
+
### ๐งช Testing Agent
|
|
335
|
+
**File:** `.claude/agents/dev-tester.md`
|
|
336
|
+
**Phase:** Testing (SPARC Phase 3)
|
|
337
|
+
|
|
338
|
+
Comprehensive testing specialist with TDD workflow support.
|
|
339
|
+
|
|
340
|
+
**Capabilities:**
|
|
341
|
+
- Unit test creation (AAA pattern)
|
|
342
|
+
- Integration test development
|
|
343
|
+
- Coverage analysis and reporting
|
|
344
|
+
- Quality gate validation
|
|
345
|
+
- Test-Driven Development (TDD) workflow
|
|
346
|
+
- Multiple framework support (Jest, Mocha, Pytest, etc.)
|
|
347
|
+
|
|
348
|
+
**Output:** `.myaidev-method/sparc/test-results/`
|
|
349
|
+
|
|
350
|
+
**Coverage Standards:**
|
|
351
|
+
- 80%+ for critical paths
|
|
352
|
+
- 60%+ overall coverage
|
|
353
|
+
- Pre-commit, pre-merge, pre-deployment gates
|
|
354
|
+
|
|
355
|
+
### ๐๏ธ Code Review Agent
|
|
356
|
+
**File:** `.claude/agents/dev-reviewer.md`
|
|
357
|
+
**Phase:** Review (SPARC Phase 4)
|
|
358
|
+
|
|
359
|
+
Code quality and security analyst with comprehensive review capabilities.
|
|
360
|
+
|
|
361
|
+
**Capabilities:**
|
|
362
|
+
- Code quality metrics and complexity analysis
|
|
363
|
+
- Security audit (OWASP Top 10 compliance)
|
|
364
|
+
- Performance review and optimization
|
|
365
|
+
- Best practices validation (SOLID, framework standards)
|
|
366
|
+
- Technical debt assessment with priority scoring
|
|
367
|
+
- Code smell and anti-pattern detection
|
|
368
|
+
|
|
369
|
+
**Output:** `.myaidev-method/sparc/review-report.md`
|
|
370
|
+
|
|
371
|
+
**Review Standards:**
|
|
372
|
+
- Code quality: Complexity, readability, maintainability
|
|
373
|
+
- Security: OWASP Top 10, vulnerability patterns
|
|
374
|
+
- Performance: Algorithm complexity, resource management
|
|
375
|
+
- Best practices: Framework standards, design patterns
|
|
376
|
+
|
|
377
|
+
### ๐ Documentation Agent
|
|
378
|
+
**File:** `.claude/agents/dev-documenter.md`
|
|
379
|
+
**Phase:** Documentation (SPARC Phase 5)
|
|
380
|
+
|
|
381
|
+
Technical documentation specialist for APIs, user guides, and architecture docs.
|
|
382
|
+
|
|
383
|
+
**Capabilities:**
|
|
384
|
+
- API reference generation (OpenAPI/Swagger)
|
|
385
|
+
- User guide and tutorial creation
|
|
386
|
+
- Architecture documentation
|
|
387
|
+
- Code example generation and testing
|
|
388
|
+
- Multiple format support (Markdown, HTML, reStructuredText)
|
|
389
|
+
- Inline code documentation (JSDoc, Sphinx, etc.)
|
|
390
|
+
|
|
391
|
+
**Output:** `.myaidev-method/sparc/documentation/`
|
|
392
|
+
|
|
393
|
+
**Documentation Standards:**
|
|
394
|
+
- Clarity: Simple language, clear examples, visual aids
|
|
395
|
+
- Completeness: All public APIs documented
|
|
396
|
+
- Accuracy: Tested code examples, synchronized with code
|
|
397
|
+
- Accessibility: Multiple formats, searchable, well-organized
|
|
398
|
+
|
|
399
|
+
## ๐ Content & Publishing Agents
|
|
102
400
|
|
|
103
401
|
### Content Writer Agent
|
|
104
402
|
**File:** `.claude/agents/content-writer.md`
|
|
@@ -113,9 +411,7 @@ Professional content writer specializing in creating high-quality, engaging, and
|
|
|
113
411
|
- Multiple tone and audience support
|
|
114
412
|
- Keyword optimization
|
|
115
413
|
|
|
116
|
-
###
|
|
117
|
-
|
|
118
|
-
#### WordPress Admin Agent
|
|
414
|
+
### WordPress Admin Agent
|
|
119
415
|
**File:** `.claude/agents/wordpress-admin.md`
|
|
120
416
|
|
|
121
417
|
WordPress administrator for comprehensive site management, security, performance, and health analysis.
|
|
@@ -305,6 +601,67 @@ Configure MyAI Method settings.
|
|
|
305
601
|
|
|
306
602
|
For detailed publishing workflows and platform-specific guides, see **[PUBLISHING_GUIDE.md](PUBLISHING_GUIDE.md)**
|
|
307
603
|
|
|
604
|
+
## ๐ง MCP Server Integration
|
|
605
|
+
|
|
606
|
+
MyAIDev Method includes three optional MCP (Model Context Protocol) servers for advanced orchestration, testing, and WordPress integration.
|
|
607
|
+
|
|
608
|
+
### Available MCP Servers
|
|
609
|
+
|
|
610
|
+
**1. SPARC Orchestrator** - Workflow automation for the 5-phase SPARC methodology
|
|
611
|
+
- `sparc_orchestrate` - Orchestrate complete 5-phase workflows
|
|
612
|
+
- `sparc_status` - Get workflow execution status
|
|
613
|
+
- `sparc_phase_execute` - Execute single SPARC phases
|
|
614
|
+
- `sparc_workflow_history` - View workflow history
|
|
615
|
+
- `sparc_task_results` - Get detailed workflow results
|
|
616
|
+
|
|
617
|
+
**2. Chrome DevTools MCP** - Browser automation and testing ([chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp))
|
|
618
|
+
- `cdp_connect` - Connect to Chrome DevTools Protocol
|
|
619
|
+
- `cdp_navigate` - Browser navigation
|
|
620
|
+
- `cdp_screenshot` - Visual testing with screenshots
|
|
621
|
+
- `cdp_evaluate` - Execute JavaScript in browser
|
|
622
|
+
- `cdp_network_monitor` - Monitor network requests
|
|
623
|
+
- `cdp_console_logs` - Capture console logs
|
|
624
|
+
|
|
625
|
+
**3. WordPress MCP** - Enhanced WordPress operations with session management
|
|
626
|
+
- Session management and memory persistence
|
|
627
|
+
- Health monitoring and site statistics
|
|
628
|
+
- Batch publishing operations
|
|
629
|
+
- Enhanced WordPress REST API integration
|
|
630
|
+
|
|
631
|
+
### Setup MCP Servers
|
|
632
|
+
|
|
633
|
+
Add to Claude Code MCP settings:
|
|
634
|
+
|
|
635
|
+
```bash
|
|
636
|
+
# SPARC Orchestrator
|
|
637
|
+
claude mcp add myaidev-sparc npx myaidev-sparc-orchestrator
|
|
638
|
+
|
|
639
|
+
# Chrome DevTools (requires separate installation)
|
|
640
|
+
npm install -g chrome-devtools-mcp
|
|
641
|
+
claude mcp add chrome-devtools npx chrome-devtools-mcp
|
|
642
|
+
|
|
643
|
+
# WordPress MCP
|
|
644
|
+
claude mcp add myaidev-wordpress npx myaidev-mcp-server
|
|
645
|
+
```
|
|
646
|
+
|
|
647
|
+
### Usage Example
|
|
648
|
+
|
|
649
|
+
```javascript
|
|
650
|
+
// Orchestrate complete SPARC workflow
|
|
651
|
+
mcp__myaidev_sparc__sparc_orchestrate({
|
|
652
|
+
task: "Build user authentication system",
|
|
653
|
+
strategy: "sequential",
|
|
654
|
+
phases: ["architecture", "implementation", "testing", "review", "documentation"],
|
|
655
|
+
options: {
|
|
656
|
+
techStack: "nextjs,payloadcms,mongodb",
|
|
657
|
+
testFramework: "jest",
|
|
658
|
+
focusSecurity: true
|
|
659
|
+
}
|
|
660
|
+
})
|
|
661
|
+
```
|
|
662
|
+
|
|
663
|
+
For detailed MCP setup and usage, see **[MCP_INTEGRATION.md](MCP_INTEGRATION.md)**
|
|
664
|
+
|
|
308
665
|
## โ๏ธ Configuration
|
|
309
666
|
|
|
310
667
|
After installation for Claude Code, the package creates a `.claude` directory following official standards:
|
package/bin/cli.js
CHANGED
|
@@ -67,7 +67,15 @@ program
|
|
|
67
67
|
|
|
68
68
|
console.log('\n' + chalk.cyan('๐ You\'re all set! Here\'s how to get started:'));
|
|
69
69
|
if (cliType === 'claude') {
|
|
70
|
-
console.log(chalk.green('\n
|
|
70
|
+
console.log(chalk.green('\n๐๏ธ SPARC Development Workflow (Systematic Software Development):'));
|
|
71
|
+
console.log(chalk.gray(' โข Complete: /myai-sparc-workflow "Build authentication system"'));
|
|
72
|
+
console.log(chalk.gray(' โข Architecture: /myai-dev-architect "Design microservices"'));
|
|
73
|
+
console.log(chalk.gray(' โข Code: /myai-dev-code "Implement user service"'));
|
|
74
|
+
console.log(chalk.gray(' โข Test: /myai-dev-test "Test authentication"'));
|
|
75
|
+
console.log(chalk.gray(' โข Review: /myai-dev-review "Security audit"'));
|
|
76
|
+
console.log(chalk.gray(' โข Document: /myai-dev-docs "API documentation"'));
|
|
77
|
+
|
|
78
|
+
console.log(chalk.green('\nโจ Content creation:'));
|
|
71
79
|
console.log(chalk.gray(' /myai-content-writer "Your Article Topic"'));
|
|
72
80
|
|
|
73
81
|
console.log(chalk.yellow('\n๐ค Publish to multiple platforms:'));
|
|
@@ -86,14 +94,24 @@ program
|
|
|
86
94
|
|
|
87
95
|
console.log(chalk.magenta('\n๐ Documentation copied to your project:'));
|
|
88
96
|
console.log(chalk.gray(' โข USER_GUIDE.md - Getting started and customization'));
|
|
97
|
+
console.log(chalk.gray(' โข DEV_WORKFLOW_GUIDE.md - SPARC methodology guide'));
|
|
98
|
+
console.log(chalk.gray(' โข MCP_INTEGRATION.md - MCP server setup and usage'));
|
|
89
99
|
console.log(chalk.gray(' โข PUBLISHING_GUIDE.md - Multi-platform publishing'));
|
|
90
100
|
console.log(chalk.gray(' โข COOLIFY_DEPLOYMENT.md - Application deployment'));
|
|
91
101
|
console.log(chalk.gray(' โข WORDPRESS_ADMIN_SCRIPTS.md - WordPress utilities'));
|
|
92
102
|
console.log(chalk.gray(' โข TECHNICAL_ARCHITECTURE.md - Developer guide'));
|
|
93
103
|
|
|
104
|
+
console.log(chalk.magenta('\n๐ง MCP Server Integration (Optional Advanced Features):'));
|
|
105
|
+
console.log(chalk.gray(' โข SPARC Orchestrator: Workflow automation with MCP tools'));
|
|
106
|
+
console.log(chalk.gray(' โข Chrome DevTools: Browser testing and debugging'));
|
|
107
|
+
console.log(chalk.gray(' โข WordPress MCP: Enhanced WordPress API operations'));
|
|
108
|
+
console.log(chalk.gray(' โข Add to Claude Code MCP settings to enable'));
|
|
109
|
+
|
|
94
110
|
console.log(chalk.magenta('\n๐ก Quick tips:'));
|
|
111
|
+
console.log(chalk.gray(' โข SPARC workflow: Architecture โ Code โ Test โ Review โ Docs'));
|
|
95
112
|
console.log(chalk.gray(' โข All platforms support draft/published workflows'));
|
|
96
113
|
console.log(chalk.gray(' โข Git-based platforms (Docusaurus, Mintlify, Astro) auto-commit'));
|
|
114
|
+
console.log(chalk.gray(' โข MCP servers provide advanced orchestration and testing'));
|
|
97
115
|
console.log(chalk.gray(' โข Visit: https://github.com/myaione/myaidev-method'));
|
|
98
116
|
}
|
|
99
117
|
console.log(chalk.cyan(`\n๐ Restart ${cliType} to load your new AI-powered commands!`));
|
|
@@ -166,6 +184,14 @@ This project uses the MyAIDev Method package for enhanced AI-assisted developmen
|
|
|
166
184
|
|
|
167
185
|
## Available Commands
|
|
168
186
|
|
|
187
|
+
### SPARC Development Workflow (Systematic Software Development)
|
|
188
|
+
- \`/myai-sparc-workflow\` - Complete 5-phase SPARC workflow
|
|
189
|
+
- \`/myai-dev-architect\` - Design system architecture (Phase 1)
|
|
190
|
+
- \`/myai-dev-code\` - Implement features with SOLID principles (Phase 2)
|
|
191
|
+
- \`/myai-dev-test\` - Create comprehensive tests (Phase 3)
|
|
192
|
+
- \`/myai-dev-review\` - Code quality and security review (Phase 4)
|
|
193
|
+
- \`/myai-dev-docs\` - Generate documentation (Phase 5)
|
|
194
|
+
|
|
169
195
|
### Content Creation
|
|
170
196
|
- \`/myai-content-writer\` - Create SEO-optimized content
|
|
171
197
|
|
|
@@ -185,12 +211,22 @@ This project uses the MyAIDev Method package for enhanced AI-assisted developmen
|
|
|
185
211
|
|
|
186
212
|
## Available Agents
|
|
187
213
|
|
|
214
|
+
### Development Agents (SPARC Methodology)
|
|
215
|
+
- \`dev-architect\` - System architecture and design agent
|
|
216
|
+
- \`dev-coder\` - Code implementation agent with SOLID principles
|
|
217
|
+
- \`dev-tester\` - Testing and quality assurance agent
|
|
218
|
+
- \`dev-reviewer\` - Code review and security analysis agent
|
|
219
|
+
- \`dev-documenter\` - Technical documentation agent
|
|
220
|
+
|
|
221
|
+
### Content & Publishing Agents
|
|
188
222
|
- \`content-writer\` - Professional content creation agent
|
|
189
223
|
- \`wordpress-admin\` - WordPress administration and security agent
|
|
190
224
|
- \`payloadcms-publish\` - PayloadCMS publishing agent
|
|
191
225
|
- \`docusaurus-publish\` - Docusaurus publishing agent
|
|
192
226
|
- \`mintlify-publish\` - Mintlify publishing agent
|
|
193
227
|
- \`astro-publish\` - Astro publishing agent
|
|
228
|
+
|
|
229
|
+
### Deployment Agents
|
|
194
230
|
- \`coolify-deploy\` - Coolify deployment agent
|
|
195
231
|
|
|
196
232
|
## Platform Configuration
|
|
@@ -254,6 +290,8 @@ This configuration follows Claude Code's official standards for custom commands
|
|
|
254
290
|
// Copy documentation files to project root
|
|
255
291
|
const docsToMerge = [
|
|
256
292
|
'USER_GUIDE.md',
|
|
293
|
+
'DEV_WORKFLOW_GUIDE.md',
|
|
294
|
+
'MCP_INTEGRATION.md',
|
|
257
295
|
'PUBLISHING_GUIDE.md',
|
|
258
296
|
'COOLIFY_DEPLOYMENT.md',
|
|
259
297
|
'WORDPRESS_ADMIN_SCRIPTS.md',
|
package/dist/mcp/mcp-config.json
CHANGED
|
@@ -1,12 +1,91 @@
|
|
|
1
1
|
{
|
|
2
|
-
"
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
2
|
+
"servers": [
|
|
3
|
+
{
|
|
4
|
+
"name": "myaidev-wordpress-mcp-server",
|
|
5
|
+
"version": "2.0.0",
|
|
6
|
+
"description": "Enhanced WordPress MCP Server with session management and memory persistence",
|
|
7
|
+
"mcpName": "io.github.myaione/myaidev-method-wordpress",
|
|
8
|
+
"transport": "stdio",
|
|
9
|
+
"command": "node .claude/mcp/wordpress-server.js"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"name": "myaidev-sparc-orchestrator",
|
|
13
|
+
"version": "1.0.0",
|
|
14
|
+
"description": "SPARC workflow orchestration MCP server for systematic development",
|
|
15
|
+
"mcpName": "io.github.myaione/myaidev-method-sparc",
|
|
16
|
+
"transport": "stdio",
|
|
17
|
+
"command": "node .claude/mcp/sparc-orchestrator-server.js"
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"name": "chrome-devtools-mcp",
|
|
21
|
+
"version": "1.0.0",
|
|
22
|
+
"description": "Chrome DevTools Protocol MCP server for browser testing and debugging",
|
|
23
|
+
"mcpName": "chrome-devtools-mcp",
|
|
24
|
+
"transport": "stdio",
|
|
25
|
+
"command": "npx chrome-devtools-mcp"
|
|
26
|
+
}
|
|
27
|
+
],
|
|
28
|
+
"wordpress_server": {
|
|
29
|
+
"sparc_tools": [
|
|
30
|
+
{
|
|
31
|
+
"name": "sparc_orchestrate",
|
|
32
|
+
"description": "Orchestrate the complete 5-phase SPARC development workflow with intelligent task routing",
|
|
33
|
+
"category": "orchestration"
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"name": "sparc_status",
|
|
37
|
+
"description": "Get status of current SPARC workflow execution",
|
|
38
|
+
"category": "monitoring"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"name": "sparc_phase_execute",
|
|
42
|
+
"description": "Execute a single SPARC phase with detailed configuration",
|
|
43
|
+
"category": "execution"
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"name": "sparc_workflow_history",
|
|
47
|
+
"description": "Get history of SPARC workflow executions",
|
|
48
|
+
"category": "monitoring"
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
"name": "sparc_task_results",
|
|
52
|
+
"description": "Get detailed results from a completed SPARC workflow",
|
|
53
|
+
"category": "results"
|
|
54
|
+
}
|
|
55
|
+
],
|
|
56
|
+
"chrome_devtools_tools": [
|
|
57
|
+
{
|
|
58
|
+
"name": "cdp_connect",
|
|
59
|
+
"description": "Connect to Chrome DevTools Protocol for browser automation",
|
|
60
|
+
"category": "connection"
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"name": "cdp_navigate",
|
|
64
|
+
"description": "Navigate browser to a URL",
|
|
65
|
+
"category": "navigation"
|
|
66
|
+
},
|
|
67
|
+
{
|
|
68
|
+
"name": "cdp_screenshot",
|
|
69
|
+
"description": "Take screenshot of current page",
|
|
70
|
+
"category": "testing"
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"name": "cdp_evaluate",
|
|
74
|
+
"description": "Execute JavaScript in browser context",
|
|
75
|
+
"category": "testing"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"name": "cdp_network_monitor",
|
|
79
|
+
"description": "Monitor network requests and responses",
|
|
80
|
+
"category": "testing"
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"name": "cdp_console_logs",
|
|
84
|
+
"description": "Capture browser console logs",
|
|
85
|
+
"category": "debugging"
|
|
86
|
+
}
|
|
87
|
+
],
|
|
88
|
+
"wordpress_tools": [
|
|
10
89
|
{
|
|
11
90
|
"name": "wp_session_create",
|
|
12
91
|
"description": "Create a new session for tracking operations and maintaining context",
|
|
@@ -70,12 +149,16 @@
|
|
|
70
149
|
],
|
|
71
150
|
"capabilities": [
|
|
72
151
|
"session_management",
|
|
73
|
-
"memory_persistence",
|
|
152
|
+
"memory_persistence",
|
|
74
153
|
"health_monitoring",
|
|
75
154
|
"wordpress_integration",
|
|
76
155
|
"batch_operations",
|
|
77
156
|
"gutenberg_support",
|
|
78
|
-
"error_tracking"
|
|
157
|
+
"error_tracking",
|
|
158
|
+
"sparc_orchestration",
|
|
159
|
+
"workflow_management",
|
|
160
|
+
"browser_automation",
|
|
161
|
+
"devtools_integration"
|
|
79
162
|
],
|
|
80
163
|
"environment": {
|
|
81
164
|
"required": [
|