{"id":30009457,"url":"https://github.com/jondoescoding/jondoescoding-coding-rules","last_synced_at":"2026-01-20T17:34:00.265Z","repository":{"id":307141807,"uuid":"1028552155","full_name":"jondoescoding/jondoescoding-coding-rules","owner":"jondoescoding","description":"CLI tool to manage custom Cursor AI rule templates for enhanced AI-assisted development","archived":false,"fork":false,"pushed_at":"2025-07-29T20:23:43.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-29T20:23:59.470Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.nightshadeai.xyz/","language":"JavaScript","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/jondoescoding.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-29T17:42:21.000Z","updated_at":"2025-07-29T20:23:58.000Z","dependencies_parsed_at":"2025-07-29T20:28:09.326Z","dependency_job_id":null,"html_url":"https://github.com/jondoescoding/jondoescoding-coding-rules","commit_stats":null,"previous_names":["jondoescoding/jondoescoding-cursor-rules","jondoescoding/my-cursor-rules"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jondoescoding/jondoescoding-coding-rules","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jondoescoding%2Fjondoescoding-coding-rules","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jondoescoding%2Fjondoescoding-coding-rules/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jondoescoding%2Fjondoescoding-coding-rules/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jondoescoding%2Fjondoescoding-coding-rules/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jondoescoding","download_url":"https://codeload.github.com/jondoescoding/jondoescoding-coding-rules/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jondoescoding%2Fjondoescoding-coding-rules/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268882843,"owners_count":24323131,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"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":[],"created_at":"2025-08-05T10:52:53.728Z","updated_at":"2026-01-20T17:34:00.256Z","avatar_url":"https://github.com/jondoescoding.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎯 jondoescoding Rules CLI\n\n\u003e A powerful CLI tool to manage and distribute custom Cursor AI rule templates for enhanced AI-assisted development.\n\n[![npm version](https://badge.fury.io/js/jondoescoding-coding-rules.svg)](https://badge.fury.io/js/jondoescoding-coding-rules)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## 🚀 What This Does\n\nThis CLI tool allows you to quickly install pre-configured templates for both Cursor AI and Claude Code into your projects. Choose the right import type for your AI development workflow.\n\n### Key Features\n\n- 📦 **Dual AI Support**: Templates for both Cursor AI and Claude Code\n- 🎨 **Multiple Categories**: Pre-built templates for popular technologies\n- 🔧 **Customizable**: Easy to add your own custom templates\n- 🌐 **Shareable**: Distribute your team's standards as npm packages\n- 🎯 **Targeted Installation**: Choose exactly what you need with `--type` parameter\n\n## 🤖 Import Types\n\n### `--type cursor` (Default)\n- **Purpose**: Cursor AI coding rules and standards\n- **Location**: `.cursor/rules/`\n- **Format**: `.mdc` files\n- **Use Case**: Guide Cursor AI's code suggestions and completions\n\n### `--type claude-code`\n- **Purpose**: Claude Code workflow optimization\n- **Location**: `.claude/`\n- **Format**: `.md` files\n- **Use Case**: Improve communication and productivity with Claude Code\n\n## 📋 Template Types Explained\n\n### Cursor AI Rules (`.mdc` files)\nCursor rules are markdown files placed in `.cursor/rules/` that provide context and coding standards to Cursor AI. They help ensure consistent:\n- Code style and formatting\n- Architecture patterns  \n- Best practices\n- Error handling approaches\n- Naming conventions\n\n### Claude Code Configuration (`.md` files)\nClaude Code templates are workflow guides placed in `.claude/` that optimize your collaboration with Claude Code:\n- Project setup and organization\n- Communication patterns\n- Context management strategies\n- Productivity workflows\n- Best practices for AI collaboration\n\n## 🛠 Installation \u0026 Usage\n\n### ⚡ Super Quick Start (NEW!)\n\n```bash\n# Install EVERYTHING (both Cursor AI and Claude Code rules)\nnpx jondoescoding-coding-rules --all\n```\n\n### Quick Start (Recommended)\n\n```bash\n# List available templates by type\nnpx jondoescoding-coding-rules --list --type cursor\nnpx jondoescoding-coding-rules --list --type claude-code\n\n# Install specific templates (defaults to cursor type)\nnpx jondoescoding-coding-rules writing/scott-adams-writing-principles\nnpx jondoescoding-coding-rules python/llm/observability/langfuse\nnpx jondoescoding-coding-rules seo/seo-best-practices\n\n# Install with explicit type\nnpx jondoescoding-coding-rules --type cursor python/llm/observability/langfuse\nnpx jondoescoding-coding-rules --type claude-code memory-management\n\n# Install multiple templates\nnpx jondoescoding-coding-rules writing/scott-adams-writing-principles seo/seo-best-practices\nnpx jondoescoding-coding-rules --type claude-code memory-management project-setup\n\n# Install all available templates of a type\nnpx jondoescoding-coding-rules --all --type cursor\nnpx jondoescoding-coding-rules --all --type claude-code\n\n# Install ALL templates (both cursor and claude-code) - NEW!\nnpx jondoescoding-coding-rules --all\n```\n\n### Global Installation\n\n```bash\nnpm install -g jondoescoding-coding-rules\njondoescoding-coding-rules --help\n```\n\n## 📚 Available Templates\n\n## 🎯 Cursor AI Rules (`--type cursor`)\n*Installed to `.cursor/rules/` - Used by Cursor AI for coding assistance*\n\n\n### Python Templates\n| Template | Description | File Types |\n|----------|-------------|------------|\n| `python/llm/observability/langfuse` | Complete LangFuse tracing setup for FastAPI + LangChain/LangGraph | `**/*.py`, `src/**/*`, `api/**/*` |\n\n### SEO Templates\n| Template | Description | File Types |\n|----------|-------------|------------|\n| `seo/seo-best-practices` | SEO best practices for page modifications and server-side rendering | `**/*.tsx`, `**/*.jsx`, `app/**/*` |\n| `seo/seo-google-rules` | Google SEO standards compliance rules for Next.js business websites | `**/*.tsx`, `**/*.jsx`, `**/*.ts` |\n| `seo/seo_rules` | Elite Technical \u0026 Content SEO strategy for AI automation and web design agencies | `**/*.tsx`, `**/*.jsx`, `content/**/*` |\n\n### Writing Templates\n| Template | Description | File Types |\n|----------|-------------|------------|\n| `writing/content-curation-rule` | Viral content formats for Twitter and LinkedIn | `**/*.md`, `**/*.txt` |\n| `writing/scott-adams-writing-principles` | Clear, persuasive writing principles from Scott Adams | `**/*.md`, `**/*.txt`, `content/**/*` |\n| `writing/seo-long-form-article-blueprint` | Complete blueprint for high-converting SEO articles | `**/*.md`, `content/**/*`, `blog/**/*` |\n| `writing/tweet-interview-process` | Systematic approach for creating viral, conversion-focused tweets | `**/*.md`, `social/**/*`, `content/**/*` |\n| `writing/twitter-thread-creation` | Step-by-step guide for creating viral Twitter threads | `**/*.md`, `social/**/*`, `twitter/**/*` |\n\n### Task Management Templates\n| Template | Description | File Types |\n|----------|-------------|------------|\n| `tasking/task-management` | Comprehensive task management system with dementia-friendly clear documentation | `tasks/**/*`, `task-logs/**/*`, `.cursor/task-logs/**/*` |\n\n## 🤖 Claude Code Configuration (`--type claude-code`)\n*Installed to `.claude/` - Used for Claude Code workflow optimization*\n\n| Template | Description | Purpose |\n|----------|-------------|---------|\n| `memory-management` | Claude Code memory and context management strategies | Improve context retention across conversations |\n| `project-setup` | Optimal project structure and configuration for Claude Code | Set up projects for effective AI collaboration |\n| `workflow-optimization` | Communication patterns and productivity tips for Claude Code | Maximize efficiency when working with Claude |\n\n### Template Details\n\nEach template includes:\n- ✅ Coding standards and style guidelines\n- ✅ Best practices for the technology\n- ✅ Common patterns and examples\n- ✅ Error handling recommendations\n- ✅ Performance considerations\n\n## 📁 Project Structure\n\n```\njondoescoding-coding-rules/\n├── bin/\n│   └── cli.js              # Main CLI script\n├── templates/              # Rule templates directory\n│   ├── python/            # Python-specific templates\n│   │   └── llm/           # LLM development templates\n│   │       └── observability/\n│   │           └── langfuse.mdc  # LangFuse tracing guide\n│   ├── seo/               # SEO optimization templates\n│   │   ├── seo-best-practices.mdc    # SEO best practices\n│   │   ├── seo-google-rules.mdc      # Google SEO standards\n│   │   └── seo_rules.mdc             # Technical SEO strategy\n│   ├── writing/           # Content creation templates\n│   │   ├── content-curation-rule.mdc\n│   │   ├── scott-adams-writing-principles.mdc\n│   │   ├── seo-long-form-article-blueprint.mdc\n│   │   ├── tweet-interview-process.mdc\n│   │   └── twitter-thread-creation.mdc\n│   └── tasking/            # Task management templates\n│       └── task-management.mdc\n├── templates/\n│   ├── cursor-rules/        # Cursor AI rule templates\n│   │   ├── [all above templates]\n│   └── .claude/            # Claude Code configuration templates\n│       ├── memory-management.md\n│       ├── project-setup.md\n│       └── workflow-optimization.md\n├── package.json           # Package configuration\n└── README.md             # This file\n```\n\n## ➕ Adding New Templates\n\n### 1. Create Template File\n\nCreate a new `.mdc` file in the `templates/` directory. You can organize templates in nested folders:\n\n```bash\n# Root level template\ntouch templates/your-template-name.mdc\n\n# Nested template (creates folder structure automatically)\nmkdir -p templates/category/subcategory\ntouch templates/category/subcategory/your-template.mdc\n```\n\n### 2. Template Format\n\nFollow this structure for your template:\n\n```markdown\n---\ndescription: Brief description of what this rule does\nglobs: [\"**/*.ext\", \"**/*.pattern\"]\nalwaysApply: false\n---\n\n# Your Rule Title\n\n## Section 1: Standards\nYour coding standards here...\n\n## Section 2: Best Practices\nBest practices specific to this technology...\n\n## Section 3: Examples\n```language\n// Good example\nconst goodExample = () =\u003e {\n  // Implementation\n};\n\n// Avoid\nconst badExample = () =\u003e {\n  // What not to do\n};\n```\n\n### 3. Frontmatter Configuration\n\n| Field | Description | Example |\n|-------|-------------|---------|\n| `description` | Brief description of the rule's purpose | `\"React development standards\"` |\n| `globs` | File patterns where this rule applies | `[\"**/*.tsx\", \"**/*.jsx\"]` |\n| `alwaysApply` | Whether to apply to all files regardless of globs | `false` (recommended) |\n\n### 4. Template Content Guidelines\n\n**Include These Sections:**\n- 📝 **Code Style**: Formatting, naming conventions, structure\n- 🏗️ **Architecture**: Patterns, organization, best practices  \n- 🔒 **Security**: Security considerations and practices\n- ⚡ **Performance**: Optimization tips and patterns\n- 🧪 **Testing**: Testing approaches and examples\n- 📖 **Examples**: Clear good vs bad code examples\n\n**Template Example:**\n\n```markdown\n---\ndescription: Python development standards with Django\nglobs: [\"**/*.py\", \"django/**/*\"]\nalwaysApply: false\n---\n\n# Python + Django Development Rules\n\n## Code Style\n- Follow PEP 8 style guidelines\n- Use type hints for function parameters and return values\n- Maximum line length of 88 characters (Black formatter)\n- Use descriptive variable and function names\n\n## Django Best Practices\n- Use Django's built-in authentication system\n- Implement proper model validation\n- Use Django forms for data validation\n- Follow the Model-View-Template pattern\n\n## Examples\n```python\n# Good\nfrom typing import Optional\nfrom django.contrib.auth.models import User\n\ndef get_user_profile(user_id: int) -\u003e Optional[User]:\n    try:\n        return User.objects.get(id=user_id)\n    except User.DoesNotExist:\n        return None\n\n# Avoid\ndef get_user_profile(user_id):\n    return User.objects.get(id=user_id)  # No error handling\n```\n\n## 🔧 Development \u0026 Customization\n\n### Local Development\n\n```bash\n# Clone and setup  \ngit clone https://github.com/jondoescoding/jondoescoding-coding-rules.git\ncd jondoescoding-coding-rules\nnpm install\n\n# Test locally\nnode bin/cli.js --list\nnode bin/cli.js typescript\n```\n\n### Publishing Your Own Version\n\n1. **Fork this repository**\n2. **Customize templates** in the `templates/` directory\n3. **Update package.json** with your package name:\n   ```json\n   {\n     \"name\": \"your-custom-coding-rules\",\n     \"description\": \"Your team's cursor rules\",\n     \"author\": \"Your Name\"\n   }\n   ```\n4. **Publish to npm**:\n   ```bash\n   npm publish\n   ```\n5. **Share with your team**:\n   ```bash\n   npx your-custom-coding-rules --all\n   ```\n\n### Customizing for Your Team\n\nCreate organization-specific rules:\n\n```bash\n# Example: Create a company-wide rule set with categories\ntemplates/\n  \n├── api/\n│   ├── rest.mdc             # REST API conventions\n│   └── graphql.mdc         # GraphQL patterns\n├── testing/\n│   ├── unit.mdc            # Unit testing standards\n│   └── integration.mdc     # Integration testing\n└── python/\n    ├── fastapi.mdc         # FastAPI patterns\n    └── llm/\n        └── langchain.mdc   # LangChain standards\n```\n\n## 🔍 How It Works\n\n1. **CLI Detection**: The tool checks for existing `.cursor/rules/` directory\n2. **Auto-Creation**: Creates the directory if it doesn't exist\n3. **Template Copy**: Copies selected templates from `templates/` to `.cursor/rules/`\n4. **Cursor Integration**: Cursor AI automatically loads rules from this directory\n5. **Smart Application**: Rules apply only to files matching their glob patterns\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/new-template`\n3. Add your template following the guidelines above\n4. Test locally: `node bin/cli.js your-template`\n5. Submit a pull request\n\n### Template Contribution Guidelines\n\n- ✅ Include comprehensive examples\n- ✅ Cover both good and bad practices\n- ✅ Use appropriate glob patterns\n- ✅ Test with actual Cursor AI\n- ✅ Document any special considerations\n\n## 📄 License\n\nMIT License - see LICENSE file for details.\n\n## 🆘 Support\n\n- 🐛 **Issues**: Report bugs via GitHub Issues\n- 💡 **Feature Requests**: Submit via GitHub Issues\n- 📖 **Documentation**: Check this README and template examples\n- 💬 **Questions**: Start a GitHub Discussion\n\n## 🎉 Acknowledgments\n\nInspired by [CitrusRules](https://github.com/jakerains/citrusrules) and the Cursor AI community's effort to improve AI-assisted development through better context and standards.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjondoescoding%2Fjondoescoding-coding-rules","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjondoescoding%2Fjondoescoding-coding-rules","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjondoescoding%2Fjondoescoding-coding-rules/lists"}