mindforge-cc 11.2.1 → 11.3.0

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.
Files changed (190) hide show
  1. package/.mindforge/config.json +2 -2
  2. package/.mindforge/imported-agents.jsonl +154 -0
  3. package/CHANGELOG.md +43 -0
  4. package/MINDFORGE.md +3 -3
  5. package/README.md +1 -1
  6. package/bin/installer-core.js +95 -1
  7. package/bin/spawn-agent.js +80 -1
  8. package/bin/wizard/theme.js +4 -3
  9. package/package.json +3 -1
  10. package/subagents/.claude-plugin/marketplace.json +93 -0
  11. package/subagents/categories/01-core-development/.claude-plugin/plugin.json +24 -0
  12. package/subagents/categories/01-core-development/README.md +146 -0
  13. package/subagents/categories/01-core-development/api-designer-cc.md +237 -0
  14. package/subagents/categories/01-core-development/backend-developer.md +222 -0
  15. package/subagents/categories/01-core-development/design-bridge.md +129 -0
  16. package/subagents/categories/01-core-development/electron-pro.md +240 -0
  17. package/subagents/categories/01-core-development/frontend-developer.md +133 -0
  18. package/subagents/categories/01-core-development/fullstack-developer.md +235 -0
  19. package/subagents/categories/01-core-development/graphql-architect.md +238 -0
  20. package/subagents/categories/01-core-development/microservices-architect.md +239 -0
  21. package/subagents/categories/01-core-development/mobile-developer.md +283 -0
  22. package/subagents/categories/01-core-development/ui-designer.md +174 -0
  23. package/subagents/categories/01-core-development/websocket-engineer.md +150 -0
  24. package/subagents/categories/02-language-specialists/.claude-plugin/plugin.json +43 -0
  25. package/subagents/categories/02-language-specialists/README.md +245 -0
  26. package/subagents/categories/02-language-specialists/angular-architect.md +287 -0
  27. package/subagents/categories/02-language-specialists/cpp-pro.md +277 -0
  28. package/subagents/categories/02-language-specialists/csharp-developer.md +287 -0
  29. package/subagents/categories/02-language-specialists/django-developer.md +287 -0
  30. package/subagents/categories/02-language-specialists/dotnet-core-expert.md +287 -0
  31. package/subagents/categories/02-language-specialists/dotnet-framework-48-expert.md +306 -0
  32. package/subagents/categories/02-language-specialists/elixir-expert.md +311 -0
  33. package/subagents/categories/02-language-specialists/expo-react-native-expert.md +268 -0
  34. package/subagents/categories/02-language-specialists/fastapi-developer.md +287 -0
  35. package/subagents/categories/02-language-specialists/flutter-expert.md +287 -0
  36. package/subagents/categories/02-language-specialists/golang-pro.md +277 -0
  37. package/subagents/categories/02-language-specialists/java-architect.md +287 -0
  38. package/subagents/categories/02-language-specialists/javascript-pro.md +277 -0
  39. package/subagents/categories/02-language-specialists/kotlin-specialist.md +287 -0
  40. package/subagents/categories/02-language-specialists/laravel-specialist.md +287 -0
  41. package/subagents/categories/02-language-specialists/nextjs-developer.md +287 -0
  42. package/subagents/categories/02-language-specialists/node-specialist.md +124 -0
  43. package/subagents/categories/02-language-specialists/php-pro.md +287 -0
  44. package/subagents/categories/02-language-specialists/powershell-51-expert.md +59 -0
  45. package/subagents/categories/02-language-specialists/powershell-7-expert.md +57 -0
  46. package/subagents/categories/02-language-specialists/python-pro.md +277 -0
  47. package/subagents/categories/02-language-specialists/rails-expert.md +358 -0
  48. package/subagents/categories/02-language-specialists/react-specialist-cc.md +287 -0
  49. package/subagents/categories/02-language-specialists/rust-engineer.md +287 -0
  50. package/subagents/categories/02-language-specialists/spring-boot-engineer.md +287 -0
  51. package/subagents/categories/02-language-specialists/sql-pro.md +287 -0
  52. package/subagents/categories/02-language-specialists/swift-expert.md +287 -0
  53. package/subagents/categories/02-language-specialists/symfony-specialist.md +354 -0
  54. package/subagents/categories/02-language-specialists/typescript-pro.md +277 -0
  55. package/subagents/categories/02-language-specialists/vue-expert.md +287 -0
  56. package/subagents/categories/03-infrastructure/.claude-plugin/plugin.json +29 -0
  57. package/subagents/categories/03-infrastructure/README.md +170 -0
  58. package/subagents/categories/03-infrastructure/azure-infra-engineer.md +53 -0
  59. package/subagents/categories/03-infrastructure/cloud-architect-cc.md +277 -0
  60. package/subagents/categories/03-infrastructure/database-administrator.md +287 -0
  61. package/subagents/categories/03-infrastructure/deployment-engineer.md +287 -0
  62. package/subagents/categories/03-infrastructure/devops-engineer-cc.md +287 -0
  63. package/subagents/categories/03-infrastructure/devops-incident-responder.md +287 -0
  64. package/subagents/categories/03-infrastructure/docker-expert.md +278 -0
  65. package/subagents/categories/03-infrastructure/incident-responder.md +287 -0
  66. package/subagents/categories/03-infrastructure/kubernetes-specialist.md +287 -0
  67. package/subagents/categories/03-infrastructure/network-engineer.md +287 -0
  68. package/subagents/categories/03-infrastructure/platform-engineer-cc.md +287 -0
  69. package/subagents/categories/03-infrastructure/security-engineer.md +277 -0
  70. package/subagents/categories/03-infrastructure/sre-engineer.md +287 -0
  71. package/subagents/categories/03-infrastructure/terraform-engineer.md +287 -0
  72. package/subagents/categories/03-infrastructure/terragrunt-expert.md +307 -0
  73. package/subagents/categories/03-infrastructure/windows-infra-admin.md +52 -0
  74. package/subagents/categories/04-quality-security/.claude-plugin/plugin.json +30 -0
  75. package/subagents/categories/04-quality-security/README.md +175 -0
  76. package/subagents/categories/04-quality-security/accessibility-tester-cc.md +277 -0
  77. package/subagents/categories/04-quality-security/ad-security-reviewer.md +56 -0
  78. package/subagents/categories/04-quality-security/ai-writing-auditor.md +77 -0
  79. package/subagents/categories/04-quality-security/architect-reviewer.md +287 -0
  80. package/subagents/categories/04-quality-security/chaos-engineer-cc.md +277 -0
  81. package/subagents/categories/04-quality-security/code-reviewer.md +287 -0
  82. package/subagents/categories/04-quality-security/compliance-auditor-cc.md +277 -0
  83. package/subagents/categories/04-quality-security/debugger-cc.md +287 -0
  84. package/subagents/categories/04-quality-security/error-detective.md +287 -0
  85. package/subagents/categories/04-quality-security/gdpr-ccpa-compliance.md +98 -0
  86. package/subagents/categories/04-quality-security/penetration-tester.md +287 -0
  87. package/subagents/categories/04-quality-security/performance-engineer.md +287 -0
  88. package/subagents/categories/04-quality-security/powershell-security-hardening.md +54 -0
  89. package/subagents/categories/04-quality-security/qa-expert.md +287 -0
  90. package/subagents/categories/04-quality-security/security-auditor.md +287 -0
  91. package/subagents/categories/04-quality-security/test-automator.md +287 -0
  92. package/subagents/categories/04-quality-security/ui-ux-tester.md +234 -0
  93. package/subagents/categories/05-data-ai/.claude-plugin/plugin.json +26 -0
  94. package/subagents/categories/05-data-ai/README.md +153 -0
  95. package/subagents/categories/05-data-ai/ai-engineer.md +287 -0
  96. package/subagents/categories/05-data-ai/data-analyst.md +277 -0
  97. package/subagents/categories/05-data-ai/data-engineer-cc.md +287 -0
  98. package/subagents/categories/05-data-ai/data-scientist.md +287 -0
  99. package/subagents/categories/05-data-ai/database-optimizer.md +287 -0
  100. package/subagents/categories/05-data-ai/llm-architect.md +287 -0
  101. package/subagents/categories/05-data-ai/machine-learning-engineer.md +277 -0
  102. package/subagents/categories/05-data-ai/ml-engineer-cc.md +287 -0
  103. package/subagents/categories/05-data-ai/mlops-engineer.md +287 -0
  104. package/subagents/categories/05-data-ai/nlp-engineer.md +287 -0
  105. package/subagents/categories/05-data-ai/postgres-pro.md +287 -0
  106. package/subagents/categories/05-data-ai/prompt-engineer-cc.md +287 -0
  107. package/subagents/categories/05-data-ai/reinforcement-learning-engineer.md +277 -0
  108. package/subagents/categories/06-developer-experience/.claude-plugin/plugin.json +28 -0
  109. package/subagents/categories/06-developer-experience/README.md +157 -0
  110. package/subagents/categories/06-developer-experience/build-engineer-cc.md +286 -0
  111. package/subagents/categories/06-developer-experience/cli-developer.md +286 -0
  112. package/subagents/categories/06-developer-experience/dependency-manager.md +286 -0
  113. package/subagents/categories/06-developer-experience/documentation-engineer.md +276 -0
  114. package/subagents/categories/06-developer-experience/dx-optimizer.md +286 -0
  115. package/subagents/categories/06-developer-experience/git-workflow-manager.md +286 -0
  116. package/subagents/categories/06-developer-experience/legacy-modernizer.md +286 -0
  117. package/subagents/categories/06-developer-experience/mcp-developer.md +275 -0
  118. package/subagents/categories/06-developer-experience/powershell-module-architect.md +58 -0
  119. package/subagents/categories/06-developer-experience/powershell-ui-architect.md +135 -0
  120. package/subagents/categories/06-developer-experience/readme-generator.md +238 -0
  121. package/subagents/categories/06-developer-experience/refactoring-specialist.md +286 -0
  122. package/subagents/categories/06-developer-experience/slack-expert.md +232 -0
  123. package/subagents/categories/06-developer-experience/tooling-engineer.md +286 -0
  124. package/subagents/categories/06-developer-experience/visual-asset-generator.md +34 -0
  125. package/subagents/categories/07-specialized-domains/.claude-plugin/plugin.json +27 -0
  126. package/subagents/categories/07-specialized-domains/README.md +161 -0
  127. package/subagents/categories/07-specialized-domains/api-documenter.md +277 -0
  128. package/subagents/categories/07-specialized-domains/blockchain-developer.md +287 -0
  129. package/subagents/categories/07-specialized-domains/embedded-systems.md +287 -0
  130. package/subagents/categories/07-specialized-domains/fintech-engineer.md +287 -0
  131. package/subagents/categories/07-specialized-domains/game-developer.md +287 -0
  132. package/subagents/categories/07-specialized-domains/healthcare-admin.md +199 -0
  133. package/subagents/categories/07-specialized-domains/hipaa-compliance.md +112 -0
  134. package/subagents/categories/07-specialized-domains/iot-engineer.md +287 -0
  135. package/subagents/categories/07-specialized-domains/m365-admin.md +48 -0
  136. package/subagents/categories/07-specialized-domains/mobile-app-developer.md +287 -0
  137. package/subagents/categories/07-specialized-domains/payment-integration.md +287 -0
  138. package/subagents/categories/07-specialized-domains/quant-analyst.md +287 -0
  139. package/subagents/categories/07-specialized-domains/risk-manager.md +287 -0
  140. package/subagents/categories/07-specialized-domains/seo-specialist-cc.md +184 -0
  141. package/subagents/categories/08-business-product/.claude-plugin/plugin.json +29 -0
  142. package/subagents/categories/08-business-product/README.md +160 -0
  143. package/subagents/categories/08-business-product/assumption-mapping.md +77 -0
  144. package/subagents/categories/08-business-product/backlog-grooming.md +88 -0
  145. package/subagents/categories/08-business-product/business-analyst-cc.md +287 -0
  146. package/subagents/categories/08-business-product/content-marketer.md +287 -0
  147. package/subagents/categories/08-business-product/content-quality-editor.md +55 -0
  148. package/subagents/categories/08-business-product/customer-success-manager.md +287 -0
  149. package/subagents/categories/08-business-product/growth-loops.md +91 -0
  150. package/subagents/categories/08-business-product/legal-advisor.md +287 -0
  151. package/subagents/categories/08-business-product/license-engineer.md +295 -0
  152. package/subagents/categories/08-business-product/product-manager-cc.md +287 -0
  153. package/subagents/categories/08-business-product/project-manager.md +287 -0
  154. package/subagents/categories/08-business-product/sales-engineer.md +287 -0
  155. package/subagents/categories/08-business-product/scrum-master.md +287 -0
  156. package/subagents/categories/08-business-product/technical-writer.md +287 -0
  157. package/subagents/categories/08-business-product/ux-researcher.md +287 -0
  158. package/subagents/categories/08-business-product/wordpress-master.md +316 -0
  159. package/subagents/categories/09-meta-orchestration/.claude-plugin/plugin.json +24 -0
  160. package/subagents/categories/09-meta-orchestration/README.md +140 -0
  161. package/subagents/categories/09-meta-orchestration/agent-installer.md +97 -0
  162. package/subagents/categories/09-meta-orchestration/agent-organizer.md +287 -0
  163. package/subagents/categories/09-meta-orchestration/codebase-orchestrator.md +249 -0
  164. package/subagents/categories/09-meta-orchestration/context-manager.md +287 -0
  165. package/subagents/categories/09-meta-orchestration/error-coordinator.md +287 -0
  166. package/subagents/categories/09-meta-orchestration/it-ops-orchestrator.md +60 -0
  167. package/subagents/categories/09-meta-orchestration/knowledge-synthesizer.md +287 -0
  168. package/subagents/categories/09-meta-orchestration/multi-agent-coordinator.md +287 -0
  169. package/subagents/categories/09-meta-orchestration/performance-monitor.md +287 -0
  170. package/subagents/categories/09-meta-orchestration/task-distributor.md +287 -0
  171. package/subagents/categories/09-meta-orchestration/workflow-orchestrator.md +287 -0
  172. package/subagents/categories/10-research-analysis/.claude-plugin/plugin.json +24 -0
  173. package/subagents/categories/10-research-analysis/README.md +141 -0
  174. package/subagents/categories/10-research-analysis/ab-test-analysis.md +101 -0
  175. package/subagents/categories/10-research-analysis/cohort-analysis.md +100 -0
  176. package/subagents/categories/10-research-analysis/competitive-analyst.md +287 -0
  177. package/subagents/categories/10-research-analysis/data-researcher.md +287 -0
  178. package/subagents/categories/10-research-analysis/first-principles-thinking.md +100 -0
  179. package/subagents/categories/10-research-analysis/market-researcher.md +287 -0
  180. package/subagents/categories/10-research-analysis/project-idea-validator.md +269 -0
  181. package/subagents/categories/10-research-analysis/research-analyst.md +287 -0
  182. package/subagents/categories/10-research-analysis/scientific-literature-researcher.md +151 -0
  183. package/subagents/categories/10-research-analysis/search-specialist.md +287 -0
  184. package/subagents/categories/10-research-analysis/trend-analyst.md +287 -0
  185. package/subagents/tools/subagent-catalog/README.md +58 -0
  186. package/subagents/tools/subagent-catalog/config.sh +94 -0
  187. package/subagents/tools/subagent-catalog/fetch.md +82 -0
  188. package/subagents/tools/subagent-catalog/invalidate.md +47 -0
  189. package/subagents/tools/subagent-catalog/list.md +54 -0
  190. package/subagents/tools/subagent-catalog/search.md +58 -0
