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.
- package/.mindforge/config.json +2 -2
- package/.mindforge/imported-agents.jsonl +154 -0
- package/CHANGELOG.md +43 -0
- package/MINDFORGE.md +3 -3
- package/README.md +1 -1
- package/bin/installer-core.js +95 -1
- package/bin/spawn-agent.js +80 -1
- package/bin/wizard/theme.js +4 -3
- package/package.json +3 -1
- package/subagents/.claude-plugin/marketplace.json +93 -0
- package/subagents/categories/01-core-development/.claude-plugin/plugin.json +24 -0
- package/subagents/categories/01-core-development/README.md +146 -0
- package/subagents/categories/01-core-development/api-designer-cc.md +237 -0
- package/subagents/categories/01-core-development/backend-developer.md +222 -0
- package/subagents/categories/01-core-development/design-bridge.md +129 -0
- package/subagents/categories/01-core-development/electron-pro.md +240 -0
- package/subagents/categories/01-core-development/frontend-developer.md +133 -0
- package/subagents/categories/01-core-development/fullstack-developer.md +235 -0
- package/subagents/categories/01-core-development/graphql-architect.md +238 -0
- package/subagents/categories/01-core-development/microservices-architect.md +239 -0
- package/subagents/categories/01-core-development/mobile-developer.md +283 -0
- package/subagents/categories/01-core-development/ui-designer.md +174 -0
- package/subagents/categories/01-core-development/websocket-engineer.md +150 -0
- package/subagents/categories/02-language-specialists/.claude-plugin/plugin.json +43 -0
- package/subagents/categories/02-language-specialists/README.md +245 -0
- package/subagents/categories/02-language-specialists/angular-architect.md +287 -0
- package/subagents/categories/02-language-specialists/cpp-pro.md +277 -0
- package/subagents/categories/02-language-specialists/csharp-developer.md +287 -0
- package/subagents/categories/02-language-specialists/django-developer.md +287 -0
- package/subagents/categories/02-language-specialists/dotnet-core-expert.md +287 -0
- package/subagents/categories/02-language-specialists/dotnet-framework-48-expert.md +306 -0
- package/subagents/categories/02-language-specialists/elixir-expert.md +311 -0
- package/subagents/categories/02-language-specialists/expo-react-native-expert.md +268 -0
- package/subagents/categories/02-language-specialists/fastapi-developer.md +287 -0
- package/subagents/categories/02-language-specialists/flutter-expert.md +287 -0
- package/subagents/categories/02-language-specialists/golang-pro.md +277 -0
- package/subagents/categories/02-language-specialists/java-architect.md +287 -0
- package/subagents/categories/02-language-specialists/javascript-pro.md +277 -0
- package/subagents/categories/02-language-specialists/kotlin-specialist.md +287 -0
- package/subagents/categories/02-language-specialists/laravel-specialist.md +287 -0
- package/subagents/categories/02-language-specialists/nextjs-developer.md +287 -0
- package/subagents/categories/02-language-specialists/node-specialist.md +124 -0
- package/subagents/categories/02-language-specialists/php-pro.md +287 -0
- package/subagents/categories/02-language-specialists/powershell-51-expert.md +59 -0
- package/subagents/categories/02-language-specialists/powershell-7-expert.md +57 -0
- package/subagents/categories/02-language-specialists/python-pro.md +277 -0
- package/subagents/categories/02-language-specialists/rails-expert.md +358 -0
- package/subagents/categories/02-language-specialists/react-specialist-cc.md +287 -0
- package/subagents/categories/02-language-specialists/rust-engineer.md +287 -0
- package/subagents/categories/02-language-specialists/spring-boot-engineer.md +287 -0
- package/subagents/categories/02-language-specialists/sql-pro.md +287 -0
- package/subagents/categories/02-language-specialists/swift-expert.md +287 -0
- package/subagents/categories/02-language-specialists/symfony-specialist.md +354 -0
- package/subagents/categories/02-language-specialists/typescript-pro.md +277 -0
- package/subagents/categories/02-language-specialists/vue-expert.md +287 -0
- package/subagents/categories/03-infrastructure/.claude-plugin/plugin.json +29 -0
- package/subagents/categories/03-infrastructure/README.md +170 -0
- package/subagents/categories/03-infrastructure/azure-infra-engineer.md +53 -0
- package/subagents/categories/03-infrastructure/cloud-architect-cc.md +277 -0
- package/subagents/categories/03-infrastructure/database-administrator.md +287 -0
- package/subagents/categories/03-infrastructure/deployment-engineer.md +287 -0
- package/subagents/categories/03-infrastructure/devops-engineer-cc.md +287 -0
- package/subagents/categories/03-infrastructure/devops-incident-responder.md +287 -0
- package/subagents/categories/03-infrastructure/docker-expert.md +278 -0
- package/subagents/categories/03-infrastructure/incident-responder.md +287 -0
- package/subagents/categories/03-infrastructure/kubernetes-specialist.md +287 -0
- package/subagents/categories/03-infrastructure/network-engineer.md +287 -0
- package/subagents/categories/03-infrastructure/platform-engineer-cc.md +287 -0
- package/subagents/categories/03-infrastructure/security-engineer.md +277 -0
- package/subagents/categories/03-infrastructure/sre-engineer.md +287 -0
- package/subagents/categories/03-infrastructure/terraform-engineer.md +287 -0
- package/subagents/categories/03-infrastructure/terragrunt-expert.md +307 -0
- package/subagents/categories/03-infrastructure/windows-infra-admin.md +52 -0
- package/subagents/categories/04-quality-security/.claude-plugin/plugin.json +30 -0
- package/subagents/categories/04-quality-security/README.md +175 -0
- package/subagents/categories/04-quality-security/accessibility-tester-cc.md +277 -0
- package/subagents/categories/04-quality-security/ad-security-reviewer.md +56 -0
- package/subagents/categories/04-quality-security/ai-writing-auditor.md +77 -0
- package/subagents/categories/04-quality-security/architect-reviewer.md +287 -0
- package/subagents/categories/04-quality-security/chaos-engineer-cc.md +277 -0
- package/subagents/categories/04-quality-security/code-reviewer.md +287 -0
- package/subagents/categories/04-quality-security/compliance-auditor-cc.md +277 -0
- package/subagents/categories/04-quality-security/debugger-cc.md +287 -0
- package/subagents/categories/04-quality-security/error-detective.md +287 -0
- package/subagents/categories/04-quality-security/gdpr-ccpa-compliance.md +98 -0
- package/subagents/categories/04-quality-security/penetration-tester.md +287 -0
- package/subagents/categories/04-quality-security/performance-engineer.md +287 -0
- package/subagents/categories/04-quality-security/powershell-security-hardening.md +54 -0
- package/subagents/categories/04-quality-security/qa-expert.md +287 -0
- package/subagents/categories/04-quality-security/security-auditor.md +287 -0
- package/subagents/categories/04-quality-security/test-automator.md +287 -0
- package/subagents/categories/04-quality-security/ui-ux-tester.md +234 -0
- package/subagents/categories/05-data-ai/.claude-plugin/plugin.json +26 -0
- package/subagents/categories/05-data-ai/README.md +153 -0
- package/subagents/categories/05-data-ai/ai-engineer.md +287 -0
- package/subagents/categories/05-data-ai/data-analyst.md +277 -0
- package/subagents/categories/05-data-ai/data-engineer-cc.md +287 -0
- package/subagents/categories/05-data-ai/data-scientist.md +287 -0
- package/subagents/categories/05-data-ai/database-optimizer.md +287 -0
- package/subagents/categories/05-data-ai/llm-architect.md +287 -0
- package/subagents/categories/05-data-ai/machine-learning-engineer.md +277 -0
- package/subagents/categories/05-data-ai/ml-engineer-cc.md +287 -0
- package/subagents/categories/05-data-ai/mlops-engineer.md +287 -0
- package/subagents/categories/05-data-ai/nlp-engineer.md +287 -0
- package/subagents/categories/05-data-ai/postgres-pro.md +287 -0
- package/subagents/categories/05-data-ai/prompt-engineer-cc.md +287 -0
- package/subagents/categories/05-data-ai/reinforcement-learning-engineer.md +277 -0
- package/subagents/categories/06-developer-experience/.claude-plugin/plugin.json +28 -0
- package/subagents/categories/06-developer-experience/README.md +157 -0
- package/subagents/categories/06-developer-experience/build-engineer-cc.md +286 -0
- package/subagents/categories/06-developer-experience/cli-developer.md +286 -0
- package/subagents/categories/06-developer-experience/dependency-manager.md +286 -0
- package/subagents/categories/06-developer-experience/documentation-engineer.md +276 -0
- package/subagents/categories/06-developer-experience/dx-optimizer.md +286 -0
- package/subagents/categories/06-developer-experience/git-workflow-manager.md +286 -0
- package/subagents/categories/06-developer-experience/legacy-modernizer.md +286 -0
- package/subagents/categories/06-developer-experience/mcp-developer.md +275 -0
- package/subagents/categories/06-developer-experience/powershell-module-architect.md +58 -0
- package/subagents/categories/06-developer-experience/powershell-ui-architect.md +135 -0
- package/subagents/categories/06-developer-experience/readme-generator.md +238 -0
- package/subagents/categories/06-developer-experience/refactoring-specialist.md +286 -0
- package/subagents/categories/06-developer-experience/slack-expert.md +232 -0
- package/subagents/categories/06-developer-experience/tooling-engineer.md +286 -0
- package/subagents/categories/06-developer-experience/visual-asset-generator.md +34 -0
- package/subagents/categories/07-specialized-domains/.claude-plugin/plugin.json +27 -0
- package/subagents/categories/07-specialized-domains/README.md +161 -0
- package/subagents/categories/07-specialized-domains/api-documenter.md +277 -0
- package/subagents/categories/07-specialized-domains/blockchain-developer.md +287 -0
- package/subagents/categories/07-specialized-domains/embedded-systems.md +287 -0
- package/subagents/categories/07-specialized-domains/fintech-engineer.md +287 -0
- package/subagents/categories/07-specialized-domains/game-developer.md +287 -0
- package/subagents/categories/07-specialized-domains/healthcare-admin.md +199 -0
- package/subagents/categories/07-specialized-domains/hipaa-compliance.md +112 -0
- package/subagents/categories/07-specialized-domains/iot-engineer.md +287 -0
- package/subagents/categories/07-specialized-domains/m365-admin.md +48 -0
- package/subagents/categories/07-specialized-domains/mobile-app-developer.md +287 -0
- package/subagents/categories/07-specialized-domains/payment-integration.md +287 -0
- package/subagents/categories/07-specialized-domains/quant-analyst.md +287 -0
- package/subagents/categories/07-specialized-domains/risk-manager.md +287 -0
- package/subagents/categories/07-specialized-domains/seo-specialist-cc.md +184 -0
- package/subagents/categories/08-business-product/.claude-plugin/plugin.json +29 -0
- package/subagents/categories/08-business-product/README.md +160 -0
- package/subagents/categories/08-business-product/assumption-mapping.md +77 -0
- package/subagents/categories/08-business-product/backlog-grooming.md +88 -0
- package/subagents/categories/08-business-product/business-analyst-cc.md +287 -0
- package/subagents/categories/08-business-product/content-marketer.md +287 -0
- package/subagents/categories/08-business-product/content-quality-editor.md +55 -0
- package/subagents/categories/08-business-product/customer-success-manager.md +287 -0
- package/subagents/categories/08-business-product/growth-loops.md +91 -0
- package/subagents/categories/08-business-product/legal-advisor.md +287 -0
- package/subagents/categories/08-business-product/license-engineer.md +295 -0
- package/subagents/categories/08-business-product/product-manager-cc.md +287 -0
- package/subagents/categories/08-business-product/project-manager.md +287 -0
- package/subagents/categories/08-business-product/sales-engineer.md +287 -0
- package/subagents/categories/08-business-product/scrum-master.md +287 -0
- package/subagents/categories/08-business-product/technical-writer.md +287 -0
- package/subagents/categories/08-business-product/ux-researcher.md +287 -0
- package/subagents/categories/08-business-product/wordpress-master.md +316 -0
- package/subagents/categories/09-meta-orchestration/.claude-plugin/plugin.json +24 -0
- package/subagents/categories/09-meta-orchestration/README.md +140 -0
- package/subagents/categories/09-meta-orchestration/agent-installer.md +97 -0
- package/subagents/categories/09-meta-orchestration/agent-organizer.md +287 -0
- package/subagents/categories/09-meta-orchestration/codebase-orchestrator.md +249 -0
- package/subagents/categories/09-meta-orchestration/context-manager.md +287 -0
- package/subagents/categories/09-meta-orchestration/error-coordinator.md +287 -0
- package/subagents/categories/09-meta-orchestration/it-ops-orchestrator.md +60 -0
- package/subagents/categories/09-meta-orchestration/knowledge-synthesizer.md +287 -0
- package/subagents/categories/09-meta-orchestration/multi-agent-coordinator.md +287 -0
- package/subagents/categories/09-meta-orchestration/performance-monitor.md +287 -0
- package/subagents/categories/09-meta-orchestration/task-distributor.md +287 -0
- package/subagents/categories/09-meta-orchestration/workflow-orchestrator.md +287 -0
- package/subagents/categories/10-research-analysis/.claude-plugin/plugin.json +24 -0
- package/subagents/categories/10-research-analysis/README.md +141 -0
- package/subagents/categories/10-research-analysis/ab-test-analysis.md +101 -0
- package/subagents/categories/10-research-analysis/cohort-analysis.md +100 -0
- package/subagents/categories/10-research-analysis/competitive-analyst.md +287 -0
- package/subagents/categories/10-research-analysis/data-researcher.md +287 -0
- package/subagents/categories/10-research-analysis/first-principles-thinking.md +100 -0
- package/subagents/categories/10-research-analysis/market-researcher.md +287 -0
- package/subagents/categories/10-research-analysis/project-idea-validator.md +269 -0
- package/subagents/categories/10-research-analysis/research-analyst.md +287 -0
- package/subagents/categories/10-research-analysis/scientific-literature-researcher.md +151 -0
- package/subagents/categories/10-research-analysis/search-specialist.md +287 -0
- package/subagents/categories/10-research-analysis/trend-analyst.md +287 -0
- package/subagents/tools/subagent-catalog/README.md +58 -0
- package/subagents/tools/subagent-catalog/config.sh +94 -0
- package/subagents/tools/subagent-catalog/fetch.md +82 -0
- package/subagents/tools/subagent-catalog/invalidate.md +47 -0
- package/subagents/tools/subagent-catalog/list.md +54 -0
- package/subagents/tools/subagent-catalog/search.md +58 -0
package/bin/spawn-agent.js
CHANGED
|
@@ -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 '
|
|
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) {
|
package/bin/wizard/theme.js
CHANGED
|
@@ -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.
|
|
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.
|