Dotfiles & Development Environment Configuration

A comprehensive dotfiles repository featuring an advanced Cursor rules system, development environment configurations, and AI-assisted workflows. This repository is designed to provide a consistent, maintainable, and intelligent development environment across different contexts.

🌟 Key Features

• Advanced Cursor Rules System: Intelligent workflow automation and standardization
• Modular Configuration: Separate setups for personal and work environments
• AI-Assisted Development: Integrated AI tools and custom prompts
• Shell & Editor Setup: Comprehensive ZSH, Neovim, and VSCode configurations
• Git Workflow: Standardized commit messages and PR templates

📁 Repository Structure

.
├── .cursor/           # Cursor rules and AI workflow configurations
├── ai-stuff/          # AI-related configurations and prompts
├── bin/              # Utility scripts and tools
├── docs/             # Documentation and guides
├── makefiles/        # Modular make configurations
├── nvim/             # Neovim configuration
└── various dotfiles  # (.zshrc, .gitconfig, etc.)

🎯 Cursor Rules System

Our Cursor rules system, inspired by cursor-auto-rules-agile-workflow, provides an intelligent framework for standardizing development practices.

Rule Categories

• 000-cursor-rules: Core rule format and management
• 400-md-docs: Markdown documentation standards
• 901-commit-message: Git commit message formatting
• 902-arch: Architecture documentation standards
• 903-story: User story templates
• 904-lessons: Knowledge retention system
• 905-pr-creation: Pull request standards
• 906-prd: Product requirement documents

Rule Structure

Each rule follows a standardized format:

---
description: ACTION when TRIGGER to OUTCOME
globs: pattern to match files
tags: [categorization tags]
priority: 1-5
version: Major.Minor.Patch
---

🚀 Getting Started

1. Clone the Repository

   git clone https://github.com/yourusername/dotfiles.git
   cd dotfiles

2. Choose Your Setup

   make personal  # For personal environment
   make work     # For work environment

3. Individual Components

   make zsh      # Configure ZSH
   make nvim     # Setup Neovim
   make vscode   # Configure VSCode

🛠 Components

Git Configuration

• base.gitconfig: Common Git settings
• work.gitconfig: Work-specific configurations

Shell Environment

• .zshrc: ZSH configuration with custom plugins
• .aliases: Useful command aliases
• .functions: Custom shell functions

Development Tools

• Neovim configuration
• VSCode settings
• Lazygit setup
• Continue AI integration
• Karabiner (macOS)

🤖 AI Integration

The repository includes various AI-assisted development tools:

Cursor Prompts

• PR description generation
• Commit message standardization
• Code explanation
• Project structure analysis
• Infrastructure expertise (Terraform, Docker, GHA)

AI Tools Configuration

• Continue AI setup
• Custom AI workflows
• Memory bank system

📋 Workflow Automation

• Standardized documentation templates
• Automated rule application
• Integrated memory system for AI interactions
• Agile workflow templates

🔧 Customization

1. Shell Customization

   • Edit .zshrc for shell behavior
   • Modify .aliases for custom commands

2. Git Setup

   • Adjust base.gitconfig for common settings
   • Configure work.gitconfig for work-specific needs

3. AI Workflows

   • Customize prompts in ai-stuff/cursor/prompts
   • Modify rule templates in .cursor/rules

📚 Documentation

• Check docs/ for detailed guides
• Review .cursor/rules/*.mdc for workflow standards

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines and follow our commit message conventions (see rule 901-commit-message).

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Note: This repository is continuously evolving. Check the CHANGELOG.md for recent updates and improvements.