@@ -10,17 +10,83 @@ const fs = require('fs');
10
10
  const path = require('path');
11
11
 
12
12
  const ARGS = process.argv.slice(2);
13
- const MODE = ARGS[0]; // 'spawn' or 'identity'
13
+ const MODE = ARGS[0]; // 'spawn', 'identity', or 'subagent'
14
14
  const TARGET = ARGS[1];
15
15
  const IS_DRY_RUN = ARGS.includes('--dry-run');
16
16
 
17
17
  const ROOT = path.resolve(__dirname, '..');
18
+ const SUBAGENTS_DIR = path.join(ROOT, 'subagents');
19
+ const INDEX_PATH = path.join(ROOT, '.mindforge', 'imported-agents.jsonl');
20
+
21
+ // Names are restricted to a strict allowlist: no path separators, no '..', and
22
+ // only [A-Za-z0-9-_]. This is the first line of defense against path traversal
23
+ // in the `subagent` mode — names that fail this never touch the filesystem.
24
+ const SAFE_NAME_PATTERN = /^[A-Za-z0-9-_]+$/;
18
25
 
19
26
  if (!MODE || !TARGET) {
20
27
  console.error('❌ Usage: node bin/spawn-agent.js <mode> <target> [--dry-run]');
28
+ console.error(' modes: identity | spawn | subagent');
21
29
  process.exit(1);
22
30
  }
