mcp-ai-agent-guidelines 0.1.0

package/dist/tools/model-compatibility-checker.js

@@ -0,0 +1,204 @@
+import { z } from "zod";
+import { BUDGET_ADJUSTMENTS, BUDGET_BONUS, BUDGET_PENALTY, CAPABILITY_WEIGHTS, MODELS, REQUIREMENT_KEYWORDS, } from "./config/model-config.js";
+const ModelCompatibilitySchema = z.object({
+    taskDescription: z.string(),
+    requirements: z.array(z.string()).optional(),
+    budget: z.enum(["low", "medium", "high"]).optional(),
+    // Optional additions
+    language: z.string().optional(), // for example snippets (e.g., 'typescript', 'python')
+    includeReferences: z.boolean().optional().default(true),
+    includeCodeExamples: z.boolean().optional().default(true),
+    linkFiles: z.boolean().optional().default(true),
+    includeMetadata: z.boolean().optional().default(true),
+    inputFile: z.string().optional(),
+});
+export async function modelCompatibilityChecker(args) {
+    const input = ModelCompatibilitySchema.parse(args);
+    const analysis = analyzeModelCompatibility(input);
+    const codeExamples = input.includeCodeExamples
+        ? buildCodeExamples(input.language)
+        : undefined;
+    const fileLinks = input.linkFiles ? buildFileLinks() : undefined;
+    const metadata = input.includeMetadata
+        ? [
+            "### Metadata",
+            `- Updated: ${new Date().toISOString().slice(0, 10)}`,
+            "- Source tool: mcp_ai-agent-guid_model-compatibility-checker",
+            input.inputFile ? `- Input file: ${input.inputFile}` : undefined,
+            "",
+        ]
+            .filter(Boolean)
+            .join("\n")
+        : "";
+    return {
+        content: [
+            {
+                type: "text",
+                text: `## 🤖 AI Model Compatibility Analysis (Qualitative)
+
+${metadata}
+
+### Task Analysis
+**Description**: ${input.taskDescription}
+**Requirements**: ${input.requirements?.join(", ") || "None specified"}
+**Budget**: ${input.budget || "Not specified"}
+
+
+### Top Recommendations (Qualitative)
+
+${analysis.recommendations
+                    .slice(0, 3)
+                    .map((model, index) => `#### ${index + 1}. ${model.name} (${model.provider})
+**Fit Summary**: ${model.strengths[0] || "General purpose"}
+**Context Handling**: ${model.contextWindow} (refer to provider docs)
+**Notes**: ${model.limitations[0] || "No major caveats documented"}
+
+**Highlights**:
+${model.specialFeatures.map((f) => `- ${f}`).join("\n")}
+`)
+                    .join("\n")}
+
+### Selection Snapshot
+
+| Model | Provider | Best For |
+|-------|----------|----------|
+${analysis.recommendations
+                    .map((model) => `| ${model.name} | ${model.provider} | ${model.strengths[0] || "General use"} |`)
+                    .join("\n")}
+
+### Selection Guidelines
+
+**For Code Generation**: Choose models with strong reasoning capabilities and code-specific training
+**For Analysis Tasks**: Prioritize models with large context windows and analytical strength
+**For Creative Tasks**: Select models optimized for creative writing and diverse outputs
+**For Production Use**: Consider latency, cost, and reliability alongside capability
+
+### Usage Optimization Tips
+1. **Start with smaller models** for prototyping and testing
+2. **Use prompt caching** for repeated system messages
+3. **Implement model switching** based on task complexity
+4. **Monitor token usage** and optimize prompts for efficiency
+5. **Consider fine-tuning** for specialized, high-volume use cases
+
+### Evaluation Method
+Heuristic fit against requirement keywords; qualitative only. Validate with quick benchmarks in your stack.
+
+### Rolling Model Updates
+- Config-driven list (context windows, tiers, capabilities) periodically refreshed
+- Capability weights & budget adjustments may evolve
+
+${codeExamples ? `### Code Examples\n${codeExamples}\n` : ""}
+${fileLinks ? `### Configuration & Files\n${fileLinks}\n` : ""}
+### References
+- GitHub Copilot model comparison (task-based): https://docs.github.com/en/copilot/reference/ai-models/model-comparison#recommended-models-by-task
+- OpenAI models overview: https://platform.openai.com/docs/models
+- Anthropic Claude models: https://docs.anthropic.com/en/docs/about-claude/models
+- Google Gemini models: https://ai.google.dev/gemini-api/docs/models
+
+### Disclaimer
+- This tool provides qualitative recommendations and links to official docs.
+- Capabilities evolve; verify with provider docs and test in your environment before adoption.
+`,
+            },
+        ],
+    };
+}
+function analyzeModelCompatibility(input) {
+    const text = [input.taskDescription, ...(input.requirements || [])]
+        .join(" ")
+        .toLowerCase();
+    const matchedCaps = new Set();
+    for (const [cap, words] of Object.entries(REQUIREMENT_KEYWORDS)) {
+        if (words.some((w) => text.includes(w)))
+            matchedCaps.add(cap);
+    }
+    const budgetAdj = input.budget ? BUDGET_ADJUSTMENTS[input.budget] : undefined;
+    const scored = MODELS.map((m) => {
+        let score = m.baseScore;
+        const breakdown = [`Base: ${m.baseScore}`];
+        for (const cap of matchedCaps) {
+            if (m.capabilities.includes(cap)) {
+                const add = CAPABILITY_WEIGHTS[cap] || 0;
+                score += add;
+                breakdown.push(`+${add} ${cap}`);
+            }
+        }
+        if (budgetAdj && input.budget) {
+            if (budgetAdj.bonus.includes(m.pricingTier)) {
+                score += BUDGET_BONUS;
+                breakdown.push(`+${BUDGET_BONUS} budget alignment (${input.budget})`);
+            }
+            if (budgetAdj.penalty.includes(m.pricingTier)) {
+                score -= BUDGET_PENALTY;
+                breakdown.push(`-${BUDGET_PENALTY} budget penalty (${m.pricingTier})`);
+            }
+        }
+        score = Math.max(0, Math.min(100, score));
+        return {
+            name: m.name,
+            provider: m.provider,
+            pricing: m.pricing,
+            contextWindow: `${Intl.NumberFormat().format(m.contextTokens)} tokens`,
+            strengths: m.strengths,
+            limitations: m.limitations,
+            specialFeatures: m.specialFeatures,
+            score,
+            breakdown,
+        };
+    });
+    return { recommendations: scored.sort((a, b) => b.score - a.score) };
+}
+// references moved inline in output for simplicity and always-on links
+function buildCodeExamples(language) {
+    const lang = (language || "typescript").toLowerCase();
+    if (lang.includes("python")) {
+        return [
+            "#### Python (pseudo-usage)",
+            "```python",
+            "# Example: switch model by task complexity",
+            "def pick_model(task_complexity: str):",
+            "    if task_complexity in ('simple', 'low-latency'):",
+            "        return 'o4-mini'  # budget/fast\n",
+            "    if task_complexity in ('large-context', 'long-docs'):",
+            "        return 'gemini-2.5-pro'  # 2M context\n",
+            "    return 'claude-4-sonnet'  # balanced default\n",
+            "",
+            "model = pick_model('large-context')",
+            "# Call provider SDK accordingly (pseudo):",
+            "# openai.chat.completions.create(model=model, messages=...)",
+            "# anthropic.messages.create(model=model, messages=...)",
+            "# genai.GenerativeModel(model).generate_content(...)",
+            "```",
+        ].join("\n");
+    }
+    // default TypeScript/JavaScript
+    return [
+        "#### TypeScript (pattern)",
+        "```ts",
+        "type Provider = 'openai' | 'anthropic' | 'google';",
+        "interface Choice { provider: Provider; model: string }",
+        "export function pickModel(opts: { complexity?: 'simple'|'balanced'|'advanced'; largeContext?: boolean; multimodal?: boolean; budget?: 'low'|'medium'|'high'; }): Choice {",
+        "  if (opts.largeContext) return { provider: 'google', model: 'gemini-2.5-pro' };",
+        "  if (opts.complexity === 'advanced') return { provider: 'anthropic', model: 'claude-4-opus' };",
+        "  if (opts.complexity === 'simple' || opts.budget === 'low') return { provider: 'openai', model: 'o4-mini' };",
+        "  return { provider: 'anthropic', model: 'claude-4-sonnet' };",
+        "}",
+        "",
+        "// Example usage (pseudo—replace with real SDK calls):",
+        "const choice = pickModel({ largeContext: true });",
+        "switch (choice.provider) {",
+        "  case 'openai': /* openai.chat.completions.create({ model: choice.model, messages }) */ break;",
+        "  case 'anthropic': /* anthropic.messages.create({ model: choice.model, messages }) */ break;",
+        "  case 'google': /* new GenerativeModel({ model: choice.model }).generateContent(...) */ break;",
+        "}",
+        "```",
+    ].join("\n");
+}
+function buildFileLinks() {
+    return [
+        "- Update model profiles in: src/tools/config/model-config.ts",
+        "- See selection guidance resource: guidelines://model-selection",
+        "- Server tool exposing this analysis: src/tools/model-compatibility-checker.ts",
+    ].join("\n");
+}
+//# sourceMappingURL=model-compatibility-checker.js.map

package/dist/tools/model-compatibility-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-compatibility-checker.js","sourceRoot":"","sources":["../../src/tools/model-compatibility-checker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACN,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,MAAM,EACN,oBAAoB,GAEpB,MAAM,0BAA0B,CAAC;AAElC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,qBAAqB;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,sDAAsD;IACvF,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACvD,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAMH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAa;IAC5D,MAAM,KAAK,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,YAAY,GAAG,KAAK,CAAC,mBAAmB;QAC7C,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC;QACnC,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe;QACrC,CAAC,CAAC;YACA,cAAc;YACd,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACrD,8DAA8D;YAC9D,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;YAChE,EAAE;SACF;aACC,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC;QACb,CAAC,CAAC,EAAE,CAAC;IAEN,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;;EAER,QAAQ;;;mBAGS,KAAK,CAAC,eAAe;oBACpB,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB;cACxD,KAAK,CAAC,MAAM,IAAI,eAAe;;;;;EAK3C,QAAQ,CAAC,eAAe;qBACxB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;qBACX,GAAG,CACH,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAChB,QAAQ,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ;mBACnC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,iBAAiB;wBAClC,KAAK,CAAC,aAAa;aAC9B,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,6BAA6B;;;EAGhE,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CACtD,CACC;qBACA,IAAI,CAAC,IAAI,CAAC;;;;;;EAMV,QAAQ,CAAC,eAAe;qBACxB,GAAG,CACH,CAAC,KAAK,EAAE,EAAE,CACT,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,IAAI,CACjF;qBACA,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;EAuBV,YAAY,CAAC,CAAC,CAAC,sBAAsB,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE;EAC1D,SAAS,CAAC,CAAC,CAAC,8BAA8B,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;CAU7D;aACG;SACD;KACD,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,KAA8B;IAGhE,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;SACjE,IAAI,CAAC,GAAG,CAAC;SACT,WAAW,EAAE,CAAC;IAChB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACjE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,MAAM,MAAM,GAA0B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtD,IAAI,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC;QACxB,MAAM,SAAS,GAAa,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACrD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACzC,KAAK,IAAI,GAAG,CAAC;gBACb,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;YAClC,CAAC;QACF,CAAC;QACD,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7C,KAAK,IAAI,YAAY,CAAC;gBACtB,SAAS,CAAC,IAAI,CAAC,IAAI,YAAY,sBAAsB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/C,KAAK,IAAI,cAAc,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,IAAI,cAAc,oBAAoB,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YACxE,CAAC;QACF,CAAC;QACD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1C,OAAO;YACN,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,aAAa,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS;YACtE,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,KAAK;YACL,SAAS;SACT,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,uEAAuE;AAEvE,SAAS,iBAAiB,CAAC,QAAiB;IAC3C,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO;YACN,4BAA4B;YAC5B,WAAW;YACX,4CAA4C;YAC5C,uCAAuC;YACvC,sDAAsD;YACtD,2CAA2C;YAC3C,2DAA2D;YAC3D,iDAAiD;YACjD,oDAAoD;YACpD,EAAE;YACF,qCAAqC;YACrC,2CAA2C;YAC3C,6DAA6D;YAC7D,wDAAwD;YACxD,sDAAsD;YACtD,KAAK;SACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IACD,gCAAgC;IAChC,OAAO;QACN,2BAA2B;QAC3B,OAAO;QACP,oDAAoD;QACpD,wDAAwD;QACxD,2KAA2K;QAC3K,kFAAkF;QAClF,iGAAiG;QACjG,+GAA+G;QAC/G,+DAA+D;QAC/D,GAAG;QACH,EAAE;QACF,wDAAwD;QACxD,mDAAmD;QACnD,4BAA4B;QAC5B,iGAAiG;QACjG,+FAA+F;QAC/F,iGAAiG;QACjG,GAAG;QACH,KAAK;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,cAAc;IACtB,OAAO;QACN,8DAA8D;QAC9D,iEAAiE;QACjE,gFAAgF;KAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/tools/sprint-timeline-calculator.d.ts

@@ -0,0 +1,7 @@
+export declare function sprintTimelineCalculator(args: unknown): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=sprint-timeline-calculator.d.ts.map

package/dist/tools/sprint-timeline-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-timeline-calculator.d.ts","sourceRoot":"","sources":["../../src/tools/sprint-timeline-calculator.ts"],"names":[],"mappings":"AAoBA,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,OAAO;;;;;GA4H3D"}

package/dist/tools/sprint-timeline-calculator.js

@@ -0,0 +1,240 @@
+import { z } from "zod";
+const SprintTimelineSchema = z.object({
+    tasks: z.array(z.object({
+        name: z.string(),
+        estimate: z.number(),
+        priority: z.string().optional(),
+        dependencies: z.array(z.string()).optional(),
+    })),
+    teamSize: z.number(),
+    sprintLength: z.number().optional(),
+    velocity: z.number().optional(),
+    includeMetadata: z.boolean().optional().default(true),
+    inputFile: z.string().optional(),
+});
+export async function sprintTimelineCalculator(args) {
+    const input = SprintTimelineSchema.parse(args);
+    const calculation = calculateSprintTimeline(input);
+    const sprintLen = input.sprintLength || 14;
+    return {
+        content: [
+            {
+                type: "text",
+                text: `## 🗓️ Sprint Timeline Calculation
+
+${input.includeMetadata ? `### Metadata\n- **Updated:** ${new Date().toISOString().slice(0, 10)}\n- **Source tool:** mcp_ai-agent-guid_sprint-timeline-calculator${input.inputFile ? `\n- **Input file:** ${input.inputFile}` : ""}\n` : ""}
+
+### Team Configuration
+- **Team Size**: ${input.teamSize} members
+- **Sprint Length**: ${input.sprintLength || 14} days
+- **Team Velocity**: ${calculation.velocity} story points per sprint
+- **Total Tasks**: ${input.tasks.length}
+
+### Capacity Analysis
+- **Total Story Points**: ${calculation.totalPoints}
+- **Required Sprints**: ${calculation.requiredSprints}
+- **Timeline**: ${calculation.timelineDays} days (${Math.ceil(calculation.timelineDays / 7)} weeks)
+- **Capacity Utilization**: ${calculation.utilizationPercentage}%
+
+### Sprint Summary
+| Sprint | Planned Points | Tasks |
+|-------:|----------------:|-------|
+${calculation.sprints
+                    .map((s, i) => `| ${i + 1} | ${s.points} | ${s.tasks.map((t) => t.name).join(", ")} |`)
+                    .join("\n")}
+
+### Sprint Breakdown
+${calculation.sprints
+                    .map((sprint, index) => `**Sprint ${index + 1}** (${sprint.points} points):\n${sprint.tasks
+                    .map((task) => `  - ${task.name} (${task.estimate} pts)${task.priority ? ` - Priority: ${task.priority}` : ""}`)
+                    .join("\n")}`)
+                    .join("\n\n")}
+
+### Risk Assessment
+${calculation.risks.map((risk, index) => `${index + 1}. **${risk.level}**: ${risk.description}`).join("\n")}
+
+### Recommendations
+${calculation.recommendations.map((rec, index) => `${index + 1}. ${rec}`).join("\n")}
+
+### Timeline Optimization Tips
+- **Prioritize high-value tasks** early in the timeline
+- **Address dependencies** before dependent tasks
+- **Plan for 80% capacity** to account for meetings, code reviews, and unexpected issues
+- **Include buffer time** for testing and bug fixes
+- **Regular velocity tracking** to adjust future estimations
+- **Consider skill distribution** when assigning tasks
+
+### Velocity Tracking Formula
+\`Velocity = Completed Story Points / Sprint Duration\`
+
+Current calculations based on:
+- Industry average: 8-10 story points per developer per sprint
+- Adjusted for team size and sprint length
+- Factoring in 20% overhead for meetings and coordination
+
+### Gantt (Mermaid)
+\`\`\`mermaid
+gantt
+	dateFormat  YYYY-MM-DD
+	title Sprint Plan
+%% Accessibility: Title=Project Sprint Plan; Description=Gantt chart of sprints and tasks over time. %%
+${calculation.sprints
+                    .map((sprint, sIndex) => {
+                    const section = `  section Sprint ${sIndex + 1}`;
+                    const start = new Date();
+                    start.setDate(start.getDate() + sIndex * sprintLen);
+                    const sanitize = (label) => label.replace(/[|\\]/g, "-").replace(/\s+/g, " ");
+                    // Place tasks sequentially within the sprint to avoid time gaps.
+                    let dayOffset = 0;
+                    const lines = [section];
+                    let totalDur = 0;
+                    sprint.tasks.forEach((t, i) => {
+                        const dur = 1 + Math.max(1, Math.ceil(t.estimate / 2));
+                        totalDur += dur;
+                        const taskStart = new Date(start);
+                        taskStart.setDate(taskStart.getDate() + dayOffset);
+                        const taskStartStr = taskStart.toISOString().slice(0, 10);
+                        lines.push(`  ${sanitize(t.name)} :s${sIndex + 1}t${i}, ${taskStartStr}, ${dur}d`);
+                        dayOffset += dur;
+                    });
+                    // If tasks don't fill the entire sprint, add a Buffer task to cover remaining days.
+                    if (totalDur < sprintLen) {
+                        const rem = sprintLen - totalDur;
+                        const bufStart = new Date(start);
+                        bufStart.setDate(bufStart.getDate() + totalDur);
+                        const bufStartStr = bufStart.toISOString().slice(0, 10);
+                        lines.push(`  Buffer_Review_Testing :s${sIndex + 1}buf, ${bufStartStr}, ${rem}d`);
+                    }
+                    return lines.join("\n");
+                })
+                    .join("\n")}
+\`\`\`
+
+### References
+- ZenHub — AI-assisted sprint planning (2025): https://www.zenhub.com/blog-posts/the-7-best-ai-assisted-sprint-planning-tools-for-agile-teams-in-2025
+- Nitor Infotech — AI in project delivery: https://www.nitorinfotech.com/blog/ai-in-software-project-delivery-smarter-planning-and-execution/
+`,
+            },
+        ],
+    };
+}
+function calculateSprintTimeline(input) {
+    const { tasks, teamSize, sprintLength = 14, velocity: inputVelocity } = input;
+    // Calculate total story points
+    const totalPoints = tasks.reduce((sum, task) => sum + task.estimate, 0);
+    // Calculate team velocity if not provided
+    // Industry standard: ~8-10 story points per developer per 2-week sprint
+    const baseVelocityPerDev = 8;
+    const sprintFactor = sprintLength / 14; // Adjust for sprint length
+    const calculatedVelocity = Math.round(teamSize * baseVelocityPerDev * sprintFactor * 0.8); // 80% capacity
+    const velocity = inputVelocity || calculatedVelocity;
+    // Calculate required sprints
+    const requiredSprints = Math.ceil(totalPoints / velocity);
+    const timelineDays = requiredSprints * sprintLength;
+    // Calculate capacity utilization
+    const utilizationPercentage = Math.round((totalPoints / (velocity * requiredSprints)) * 100);
+    // Organize tasks into sprints
+    const sprints = organizeTasks(tasks, velocity, requiredSprints);
+    // Risk assessment
+    const risks = assessRisks(input, totalPoints, velocity, utilizationPercentage);
+    // Generate recommendations
+    const recommendations = generateRecommendations(input, utilizationPercentage, requiredSprints);
+    return {
+        totalPoints,
+        velocity,
+        requiredSprints,
+        timelineDays,
+        utilizationPercentage,
+        sprints,
+        risks,
+        recommendations,
+    };
+}
+function organizeTasks(tasks, velocity, sprintCount) {
+    // Sort tasks by priority and dependencies
+    const sortedTasks = [...tasks].sort((a, b) => {
+        const priorityOrder = { high: 3, medium: 2, low: 1 };
+        const aPriority = priorityOrder[a.priority?.toLowerCase()] ||
+            2;
+        const bPriority = priorityOrder[b.priority?.toLowerCase()] ||
+            2;
+        return bPriority - aPriority; // Higher priority first
+    });
+    const sprints = [];
+    for (let i = 0; i < sprintCount; i++) {
+        sprints.push({ points: 0, tasks: [] });
+    }
+    // Distribute tasks across sprints
+    let currentSprint = 0;
+    for (const task of sortedTasks) {
+        // Find the sprint with the least points that can accommodate this task
+        let targetSprint = currentSprint;
+        for (let i = 0; i < sprints.length; i++) {
+            if (sprints[i].points + task.estimate <= velocity) {
+                if (sprints[i].points < sprints[targetSprint].points ||
+                    sprints[targetSprint].points + task.estimate > velocity) {
+                    targetSprint = i;
+                }
+            }
+        }
+        sprints[targetSprint].tasks.push(task);
+        sprints[targetSprint].points += task.estimate;
+        // Move to next sprint if current is full
+        if (sprints[currentSprint].points >= velocity * 0.8) {
+            currentSprint = (currentSprint + 1) % sprints.length;
+        }
+    }
+    return sprints.filter((sprint) => sprint.tasks.length > 0);
+}
+function assessRisks(input, totalPoints, velocity, utilization) {
+    const risks = [];
+    if (utilization > 90) {
+        risks.push({
+            level: "High",
+            description: "Over 90% capacity utilization may lead to burnout and missed deadlines",
+        });
+    }
+    if (input.teamSize < 3) {
+        risks.push({
+            level: "Medium",
+            description: "Small team size increases risk of bottlenecks and knowledge silos",
+        });
+    }
+    if (totalPoints > velocity * 10) {
+        risks.push({
+            level: "High",
+            description: "Large scope increases complexity and delivery risk",
+        });
+    }
+    const hasDependencies = input.tasks.some((task) => task.dependencies && task.dependencies.length > 0);
+    if (hasDependencies) {
+        risks.push({
+            level: "Medium",
+            description: "Task dependencies may cause delays if not properly managed",
+        });
+    }
+    if (risks.length === 0) {
+        risks.push({
+            level: "Low",
+            description: "Timeline appears achievable with current team configuration",
+        });
+    }
+    return risks;
+}
+function generateRecommendations(input, utilization, sprints) {
+    const recommendations = [];
+    if (utilization > 85) {
+        recommendations.push("Consider reducing scope or adding team members to avoid overcommitment");
+    }
+    if (sprints > 6) {
+        recommendations.push("Long timeline detected - consider breaking into smaller releases");
+    }
+    if (input.teamSize > 8) {
+        recommendations.push("Large team size - ensure clear communication channels and role definitions");
+    }
+    recommendations.push("Implement daily standups to track progress and identify blockers early");
+    recommendations.push("Plan for 20% buffer time to handle unexpected issues");
+    recommendations.push("Review and adjust velocity after each sprint based on actual completion");
+    return recommendations;
+}
+//# sourceMappingURL=sprint-timeline-calculator.js.map

package/dist/tools/sprint-timeline-calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-timeline-calculator.js","sourceRoot":"","sources":["../../src/tools/sprint-timeline-calculator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,75 @@
+{
+	"name": "mcp-ai-agent-guidelines",
+	"version": "0.1.0",
+	"description": "A comprehensive Model Context Protocol server providing professional tools, resources, and prompts for implementing AI agent best practices",
+	"main": "dist/index.js",
+	"type": "module",
+	"scripts": {
+		"build": "tsc",
+		"start": "npm run build && node dist/index.js",
+		"dev": "tsc --watch",
+		"test": "npm run test:all",
+		"test:unit": "node tests/unit/run-unit-tests.js",
+		"test:integration": "node tests/test-server.js",
+		"test:demo": "node demos/demo-tools.js",
+		"test:mcp": "scripts/test-mcp-server.sh",
+		"test:all": "npm run build && npm run test:unit && npm run test:integration && npm run test:demo && npm run test:mcp",
+		"lint": "biome lint src/",
+		"lint:fix": "biome lint --write src/",
+		"format": "biome format --write src/",
+		"format:check": "biome format src/",
+		"check": "biome check --write src/",
+		"type-check": "tsc --noEmit",
+		"quality": "npm run type-check && npm run check",
+		"validate": "npm run lint && npm run type-check && npm run test:all"
+	},
+	"keywords": [
+		"mcp",
+		"model-context-protocol",
+		"ai-agent",
+		"development",
+		"guidelines",
+		"tools",
+		"prompts",
+		"best-practices",
+		"hierarchical-prompting",
+		"code-hygiene",
+		"mermaid",
+		"memory-optimization",
+		"sprint-planning"
+	],
+	"author": "Anselmoo",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Anselmoo/mcp-ai-agent-guidelines.git"
+	},
+	"homepage": "https://github.com/Anselmoo/mcp-ai-agent-guidelines#readme",
+	"bugs": {
+		"url": "https://github.com/Anselmoo/mcp-ai-agent-guidelines/issues"
+	},
+	"bin": {
+		"mcp-ai-agent-guidelines": "dist/index.js"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"engines": {
+		"node": ">=20.0.0",
+		"npm": ">=10.0.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.1.3",
+		"@types/node": "^24.1.0",
+		"typescript": "^5.9.2"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.17.1",
+		"@types/express": "^5.0.3",
+		"express": "^5.1.0",
+		"mermaid": "^11.0.0",
+		"zod": "^3.25.76"
+	}
+}