{"id":29360062,"url":"https://github.com/jpke/cursor-vibe-coding-template","last_synced_at":"2026-06-19T06:32:34.208Z","repository":{"id":302932348,"uuid":"1013883335","full_name":"jpke/cursor-vibe-coding-template","owner":"jpke","description":"A comprehensive project template for vibe coding in Cursor with pre-configured AI tooling, MCP servers, and intelligent development workflows","archived":false,"fork":false,"pushed_at":"2025-07-05T12:03:49.000Z","size":47,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-02T21:42:37.272Z","etag":null,"topics":["ai-coding","ai-development","cursor","development-workflow","mcp","project-template","taskmaster","template"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jpke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-04T16:17:05.000Z","updated_at":"2025-09-01T11:03:03.000Z","dependencies_parsed_at":"2025-07-05T14:47:52.953Z","dependency_job_id":null,"html_url":"https://github.com/jpke/cursor-vibe-coding-template","commit_stats":null,"previous_names":["jpke/cursor-vibe-coding-template"],"tags_count":8,"template":true,"template_full_name":null,"purl":"pkg:github/jpke/cursor-vibe-coding-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpke%2Fcursor-vibe-coding-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpke%2Fcursor-vibe-coding-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpke%2Fcursor-vibe-coding-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpke%2Fcursor-vibe-coding-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jpke","download_url":"https://codeload.github.com/jpke/cursor-vibe-coding-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpke%2Fcursor-vibe-coding-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34520431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","ai-development","cursor","development-workflow","mcp","project-template","taskmaster","template"],"created_at":"2025-07-09T07:09:40.194Z","updated_at":"2026-06-19T06:32:34.186Z","avatar_url":"https://github.com/jpke.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Vibe Coding Project Template\n\nA comprehensive project template for **vibe coding** in Cursor with pre-configured AI tooling, MCP servers, and intelligent development workflows.\n\n## Table of Contents\n\n- [Quick Start](#-quick-start)\n- [Features](#-features)\n- [What's Included](#-whats-included)\n- [Vibe Coding Workflow](#-vibe-coding-workflow)\n- [Configuration](#-configuration)\n- [Documentation](#-documentation)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## 🚀 Quick Start\n\n### 1. Create Your Project\n\n**Recommended: Use as GitHub Template**\n1. Click \"Use this template\" button on GitHub\n2. Create your new repository from the template\n3. Clone your new repository:\n   ```bash\n   git clone git@github.com:yourusername/your-project-name.git\n   cd your-project-name\n   cursor .\n   ```\n4. Prompt the AI agent: `\"initialize this project as \u003cmy project name\u003e\"`\n\n**Alternative: Clone Template Directly**\n```bash\n# If you cloned the template repository directly\ngit clone git@github.com:your-org/project_template.git my-new-project\ncd my-new-project\ncursor .\n\n# Then prompt the AI agent:\n# \"Initialize the repo for my new project\"\n```\n\nThe AI agent will automatically handle template setup including:\n- Setting up your MCP configuration\n- Customizing files for your project\n- Initializing git repository and GitHub repo (only needed for cloned templates)\n\n**Manual Setup (If Preferred)**\n```bash\n# After cloning the template to your project folder\ncd my-new-project\n\n# REQUIRED: Set up MCP configuration\ncp .cursor/.mcp.json.example .cursor/mcp.json\n# Edit .cursor/mcp.json with your API keys\n\n# Optional: Copy .env only if you plan to use TaskMaster CLI\n# (Not needed for the recommended MCP workflow)\ncp .env.example .env  # Optional\n# Add your API keys to .env  # Only if using CLI\n\n# IMPORTANT: Customize for your project\n# - Replace this README.md with your project's README\n# - Update SECURITY.md to remove template references\n# - Remove or update any hardcoded paths in configuration files\n```\n\n### 2. Start Vibe Coding\n```bash\ncursor .\n# For GitHub template usage: \"initialize this project as \u003cmy project name\u003e\"\n# For cloned templates: \"Initialize the repo for my new project\"\n```\n\n## ✨ Features\n\nThis template provides a ready-to-use development environment with:\n\n- **🎯 TaskMaster AI Integration** - Intelligent task management with AI-powered PRD parsing, complexity analysis, and task breakdown\n- **🧠 Memory MCP Server** - Persistent knowledge graph for maintaining context across sessions\n- **🔗 Context7 MCP** - Enhanced codebase understanding and contextual assistance\n- **🐙 GitHub MCP Integration** - Seamless GitHub repository and issue management\n- **📝 Pre-configured Cursor Rules** - Optimized rules for frontend, testing, Python, and workflow automation\n- **🚀 Automated Git Workflows** - Intelligent repository initialization with scoped permissions\n- **🤖 Agent-Driven Setup** - AI assistant handles template initialization automatically\n\n## 🛠️ What's Included\n\n### MCP Servers (Pre-configured)\n- **TaskMaster AI** - AI-powered project management and task orchestration\n- **Memory** - Persistent knowledge graph for context retention\n- **Context7** - Enhanced codebase analysis and suggestions\n- **GitHub** - Repository management and issue tracking\n\n### Cursor Rules\n- `development.mdc` - Frontend, testing, and Python development best practices\n- `rule_management.mdc` - Rule structure and formatting guidelines\n- `self_improve.mdc` - Self-improving rule management patterns\n- `workflow.mdc` - Git, Taskmaster, and Memory MCP workflows\n- `taskmaster/` - Comprehensive TaskMaster workflow rules\n\n### Setup \u0026 Configuration\n- `.cursor/.mcp.json.example` - Template MCP server configuration\n- `.env.example` - Optional environment variables for CLI usage\n\n### Project Structure\n```\nproject_template/\n├── .cursor/\n│   ├── mcp.json              # MCP server configuration\n│   ├── .mcp.json.example     # Template for MCP setup\n│   └── rules/                # Cursor coding rules\n├── .taskmaster/              # TaskMaster configuration\n│   ├── config.json           # AI model settings\n│   ├── docs/                 # Documentation directory\n│   ├── tasks/                # Task files\n│   └── templates/            # PRD templates\n├── .github/\n│   └── instructions/         # GitHub workflow instructions\n├── AGENTS.md                 # TaskMaster integration guide\n├── CLAUDE.md                 # Claude Code integration guide\n└── .env.example              # Optional: Environment variables for CLI usage only\n```\n\n## 🎯 Vibe Coding Workflow\n\nThis template is optimized for **vibe coding** - a development style that balances structure with creative flow using controlled MCP workflows.\n\n### 🚀 Initialize Git Repository\n**Note:** Only needed when cloning the template directly. When using as a GitHub template (recommended), your repository is already initialized.\n\n**Prompt:** `\"Initialize git repo\"` or `\"Initialize the repo for my new project\"`\n\nFor cloned templates, the AI agent automatically follows this workflow:\n1. **Template Cleanup** - Removes template-specific `.git` history\n2. **Local Git Setup** - Initializes fresh repository with proper `.gitignore`\n3. **GitHub Repository** - Creates private repo with issues enabled via GitHub CLI\n4. **Scoped Authentication** - Generates repository-specific GitHub PAT with minimal permissions\n5. **MCP Configuration** - Updates `.cursor/mcp.json` with the scoped token\n6. **Initial Commit** - Pushes your new project to `main` branch using SSH authentication\n\n### 📋 PRD-Driven Development (User-Controlled)\n\n#### Step 1: Initialize TaskMaster\n**Prompt:** `\"Initialize TaskMaster for this project\"`\n- Uses the `initialize_project` MCP tool to set up project structure\n\n#### Step 2: Create and Validate PRD\n**Prompt:** `\"Help me create a Product Requirements Document for [describe your project idea]\"`\n- Collaborate with AI to write a comprehensive PRD\n- Refine requirements through iterative discussion\n- PRD draft saved locally in `.taskmaster/docs/prd.txt`\n\n#### Step 3: Create GitHub Issue from PRD\n**Prompt:** `\"I accept this PRD. Please create a GitHub Issue with the full PRD content\"`\n- AI creates GitHub Issue containing the complete PRD text\n- GitHub Issue becomes the single source of truth for requirements\n- **Local PRD file is automatically deleted** to prevent confusion\n\n#### Step 4: Generate Tasks (Explicit Trigger Required)\n**Prompt:** `\"Start working on the PRD\"` or `\"Generate tasks from the PRD Issue\"`\n- **Important:** Tasks are only generated after this explicit instruction\n- AI uses TaskMaster MCP to parse the GitHub Issue and create structured tasks\n- Complex tasks are broken down with AI-powered complexity analysis\n\n#### Step 5: Confirm Task Selection\n**Prompt:** `\"I want to begin with task [ID]\"` or `\"Which task should I start with?\"`\n- **Required:** AI must confirm which specific task to begin before executing\n- AI will not automatically start task execution without your approval\n- Uses `next_task` MCP tool to suggest optimal starting points based on dependencies\n\n### 🧠 Memory \u0026 Context Management\n**Memory MCP Workflow:**\n- **Before Memory Operations** - AI asks: `\"May I save this information to the knowledge graph?\"`\n- **User Confirmation** - `\"Yes, you can update memory\"` or `\"No, don't save this yet\"`\n- **Context Preservation** - Understanding maintained across sessions with explicit consent\n\n### 🔄 Development Loop with Explicit Control\n- **AI Suggests** - Provides recommendations and analysis\n- **User Decides** - Explicit approval required for significant operations\n- **Controlled Automation** - MCP servers assist but don't override user decisions\n- **Progress Tracking** - Development logged with user awareness\n\n### 🎵 The Vibe\nIntelligent assistance with human control:\n1. **Express your intent** in natural language\n2. **AI structures and suggests** work through MCP integration\n3. **You approve and direct** with explicit confirmation points\n4. **Code in flow** with full context awareness and controlled automation\n5. **Ship iteratively** with transparent progress tracking\n\nThe MCP servers provide powerful assistance while keeping you in the driver's seat.\n\n## 🔧 Configuration\n\n### Required API Keys\n\n**For MCP Workflow (Recommended):** Add to `.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"taskmaster-ai\": {\n      \"env\": {\n        \"ANTHROPIC_API_KEY\": \"your_key_here\",\n        \"PERPLEXITY_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**For CLI Workflow (Optional):** Add to `.env` file:\n```bash\n# AI Models\nANTHROPIC_API_KEY=your_key_here\nPERPLEXITY_API_KEY=your_key_here  # For research features\nOPENAI_API_KEY=your_key_here      # Optional\nGOOGLE_API_KEY=your_key_here      # Optional\n\n# GitHub (auto-configured during git init)\nGITHUB_TOKEN=your_scoped_pat_here\n```\n\n**Important Notes:**\n- The `.env.example` file is provided for users who want to use TaskMaster CLI commands directly. For the recommended MCP workflow in Cursor, only `.cursor/mcp.json` configuration is needed.\n- **Environment File Distinction**: This template's `.env.example` contains TaskMaster CLI configuration. Your project may also need its own `.env` file for application configuration (database URLs, app API keys, etc.) - these are completely separate concerns.\n\n### MCP Server Setup\nThe template includes example configurations in `.cursor/.mcp.json.example`. Copy and customize:\n\n```json\n{\n  \"mcpServers\": {\n    \"taskmaster-ai\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"--package=task-master-ai\", \"task-master-ai\"],\n      \"env\": {\n        \"ANTHROPIC_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## 📚 Documentation\n\n- **AGENTS.md** - Comprehensive TaskMaster AI integration guide\n- **CLAUDE.md** - Claude Code specific workflows and commands\n- `.cursor/rules/` - Detailed coding rules and patterns\n- `.taskmaster/templates/` - PRD templates and examples\n\n## 📄 License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nThis template evolves with usage. The `meta_rules.mdc` enables self-improving patterns - rules automatically update based on emerging patterns in your codebase.\n\n### How to Contribute\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Commit your changes (`git commit -m 'Add amazing feature'`)\n5. Push to the branch (`git push origin feature/amazing-feature`)\n6. Open a Pull Request\n\n## 🔗 Related Projects\n\n- [TaskMaster AI](https://github.com/your-org/task-master-ai) - The core task management system\n- [Cursor](https://cursor.sh/) - The AI-powered code editor this template is designed for\n\n## 🙏 Acknowledgments\n\nThis template was inspired by several excellent resources in the AI development community:\n\n- **[Viktor Farcic's YouTube Automation](https://github.com/vfarcic/youtube-automation)** - Reference implementation of AI-powered development workflows\n- **[My Workflow With AI: How I Code, Test, and Deploy Faster Than Ever](https://devopstoolkit.live/ai/my-workflow-with-ai-how-i-code-test-and-deploy-faster-than-ever/)** - Comprehensive guide to AI-assisted development workflows by Viktor Farcic\n- **[AI Labs Video](https://www.youtube.com/watch?v=cAFIUiE_8DM)** - Insights on AI development practices and tooling\n\nThese resources provided valuable insights into structuring AI-powered development workflows, MCP server integration, and best practices for vibe coding with AI assistants.\n\n---\n\n**Happy vibe coding! 🎵✨**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpke%2Fcursor-vibe-coding-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpke%2Fcursor-vibe-coding-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpke%2Fcursor-vibe-coding-template/lists"}