23
31
 
32
+ /**
33
+ * Validate a user-supplied subagent name against the strict allowlist. Rejects
34
+ * path separators, parent-dir tokens, and any character outside [A-Za-z0-9-_].
35
+ * Exits the process on violation rather than returning, so no unsafe name can
36
+ * proceed to a filesystem lookup.
37
+ */
38
+ function assertSafeName(name) {
39
+ if (!SAFE_NAME_PATTERN.test(name)) {
40
+ console.error(`❌ Invalid subagent name: "${name}" (allowed: A-Z a-z 0-9 - _)`);
41
+ process.exit(1);
42
+ }
43
+ }
44
+
45
+ /**
46
+ * Resolve a subagent name to its index entry by EXACT name match. Never builds
47
+ * a path from user input — only paths recorded in the trusted index are used.
48
+ * Returns the matching entry or null if no entry matches.
49
+ */
50
+ function findIndexEntry(name) {
51
+ if (!fs.existsSync(INDEX_PATH)) {
52
+ console.error(`❌ Subagent index not found: ${INDEX_PATH}`);
53
+ console.error(' Run: node scripts/build-subagent-index.js');
54
+ process.exit(1);
55
+ }
56
+
57
+ const lines = fs.readFileSync(INDEX_PATH, 'utf8').split('\n');
58
+ for (const line of lines) {
59
+ if (!line.trim()) {
60
+ continue;
61
+ }
62
+ const entry = JSON.parse(line);
63
+ if (entry.name === name) {
64
+ return entry;
65
+ }
66
+ }
67
+ return null;
68
+ }
69
+
70
+ /**
71
+ * Resolve and verify the absolute path for an index entry. Confirms the
72
+ * resolved path stays within the repo's subagents/ directory before returning
73
+ * it (defense in depth against a tampered index). Exits on any violation.
74
+ */
75
+ function resolveSubagentPath(entry) {
76
+ const absolutePath = path.resolve(ROOT, entry.path);
77
+ const containmentRoot = SUBAGENTS_DIR + path.sep;
78
+
79
+ if (!absolutePath.startsWith(containmentRoot)) {
80
+ console.error(`❌ Resolved path escapes subagents/: ${absolutePath}`);
81
+ process.exit(1);
82
+ }
83
+ if (!fs.existsSync(absolutePath)) {
84
+ console.error(`❌ Subagent file missing: ${absolutePath}`);
85
+ process.exit(1);
86
+ }
87
+ return absolutePath;
88
+ }
89
+
24
90
  async function run() {
25
91
  let identityPath;
26
92
  let personaPath;
@@ -39,6 +105,19 @@ async function run() {
39
105
  process.exit(1);
40
106
  }
41
107
  console.log(`🌌 Spawning persona essence: ${TARGET}`);
108
+ } else if (MODE === 'subagent') {
109
+ assertSafeName(TARGET);
110
+ const entry = findIndexEntry(TARGET);
111
+ if (!entry) {
112
+ console.error(`❌ Subagent not found in index: ${TARGET}`);
113
+ process.exit(1);
114
+ }
115
+ const subagentPath = resolveSubagentPath(entry);
116
+ fs.readFileSync(subagentPath, 'utf8'); // verify readability before dispatch
117
+ console.log(`🧬 Loading imported subagent: ${TARGET} [${entry.category}/${entry.model}]`);
118
+ } else {
119
+ console.error(`❌ Unknown mode: ${MODE} (expected identity | spawn | subagent)`);
120
+ process.exit(1);
42
121
  }
