@esreekarreddy/ai-prompts 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sreekar Reddy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,361 @@
+<p align="center">
+  <h1 align="center">MCP Prompt Library</h1>
+  <p align="center">
+    <strong>90+ curated prompts, workflows, and coding standards for AI-assisted development</strong>
+  </p>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg" alt="Node.js"></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple.svg" alt="MCP Compatible"></a>
+  <img src="https://img.shields.io/badge/tests-99%20passed-success.svg" alt="Tests">
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#mcp-server">MCP Server</a> •
+  <a href="#library-contents">Library</a> •
+  <a href="#integrations">Integrations</a>
+</p>
+
+---
+
+## Why This Exists
+
+AI assistants are powerful, but they're only as good as the prompts you give them. Most developers:
+
+- **Repeat the same prompts** across projects
+- **Forget effective prompts** they used before  
+- **Struggle to compose** complex multi-step workflows
+- **Lack consistency** in AI-assisted development patterns
+
+**MCP Prompt Library** solves this by providing:
+
+| What | How |
+|------|-----|
+| **90+ battle-tested prompts** | Organized by development phase (planning, development, quality, design) |
+| **MCP server with 15 tools** | Direct integration with Claude, OpenCode, Cursor, and any MCP-compatible client |
+| **Smart suggestions** | AI recommends prompts based on what you're doing |
+| **Workflow chains** | Multi-step guided processes for features, bugs, refactoring, security |
+| **Composable snippets** | Mix modifiers like `ultrathink` + `security-first` on any prompt |
+
+---
+
+## Quick Start
+
+### 1. Clone & Build
+
+```bash
+git clone https://github.com/esreekarreddy/mcp-prompt-library.git
+cd mcp-prompt-library/mcp-server
+npm install && npm run build
+```
+
+### 2. Configure Your AI Tool
+
+See [Integrations](#integrations) for your specific tool (OpenCode, Claude Desktop, Cursor).
+
+### 3. Start Using
+
+Once connected, your AI assistant has access to all prompts:
+
+```
+"suggest prompts for what I'm doing"
+"get the PRD generator prompt"
+"start the new-feature chain"
+"compose prd-generator with ultrathink"
+```
+
+---
+
+## Features
+
+### Smart Intent Detection
+
+Tell your AI what you're doing, and it suggests the right prompts:
+
+| You Say | It Suggests |
+|---------|-------------|
+| "I need to build a new feature" | PRD generator, new-feature chain |
+| "Stuck on a bug" | Deep debugger, debugging skill, bug-fix chain |
+| "Security review before launch" | Security audit, security-hardening chain |
+| "This code is a mess" | Code cleaner, refactoring skill, refactor chain |
+| "Complex architecture decision" | Megathink modifier, senior-engineer persona |
+
+### Workflow Chains
+
+Multi-step guided workflows for complex tasks:
+
+| Chain | Steps | Use Case |
+|-------|-------|----------|
+| `new-feature` | 7 | From PRD to deployment |
+| `bug-fix` | 7 | Systematic debugging to resolution |
+| `refactor` | 6 | Safe refactoring with verification |
+| `security-hardening` | 7 | Comprehensive security review |
+| `production-launch` | 7 | Pre-launch checklist to deployment |
+
+```bash
+# Start a chain
+node dist/cli.js chains           # List available chains
+start_chain chain="new-feature"   # Via MCP tool
+```
+
+### Composable Prompts
+
+Combine any prompts with modifiers:
+
+```bash
+# CLI
+node dist/cli.js compose prd-generator ultrathink security-first
+
+# MCP Tool  
+compose_prompt items=["prd-generator", "ultrathink", "security-first"]
+```
+
+### Quick Modifiers
+
+Instant prompt enhancers:
+
+| Modifier | Effect |
+|----------|--------|
+| `ultrathink` | Deep analysis with extended reasoning |
+| `megathink` | Maximum thinking for architecture decisions |
+| `critique` | Harsh, unfiltered feedback mode |
+| `debug` | Systematic debugging approach |
+| `plan` | Planning mode - no code yet |
+| `secure` | Security-focused review |
+| `simplify` | Explain like I'm 12 |
+
+---
+
+## MCP Server
+
+The MCP (Model Context Protocol) server exposes **15 tools** to your AI assistant:
+
+### Library Tools
+| Tool | Purpose |
+|------|---------|
+| `get_prompt` | Fetch any prompt by name (fuzzy matching works) |
+| `search_prompts` | Search library by keywords |
+| `suggest_prompts` | Smart suggestions based on your intent |
+| `enhance_prompt` | Analyze request and suggest approach + relevant prompts |
+| `save_to_library` | Save new prompts to the library |
+| `library_stats` | Library statistics |
+| `random_prompt` | Random prompt for inspiration |
+
+### Chain Tools
+| Tool | Purpose |
+|------|---------|
+| `list_chains` | View available workflow chains |
+| `start_chain` | Begin a multi-step workflow |
+| `chain_next` | Advance to next step |
+| `chain_status` | View workflow progress |
+| `chain_step` | Jump to specific step |
+
+### Utility Tools
+| Tool | Purpose |
+|------|---------|
+| `compose_prompt` | Combine multiple prompts |
+| `quick_prompt` | Instant one-liner modifiers |
+| `detect_context` | Analyze project → suggest stack-specific prompts |
+
+### How It Works
+
+```
+You: "Build a user authentication system"
+        ↓
+AI calls: suggest_prompts("Build a user authentication system")
+        ↓
+Returns: security-audit, new-feature chain, auth patterns
+        ↓
+AI calls: start_chain("new-feature")  
+        ↓
+AI guides you through: PRD → Architecture → Implementation → Testing → Deploy
+```
+
+---
+
+## Library Contents
+
+**90+ curated resources** across 8 categories:
+
+```
+mcp-prompt-library/
+├── prompts/          (18) - Copy-paste ready prompts
+│   ├── planning/          PRD generator, scope killer, architecture
+│   ├── development/       Debugger, code cleaner, tech debt
+│   ├── quality/           Security audit, testing, pre-launch
+│   ├── design/            Design system extractor
+│   ├── analysis/          Deep debugger
+│   ├── agentic/           Context manager, agentic loop, test-driven fix
+│   └── system/            Master system prompt for AI setup
+├── skills/           (8)  - AI behavior definitions
+│   └── code-review, debugging, testing, refactoring, documentation...
+├── instructions/     (18) - Reusable system prompts
+│   ├── personas/          Senior engineer, security expert, DevOps, UX
+│   ├── standards/         TypeScript, React, Python, Go, Rust, FastAPI, Next.js
+│   └── workflows/         TDD, PR review, incident response, feature development
+├── templates/        (16) - Project scaffolding
+│   ├── claude-md/         CLAUDE.md for Next.js, Python, Node.js, CLI tools
+│   ├── cursor-rules/      .cursorrules for various stacks
+│   ├── copilot/           GitHub Copilot instructions
+│   └── docs/              PRD, ADR, API spec, runbook templates
+├── chains/           (5)  - Multi-step workflows
+│   └── new-feature, bug-fix, refactor, security-hardening, production-launch
+├── snippets/         (17) - Composable modifiers
+│   ├── modifiers/         ultrathink, megathink, step-by-step, meta-cot
+│   ├── output-formats/    JSON, markdown table, checklist, numbered list
+│   └── constraints/       Security first, MVP only, read-only, no external deps
+├── contexts/         (9)  - Reference documentation
+│   ├── stacks/            Next.js 14, FastAPI, Prisma
+│   ├── patterns/          MCP server patterns, agentic coding
+│   └── guides/            API design, error handling
+└── examples/         (3)  - Gold-standard samples
+    └── PRDs, architecture docs, code reviews
+```
+
+---
+
+## Integrations
+
+### OpenCode
+
+Add to `~/.opencode/config.json`:
+
+```json
+{
+  "mcp": {
+    "ai-library": {
+      "type": "local",
+      "command": [
+        "node",
+        "/path/to/mcp-prompt-library/mcp-server/dist/index.js"
+      ],
+      "enabled": true
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ai-library": {
+      "command": "node",
+      "args": ["/path/to/mcp-prompt-library/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "ai-library": {
+      "command": "node", 
+      "args": ["/path/to/mcp-prompt-library/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+### VS Code + GitHub Copilot
+
+Copy the prompt files to your workspace:
+
+```bash
+cp -r .github/prompts /path/to/your-project/.github/prompts
+```
+
+---
+
+## CLI Usage
+
+Use the library directly from your terminal:
+
+```bash
+cd mcp-server
+
+# Get a specific prompt
+node dist/cli.js get prd-generator
+
+# Search prompts  
+node dist/cli.js search "security"
+
+# Get AI-powered suggestions
+node dist/cli.js suggest "I need to refactor this messy code"
+
+# Combine prompts
+node dist/cli.js compose prd-generator ultrathink step-by-step
+
+# View workflow chains
+node dist/cli.js chains
+
+# Library statistics
+node dist/cli.js stats
+
+# Random prompt for inspiration
+node dist/cli.js random
+```
+
+---
+
+## Development
+
+```bash
+cd mcp-server
+
+npm install        # Install dependencies
+npm run build      # Build TypeScript
+npm run test       # Run tests (99 tests)
+npm run dev        # Watch mode
+npm run typecheck  # Type checking only
+```
+
+### Architecture
+
+- **TypeScript** - Full type safety
+- **Vitest** - 99 tests with fast execution
+- **Zod** - Runtime validation for configs
+- **chokidar** - Hot-reload when library files change
+- **MCP SDK** - Model Context Protocol integration
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+Ideas for contributions:
+- Add prompts that worked well for you
+- Add workflow chains for common tasks
+- Add coding standards for new languages/frameworks
+- Improve existing prompts with better examples
+
+---
+
+## License
+
+MIT - see [LICENSE](LICENSE)
+
+---
+
+## Acknowledgments
+
+Built with the [Model Context Protocol](https://modelcontextprotocol.io) by Anthropic.
+
+---
+
+<p align="center">
+  <strong>Your AI is only as good as your prompts. Keep them polished.</strong>
+</p>

package/chains/_index.md

@@ -0,0 +1,33 @@
+# Chains Index
+
+> Multi-step workflows for complex tasks
+
+## What Are Chains?
+
+Chains are sequences of prompts designed to be used together for complex tasks that require multiple steps.
+
+## Available Chains
+
+| Chain | Steps | Use Case |
+|-------|-------|----------|
+| [new-feature.md](new-feature.md) | 7 | Building a new feature from idea to deployment |
+| [bug-fix.md](bug-fix.md) | 7 | Systematic debugging and fixing |
+| [refactor.md](refactor.md) | 6 | Safe, incremental refactoring |
+| [security-hardening.md](security-hardening.md) | 7 | Securing an application |
+| [production-launch.md](production-launch.md) | 7 | Pre-launch preparation |
+
+## How to Use
+
+1. Open the chain file
+2. Execute each step in order
+3. Wait for completion before proceeding
+4. Document findings between steps
+
+## Chain Format
+
+Each chain file contains:
+- Overview of the workflow
+- Prerequisites
+- Step-by-step prompts
+- Expected outputs per step
+- Decision points

package/chains/bug-fix.md

@@ -0,0 +1,222 @@
+# Chain: Bug Fix
+
+> Systematic workflow from bug report to verified fix
+
+## Overview
+
+```
+Understand → Reproduce → Diagnose → Fix → Verify → Deploy
+```
+
+---
+
+## Step 1: Understand the Bug
+
+**Prompt:**
+```
+I have a bug report:
+
+[Paste bug report or describe the issue]
+
+Help me understand:
+1. What is the expected behavior?
+2. What is the actual behavior?
+3. Who is affected?
+4. How severe is this?
+5. When did it start (if known)?
+6. Any recent changes that might be related?
+
+Don't start fixing yet. Just understand.
+```
+
+**Expected Output:**
+- Clear problem statement
+- Severity assessment
+- Initial hypotheses
+
+---
+
+## Step 2: Reproduce the Bug
+
+**Prompt:**
+```
+Based on the bug report, help me create reliable reproduction steps:
+
+1. What exact steps reproduce this?
+2. What environment is needed?
+3. Is it deterministic or intermittent?
+4. What's the minimal reproduction case?
+
+Let's confirm we can reproduce before investigating.
+```
+
+**Expected Output:**
+- Step-by-step reproduction
+- Environment requirements
+- Reproduction rate
+
+**Decision Point:** Can we reproduce? If not, gather more info.
+
+---
+
+## Step 3: Diagnose Root Cause
+
+**Prompt:**
+```
+The bug reproduces. Now diagnose:
+
+I'm stuck in a debugging loop. The bug: [describe it]
+
+Before suggesting fixes:
+
+1. List 5-7 different possible causes. Consider:
+   - Data issue, not code?
+   - Environment/config?
+   - Race condition/timing?
+   - Caching?
+   - Bug is somewhere else entirely?
+
+2. Rank by likelihood
+
+3. For top 2: what diagnostic code/logs would prove or disprove each?
+
+Don't fix yet. Confirm the cause first.
+
+Ultrathink.
+```
+
+**Expected Output:**
+- Ranked hypotheses
+- Diagnostic approach
+- Evidence needed
+
+---
+
+## Step 4: Confirm Root Cause
+
+**Prompt:**
+```
+Based on the diagnostics:
+
+[Paste diagnostic output/findings]
+
+1. What do these findings tell us?
+2. Is the root cause confirmed?
+3. Are there any other factors?
+4. Now that we know the cause, what's the fix?
+```
+
+**Expected Output:**
+- Confirmed root cause
+- Understanding of why it happens
+- Fix approach
+
+**Decision Point:** Root cause confirmed? If not, add more diagnostics.
+
+---
+
+## Step 5: Implement Fix
+
+**Prompt:**
+```
+The root cause is: [root cause]
+
+Implement a fix that:
+1. Addresses the root cause (not just symptoms)
+2. Doesn't introduce regressions
+3. Includes a test that would have caught this
+4. Follows project coding standards
+
+Show the fix and explain why it works.
+```
+
+**Expected Output:**
+- Code fix
+- Explanation
+- Test case
+
+---
+
+## Step 6: Verify Fix
+
+**Prompt:**
+```
+The fix is implemented. Verify:
+
+1. Does the original reproduction case pass?
+2. Do all existing tests still pass?
+3. Any edge cases we should test?
+4. Could this same bug exist elsewhere?
+5. Is there a risk of regression?
+
+Be thorough. We don't want this bug back.
+```
+
+**Expected Output:**
+- Verification results
+- Additional test cases
+- Regression assessment
+
+---
+
+## Step 7: Document & Deploy
+
+**Prompt:**
+```
+Prepare this fix for deployment:
+
+1. PR description explaining:
+   - What was the bug
+   - What caused it
+   - How this fixes it
+   
+2. Any monitoring we should add?
+3. Should we verify in staging first?
+4. Any users we should notify?
+```
+
+**Expected Output:**
+- PR description
+- Deployment plan
+- Communication if needed
+
+---
+
+## Chain Summary
+
+| Step | Focus | Output |
+|------|-------|--------|
+| 1 | Understand | Clear problem statement |
+| 2 | Reproduce | Reliable repro steps |
+| 3 | Diagnose | Hypotheses + diagnostics |
+| 4 | Confirm | Verified root cause |
+| 5 | Fix | Code + tests |
+| 6 | Verify | Confirmation + regression check |
+| 7 | Deploy | PR + deployment |
+
+## Bug Report Template
+
+```markdown
+**Summary**: [One line description]
+
+**Expected Behavior**: 
+[What should happen]
+
+**Actual Behavior**: 
+[What actually happens]
+
+**Reproduction Steps**:
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+**Environment**:
+- Browser/OS: [details]
+- Version: [app version]
+- User account: [if relevant]
+
+**Additional Context**:
+- Error messages: [any errors]
+- Screenshots: [if helpful]
+- When it started: [if known]
+```