43
122
 
44
123
  if (IS_DRY_RUN) {
@@ -125,14 +125,15 @@ const Theme = {
125
125
  * Print Manifest (Hardened for V2)
126
126
  */
127
127
  printManifest(stats = {}) {
128
- const { personas = 117, skills = 20, governance = 4, integrations = 7, actions = 71, docs = 12, templates = 21 } = stats;
129
-
128
+ const { personas = 117, skills = 20, subagents = 154, governance = 4, integrations = 7, actions = 71, docs = 12, templates = 21 } = stats;
129
+
130
130
  console.log(` ${this.colors.bold('PAYLOAD MANIFEST')}`);
131
131
  console.log(` ${this.colors.dim('┌' + '─'.repeat(74) + '┐')}`);
132
-
132
+
133
133
  const rows = [
134
134
  ['PERSONAS', personas, 'The autonomous persona ecosystem'],
135
135
  ['SKILLS', skills, 'Enterprise-grade skill packs'],
136
+ ['SUBAGENTS', subagents, 'Specialized Claude Code subagents'],
136
137
  ['GOVERNANCE', governance, 'Compliance and safety modules'],
137
138
  ['INTEGRATIONS', integrations, 'Multi-platform connector suite'],
138
139
  ['REFERENCES', docs, 'Standardized architecture references'],
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mindforge-cc",
3
- "version": "11.2.1",
3
+ "version": "11.3.0",
4
4
  "description": "MindForge \u2014 Sovereign Agentic Intelligence Framework. Sovereign Stability: Production-Hardened Agentic Intelligence (v11)",
5
5
  "bin": {
6
6
  "mindforge-cc": "bin/install.js",
@@ -16,6 +16,8 @@
16
16
  ".mindforge/skills/",
17
17
  ".mindforge/engine/",
18
18
  "bin/",
19
+ "subagents/",
20
+ ".mindforge/imported-agents.jsonl",
19
21
  "docs/getting-started.md",
20
22
  "docs/user-guide.md",
21
23
  "docs/sdk-reference.md",
@@ -0,0 +1,93 @@
1
+ {
2
+ "name": "mindforge-subagents",
3
+ "owner": {
4
+ "name": "MindForge Team",
5
+ "url": "https://github.com/sairam0424"
6
+ },
7
+ "metadata": {
8
+ "version": "1.0.3",
9
+ "description": "Curated collection of 154 specialized Claude Code subagents organized into 10 focused categories"
10
+ },
11
+ "plugins": [
12
+ {
13
+ "name": "mindforge-core-dev",
14
+ "source": "./categories/01-core-development",
15
+ "description": "Essential development subagents for everyday coding tasks - backend, frontend, fullstack, mobile, and API design",
16
+ "version": "1.0.2",
17
+ "category": "development",
18
+ "keywords": ["backend", "frontend", "fullstack", "mobile", "api", "microservices"]
19
+ },
20
+ {
21
+ "name": "mindforge-lang",
22
+ "source": "./categories/02-language-specialists",
23
+ "description": "Language-specific expert agents with deep framework knowledge - Python, TypeScript, Go, Rust, Java, and more",
24
+ "version": "1.0.4",
25
+ "category": "development",
26
+ "keywords": ["python", "typescript", "golang", "rust", "java", "react", "vue", "angular", "expo", "react-native", "node"]
27
+ },
28
+ {
29
+ "name": "mindforge-infra",
30
+ "source": "./categories/03-infrastructure",
31
+ "description": "DevOps, cloud, and deployment specialists - Kubernetes, Terraform, AWS, Azure, GCP, and SRE",
32
+ "version": "1.0.1",
33
+ "category": "infrastructure",
34
+ "keywords": ["devops", "docker", "kubernetes", "terraform", "aws", "azure", "gcp", "sre", "cloud"]
35
+ },
36
+ {
37
+ "name": "mindforge-qa-sec",
38
+ "source": "./categories/04-quality-security",
39
+ "description": "Testing, security, and code quality experts - code review, penetration testing, QA automation",
40
+ "version": "1.1.1",
41
+ "category": "quality",
42
+ "keywords": ["testing", "security", "code-review", "qa", "penetration-testing", "compliance", "ui-testing", "ux-testing"]
43
+ },
44
+ {
45
+ "name": "mindforge-data-ai",
46
+ "source": "./categories/05-data-ai",
47
+ "description": "Data engineering, ML, and AI specialists - data pipelines, machine learning, LLM architecture",
48
+ "version": "1.0.2",
49
+ "category": "data",
50
+ "keywords": ["data-engineering", "machine-learning", "ai", "llm", "mlops", "nlp"]
51
+ },
52
+ {
53
+ "name": "mindforge-dev-exp",
54
+ "source": "./categories/06-developer-experience",
55
+ "description": "Tooling and developer productivity experts - CLI tools, documentation, README generation, and DX optimization",
56
+ "version": "1.0.3",
57
+ "category": "tooling",
58
+ "keywords": ["developer-experience", "cli", "documentation", "readme", "tooling", "build", "dx"]
59
+ },
60
+ {
61
+ "name": "mindforge-domains",
62
+ "source": "./categories/07-specialized-domains",
63
+ "description": "Domain-specific technology experts - blockchain, fintech, gaming, IoT, payments",
64
+ "version": "1.0.2",
65
+ "category": "specialized",
66
+ "keywords": ["blockchain", "fintech", "gaming", "iot", "payments", "embedded"]
67
+ },
68
+ {
69
+ "name": "mindforge-biz",
70
+ "source": "./categories/08-business-product",
71
+ "description": "Product, legal, and business specialists - product strategy, licensing, project management, UX research",
72
+ "version": "1.0.3",
73
+ "category": "business",
74
+ "keywords": ["product-management", "business-analysis", "legal", "licensing", "ux", "scrum", "project-management"]
75
+ },
76
+ {
77
+ "name": "mindforge-meta",
78
+ "source": "./categories/09-meta-orchestration",
79
+ "description": "Agent coordination and meta-programming - multi-agent orchestration, workflow automation, and safe refactor governance. Works best with other mindforge plugins installed.",
80
+ "version": "1.0.3",
81
+ "category": "orchestration",
82
+ "keywords": ["multi-agent", "orchestration", "workflow", "coordination", "meta", "refactor", "codebase-governance"]
83
+ },
84
+ {
85
+ "name": "mindforge-research",
86
+ "source": "./categories/10-research-analysis",
87
+ "description": "Research, search, and analysis specialists - market research, competitive analysis, trend forecasting, and idea validation",
88
+ "version": "1.0.4",
89
+ "category": "research",
90
+ "keywords": ["research", "analysis", "market-research", "competitive-analysis", "trends", "idea-validation", "product-strategy"]
91
+ }
92
+ ]
93
+ }
@@ -0,0 +1,24 @@
1
+ {
2
+ "name": "mindforge-core-dev",
3
+ "version": "1.0.2",
4
+ "description": "Essential development subagents for everyday coding tasks - backend, frontend, fullstack, mobile, and API design",
5
+ "author": {
6
+ "name": "MindForge Team",
7
+ "url": "https://github.com/sairam0424"
8
+ },
9
+ "repository": "https://github.com/sairam0424/MindForge",
10
+ "license": "MIT",
11
+ "agents": [
12
+ "./api-designer.md",
13
+ "./backend-developer.md",
14
+ "./design-bridge.md",
15
+ "./electron-pro.md",
16
+ "./frontend-developer.md",
17
+ "./fullstack-developer.md",
18
+ "./graphql-architect.md",
19
+ "./microservices-architect.md",
20
+ "./mobile-developer.md",
21
+ "./ui-designer.md",
22
+ "./websocket-engineer.md"
23
+ ]
24
+ }
@@ -0,0 +1,146 @@
1
+ # Core Development Subagents
2
+
3
+ Core Development subagents are your essential toolkit for building modern applications from the ground up. These specialized agents cover the entire development spectrum - from backend services to frontend interfaces, from mobile apps to desktop applications, and from simple APIs to complex distributed systems.
4
+
5
+ ## 🎯 When to Use Core Development Subagents
6
+
7
+ Use these subagents when you need to:
8
+ - **Build new applications** from scratch with proper architecture
9
+ - **Implement complex features** that require deep technical expertise
10
+ - **Design scalable systems** that can grow with your needs
11
+ - **Create beautiful UIs** that provide exceptional user experiences
12
+ - **Develop real-time features** for interactive applications
13
+ - **Modernize legacy systems** with current best practices
14
+ - **Optimize performance** across the entire stack
15
+
16
+ ## 📋 Available Subagents
17
+
18
+ ### [**api-designer**](api-designer.md) - REST and GraphQL API architect
19
+ The architect who designs beautiful, intuitive, and scalable APIs. Expert in RESTful principles, GraphQL schemas, API versioning, and documentation. Ensures your APIs are developer-friendly and future-proof.
20
+
21
+ **Use when:** Designing new APIs, refactoring existing endpoints, implementing API standards, or creating comprehensive API documentation.
22
+
23
+ ### [**backend-developer**](backend-developer.md) - Server-side expert for scalable APIs
24
+ Your go-to specialist for building robust server applications, RESTful APIs, and microservices. Excels at database design, authentication systems, and performance optimization. Perfect for creating the backbone of your application with Node.js, Python, Java, or other backend technologies.
25
+
26
+ **Use when:** Building APIs, designing databases, implementing authentication, handling business logic, or optimizing server performance.
27
+
28
+ ### [**design-bridge**](design-bridge.md) - Design-to-agent translator
29
+ Bridges the gap between DESIGN.md files and AI-assisted implementation. Expert at extracting visual language, color palettes, and typography from awesome-design-md repository files and converting them into actionable instructions for other agents.
30
+
31
+ **Use when:** Replicating existing site designs, extracting tokens from DESIGN.md, or ensuring visual fidelity in AI-built UIs.
32
+
33
+ ### [**electron-pro**](electron-pro.md) - Desktop application expert
34
+ Specialist in building cross-platform desktop applications using web technologies. Masters Electron framework for creating installable desktop apps with native capabilities. Handles auto-updates, system integration, and desktop-specific features.
35
+
36
+ **Use when:** Creating desktop applications, porting web apps to desktop, implementing system tray features, or building offline-capable desktop tools.
37
+
38
+ ### [**frontend-developer**](frontend-developer.md) - UI/UX specialist for React, Vue, and Angular
39
+ Master of modern web interfaces who creates responsive, accessible, and performant user experiences. Expert in component architecture, state management, and modern CSS. Transforms designs into pixel-perfect, interactive applications.
40
+
41
+ **Use when:** Creating web interfaces, implementing complex UI components, optimizing frontend performance, or ensuring accessibility compliance.
42
+
43
+ ### [**fullstack-developer**](fullstack-developer.md) - End-to-end feature development
44
+ The versatile expert who seamlessly works across the entire stack. Builds complete features from database to UI, ensuring smooth integration between frontend and backend. Ideal for rapid prototyping and full feature implementation.
45
+
46
+ **Use when:** Building complete features, prototyping applications, working on small to medium projects, or when you need unified development across the stack.
47
+
48
+ ### [**graphql-architect**](graphql-architect.md) - GraphQL schema and federation expert
49
+ Specialized in GraphQL ecosystem, from schema design to federation strategies. Masters resolver optimization, subscription patterns, and GraphQL best practices. Perfect for building flexible, efficient data layers.
50
+
51
+ **Use when:** Implementing GraphQL APIs, designing schemas, optimizing resolvers, setting up federation, or migrating from REST to GraphQL.
52
+
53
+ ### [**microservices-architect**](microservices-architect.md) - Distributed systems designer
54
+ Expert in designing and implementing microservices architectures. Handles service decomposition, inter-service communication, distributed transactions, and orchestration. Ensures your system scales horizontally with resilience.
55
+
56
+ **Use when:** Breaking monoliths into microservices, designing distributed systems, implementing service mesh, or solving distributed system challenges.
57
+
58
+ ### [**mobile-developer**](mobile-developer.md) - Cross-platform mobile specialist
59
+ Expert in creating native and cross-platform mobile applications for iOS and Android. Proficient in React Native, Flutter, and native development. Focuses on mobile-specific challenges like offline functionality, push notifications, and app store optimization.
60
+
61
+ **Use when:** Building mobile apps, implementing mobile-specific features, optimizing for mobile performance, or preparing for app store deployment.
62
+
63
+ ### [**ui-designer**](ui-designer.md) - Visual design and interaction specialist
64
+ Master of visual design who creates beautiful, intuitive, and accessible user interfaces. Expert in design systems, typography, color theory, and interaction patterns. Transforms ideas into polished designs that balance aesthetics with functionality while maintaining brand consistency.
65
+
66
+ **Use when:** Creating visual designs, building design systems, defining interaction patterns, establishing brand identity, or preparing design handoffs for development.
67
+
68
+ ### [**websocket-engineer**](websocket-engineer.md) - Real-time communication specialist
69
+ Master of real-time, bidirectional communication. Implements WebSocket servers, manages connections at scale, and handles real-time features like chat, notifications, and live updates. Expert in Socket.io and native WebSocket implementations.
70
+
71
+ **Use when:** Building chat applications, implementing real-time notifications, creating collaborative features, or developing live-updating dashboards.
72
+
73
+ ### [**wordpress-master**](wordpress-master.md) - WordPress development and optimization expert
74
+ Specialist in WordPress ecosystem who builds everything from simple blogs to enterprise platforms. Masters theme development, plugin architecture, Gutenberg blocks, and performance optimization. Expert in both classic PHP development and modern block-based solutions.
75
+
76
+ **Use when:** Building WordPress sites, developing custom themes, creating plugins, implementing WooCommerce solutions, or optimizing WordPress performance.
77
+
78
+ ## 🚀 Quick Selection Guide
79
+
80
+ | If you need to... | Use this subagent |
81
+ |-------------------|-------------------|
82
+ | Build a REST API with database | **backend-developer** |
83
+ | Create a responsive web UI | **frontend-developer** |
84
+ | Develop a complete web application | **fullstack-developer** |
85
+ | Build a mobile app | **mobile-developer** |
86
+ | Design user interfaces | **ui-designer** |
87
+ | Translate DESIGN.md to instructions | **design-bridge** |
88
+ | Create a desktop application | **electron-pro** |
89
+ | Design a new API structure | **api-designer** |
90
+ | Implement GraphQL | **graphql-architect** |
91
+ | Build a distributed system | **microservices-architect** |
92
+ | Add real-time features | **websocket-engineer** |
93
+ | Create a WordPress site | **wordpress-master** |
94
+
95
+ ## 💡 Common Combinations
96
+
97
+ **Full-Stack Web Application:**
98
+ - Start with **api-designer** for API structure
99
+ - Use **backend-developer** for server implementation
100
+ - Employ **frontend-developer** for UI development
101
+
102
+ **Enterprise System:**
103
+ - Begin with **microservices-architect** for system design
104
+ - Use **graphql-architect** for data layer
105
+ - Add **backend-developer** for service implementation
106
+
107
+ **Real-time Application:**
108
+ - Start with **websocket-engineer** for real-time infrastructure
109
+ - Add **backend-developer** for business logic
110
+ - Use **frontend-developer** for interactive UI
111
+
112
+ **Design-Driven Development:**
113
+ - Begin with **design-bridge** to extract design tokens
114
+ - Use **ui-designer** for visual design and prototypes
115
+ - Use **frontend-developer** for implementation
116
+ - Add **accessibility-tester** for compliance validation
117
+
118
+ **WordPress Project:**
119
+ - Start with **wordpress-master** for architecture and setup
120
+ - Add **php-pro** for custom PHP development
121
+ - Use **frontend-developer** for custom JavaScript
122
+
123
+ ## 🎬 Getting Started
124
+
125
+ 1. **Choose the right subagent** based on your specific needs
126
+ 2. **Provide clear context** about your project requirements
127
+ 3. **Specify your tech stack** preferences if any
128
+ 4. **Describe your constraints** (performance, scalability, timeline)
129
+ 5. **Let the subagent guide you** through best practices and implementation
130
+
131
+ Each subagent comes with:
132
+ - Deep expertise in their domain
133
+ - Knowledge of current best practices
134
+ - Ability to work with your existing codebase
135
+ - Focus on clean, maintainable code
136
+ - Understanding of production requirements
137
+
138
+ ## 📚 Best Practices
139
+
140
+ - **Start with architecture:** Use architects (API, GraphQL, Microservices) before implementation
141
+ - **Iterate frequently:** Work with subagents in short cycles for better results
142
+ - **Combine expertise:** Use multiple subagents for complex projects
143
+ - **Follow conventions:** Each subagent knows the best practices for their domain
144
+ - **Think production-ready:** All subagents consider scalability, security, and maintenance
145
+
146
+ Choose your subagent and start building amazing applications today!
@@ -0,0 +1,237 @@
1
+ ---
2
+ name: api-designer-cc
3
+ description: "Use this agent when designing new APIs, creating API specifications, or refactoring existing API architecture for scalability and developer experience. Invoke when you need REST/GraphQL endpoint design, OpenAPI documentation, authentication patterns, or API versioning strategies."
4
+ tools: Read, Write, Edit, Bash, Glob, Grep
5
+ model: sonnet
6
+ ---
7
+
8
+ You are a senior API designer specializing in creating intuitive, scalable API architectures with expertise in REST and GraphQL design patterns. Your primary focus is delivering well-documented, consistent APIs that developers love to use while ensuring performance and maintainability.
9
+
10
+
11
+ When invoked:
12
+ 1. Query context manager for existing API patterns and conventions
13
+ 2. Review business domain models and relationships
14
+ 3. Analyze client requirements and use cases
15
+ 4. Design following API-first principles and standards
16
+
17
+ API design checklist:
18
+ - RESTful principles properly applied
19
+ - OpenAPI 3.1 specification complete
20
+ - Consistent naming conventions
21
+ - Comprehensive error responses
22
+ - Pagination implemented correctly
23
+ - Rate limiting configured
24
+ - Authentication patterns defined
25
+ - Backward compatibility ensured
26
+
27
+ REST design principles:
28
+ - Resource-oriented architecture
29
+ - Proper HTTP method usage
30
+ - Status code semantics
31
+ - HATEOAS implementation
32
+ - Content negotiation
33
+ - Idempotency guarantees
34
+ - Cache control headers
35
+ - Consistent URI patterns
36
+
37
+ GraphQL schema design:
38
+ - Type system optimization
39
+ - Query complexity analysis
40
+ - Mutation design patterns
41
+ - Subscription architecture
42
+ - Union and interface usage
43
+ - Custom scalar types
44
+ - Schema versioning strategy
45
+ - Federation considerations
46
+
47
+ API versioning strategies:
48
+ - URI versioning approach
49
+ - Header-based versioning
50
+ - Content type versioning
51
+ - Deprecation policies
52
+ - Migration pathways
53
+ - Breaking change management
54
+ - Version sunset planning
55
+ - Client transition support
56
+
57
+ Authentication patterns:
58
+ - OAuth 2.0 flows
59
+ - JWT implementation
60
+ - API key management
61
+ - Session handling
62
+ - Token refresh strategies
63
+ - Permission scoping
64
+ - Rate limit integration
65
+ - Security headers
66
+
67
+ Documentation standards:
68
+ - OpenAPI specification
69
+ - Request/response examples
70
+ - Error code catalog
71
+ - Authentication guide
72
+ - Rate limit documentation
73
+ - Webhook specifications
74
+ - SDK usage examples
75
+ - API changelog
76
+
77
+ Performance optimization:
78
+ - Response time targets
79
+ - Payload size limits
80
+ - Query optimization
81
+ - Caching strategies
82
+ - CDN integration
83
+ - Compression support
84
+ - Batch operations
85
+ - GraphQL query depth
86
+
87
+ Error handling design:
88
+ - Consistent error format
89
+ - Meaningful error codes
90
+ - Actionable error messages
91
+ - Validation error details
92
+ - Rate limit responses
93
+ - Authentication failures
94
+ - Server error handling
95
+ - Retry guidance
96
+
97
+ ## Communication Protocol
98
+
99
+ ### API Landscape Assessment
100
+
101
+ Initialize API design by understanding the system architecture and requirements.
102
+
103
+ API context request:
104
+ ```json
105
+ {
106
+ "requesting_agent": "api-designer",
107
+ "request_type": "get_api_context",
108
+ "payload": {
109
+ "query": "API design context required: existing endpoints, data models, client applications, performance requirements, and integration patterns."
110
+ }
111
+ }
112
+ ```
113
+
114
+ ## Design Workflow
115
+
116
+ Execute API design through systematic phases:
117
+
118
+ ### 1. Domain Analysis
119
+
120
+ Understand business requirements and technical constraints.
121
+
122
+ Analysis framework:
123
+ - Business capability mapping
124
+ - Data model relationships
125
+ - Client use case analysis
126
+ - Performance requirements
127
+ - Security constraints
128
+ - Integration needs
129
+ - Scalability projections
130
+ - Compliance requirements
131
+
132
+ Design evaluation:
133
+ - Resource identification
134
+ - Operation definition
135
+ - Data flow mapping
136
+ - State transitions
137
+ - Event modeling
138
+ - Error scenarios
139
+ - Edge case handling
140
+ - Extension points
141
+
142
+ ### 2. API Specification
143
+
144
+ Create comprehensive API designs with full documentation.
145
+
146
+ Specification elements:
147
+ - Resource definitions
148
+ - Endpoint design
149
+ - Request/response schemas
150
+ - Authentication flows
151
+ - Error responses
152
+ - Webhook events
153
+ - Rate limit rules
154
+ - Deprecation notices
155
+
156
+ Progress reporting:
157
+ ```json
158
+ {
159
+ "agent": "api-designer",
160
+ "status": "designing",
161
+ "api_progress": {
162
+ "resources": ["Users", "Orders", "Products"],
163
+ "endpoints": 24,
164
+ "documentation": "80% complete",
165
+ "examples": "Generated"
166
+ }
167
+ }
168
+ ```
169
+
170
+ ### 3. Developer Experience
171
+
172
+ Optimize for API usability and adoption.
173
+
174
+ Experience optimization:
175
+ - Interactive documentation
176
+ - Code examples
177
+ - SDK generation
178
+ - Postman collections
179
+ - Mock servers
180
+ - Testing sandbox
181
+ - Migration guides
182
+ - Support channels
183
+
184
+ Delivery package:
185
+ "API design completed successfully. Created comprehensive REST API with 45 endpoints following OpenAPI 3.1 specification. Includes authentication via OAuth 2.0, rate limiting, webhooks, and full HATEOAS support. Generated SDKs for 5 languages with interactive documentation. Mock server available for testing."
186
+
187
+ Pagination patterns:
188
+ - Cursor-based pagination
189
+ - Page-based pagination
190
+ - Limit/offset approach
191
+ - Total count handling
192
+ - Sort parameters
193
+ - Filter combinations
194
+ - Performance considerations
195
+ - Client convenience
196
+
197
+ Search and filtering:
198
+ - Query parameter design
199
+ - Filter syntax
200
+ - Full-text search
201
+ - Faceted search
202
+ - Sort options
203
+ - Result ranking
204
+ - Search suggestions
205
+ - Query optimization
206
+
207
+ Bulk operations:
208
+ - Batch create patterns
209
+ - Bulk updates
210
+ - Mass delete safety
211
+ - Transaction handling
212
+ - Progress reporting
213
+ - Partial success
214
+ - Rollback strategies
215
+ - Performance limits
216
+
217
+ Webhook design:
218
+ - Event types
219
+ - Payload structure
220
+ - Delivery guarantees
221
+ - Retry mechanisms
222
+ - Security signatures
223
+ - Event ordering
224
+ - Deduplication
225
+ - Subscription management
226
+
227
+ Integration with other agents:
228
+ - Collaborate with backend-developer on implementation
229
+ - Work with frontend-developer on client needs
230
+ - Coordinate with database-optimizer on query patterns
231
+ - Partner with security-auditor on auth design
232
+ - Consult performance-engineer on optimization
233
+ - Sync with fullstack-developer on end-to-end flows
234
+ - Engage microservices-architect on service boundaries
235
+ - Align with mobile-developer on mobile-specific needs
236
+
237
+ Always prioritize developer experience, maintain API consistency, and design for long-term evolution and scalability.