Algorütm - AI Development Prompts & Cursor Rules

A collection of production-tested AI prompts and Cursor rules, shared as part of the Prompt of the Week program.

📖 About

This repository accompanies the Algorütm podcast episode on AI in Development, where Soldera shared practical approaches to using AI in software development after nearly 2 years of hands-on experience.

Following listener requests, we're releasing our internal prompts and Cursor rules one per week to help the Estonian tech community leverage AI more effectively in their development workflows.

---

🎯 What's Inside

Current Prompts

Python Backend Development Rules (python-backend.mdc)

Contribution by Soldera

Comprehensive Flask/SQLAlchemy 2.0 guidelines with component-based architecture, Pydantic validation, RESTful API patterns, and service layer design. Includes migration strategies from legacy structures and testing best practices.

Vue 3 Frontend Guidelines (frontend-vue.mdc)

Contribution by Soldera

Vue 3.5 Composition API standards with TypeScript, Bootstrap 5, Pinia state management, and UI-based architecture. Covers component organization, Vuelidate validation, error handling, and declarative programming patterns for maintainable SPAs.

Backend Testing Guidelines (backend-testing.mdc)

Contribution by Soldera

Comprehensive backend testing strategies using unittest and BaseDBTestCase. Covers test organization, test data management, mocking external dependencies, and maintaining test isolation. Includes patterns for creating reusable test factories and fixtures.

Frontend Testing Guidelines (frontend-testing.mdc)

Contribution by Soldera

Testing standards for Vue 3 applications using spec files. Focuses on testing business logic over implementation details, organizing tests with describe blocks, and maintaining proper test isolation between test suites.

Documentation Guidelines (documentation.mdc)

Contribution by Soldera

Language-agnostic documentation standards emphasizing meaningful comments that explain "why" rather than "what". Includes guidelines for security, performance, and workaround annotations, plus principles for avoiding redundant documentation.

Frontend Documentation Guidelines (frontend-documentation.mdc)

Contribution by Soldera

TypeScript and Vue-specific documentation patterns using JSDoc. Covers function documentation with throws tags, complex type and interface documentation, Vue component annotations, and API integration documentation strategies.

Spec Management System (spec-rules.mdc)

Contribution by Soldera

Comprehensive specification-driven development workflow for managing features from planning to implementation. Includes spec templates, file organization patterns, AI-assisted implementation workflows, and domain-specific context for renewable energy GO trading platforms. Covers architecture patterns, implementation standards, and progress tracking.

---

Claude Code Conventions (.claude/ directory)

For teams using Claude Code or preferring markdown-based conventions, we've mirrored our Cursor rules in the .claude/ directory. Same battle-tested standards, different format.

Backend Conventions (backend_conventions.md)

Contribution by Soldera

Python/Flask backend patterns with SQLAlchemy 2.0, component-based architecture, service layers, Pydantic validation, RESTful API design, and migration strategies. Includes type hints, error handling patterns, and testing standards.

Frontend Conventions (frontend_conventions.md)

Contribution by Soldera

Vue 3 Composition API conventions with TypeScript, UI-based architecture, declarative programming patterns, Bootstrap 5, Pinia state management, component organization, form validation, and i18n best practices.

Testing Conventions (testing_conventions.md)

Contribution by Soldera

Comprehensive testing strategies for both backend (unittest, BaseDBTestCase) and frontend (Vitest, Vue Test Utils). Covers test organization, mocking patterns, factory functions, and testing business logic over implementation details.

Documentation Conventions (documentation_conventions.md)

Contribution by Soldera

Documentation philosophy emphasizing meaningful comments that explain "why" not "what". Includes SECURITY/PERF/WORKAROUND annotations, JSDoc patterns for TypeScript, Vue component documentation, and maintenance guidelines.

Error Handling (error_handling.md)

Contribution by Soldera

Unified error handling approach for full-stack applications. Covers logging best practices, global error handlers, structured error responses, monitoring strategies, and user-friendly error messaging patterns.

Domain Knowledge (domain_knowledge.md)

Contribution by Soldera

Business context for renewable energy GO (Guarantees of Origin) trading platform. Essential terminology in multiple languages, market participants, regulatory framework, and common misconceptions to avoid. Helps AI understand domain-specific requirements.

---

🚀 How to Use

For Cursor Users

1. Copy the rule file from .cursor/.rules/ to your project's .cursor/rules/ directory
2. Configure the glob pattern in the frontmatter (e.g., globs: **/*.py)
3. Set alwaysApply to true (for global rules) or false (for file-specific rules)
4. Cursor will automatically apply these rules when working on matching files

For Claude Code Users

1. Copy the convention files from .claude/ to your project's .claude/ directory
2. Claude Code will automatically discover and apply these conventions
3. Files are in standard markdown format for easy customization

General Use

These prompts can be adapted for:

• Other AI coding assistants (GitHub Copilot, ChatGPT, etc.)
• Team coding guidelines documentation
• Code review checklists
• Onboarding materials

---

📅 Prompt of the Week Program

Every week, we'll release a new prompt covering different aspects of AI-assisted development:

• Backend Development ✅ (Cursor + Claude Code)
• Frontend Development ✅ (Cursor + Claude Code)
• Backend Testing ✅ (Cursor + Claude Code)
• Frontend Testing ✅ (Cursor + Claude Code)
• Documentation Standards ✅ (Cursor + Claude Code)
• Spec-Driven Development ✅
• Error Handling ✅ (Claude Code)
• Domain Knowledge ✅ (Claude Code)
• DevOps & infrastructure (coming soon)
• Code review prompts (coming soon)
• And more...

Follow along on the Algorütm Facebook Group for weekly releases!

---

🤝 Contributing

These prompts reflect real-world usage at Soldera. If you have suggestions or want to share your own battle-tested prompts, feel free to:

1. Open an issue with your suggestion
2. Submit a pull request with your prompt (include attribution)
3. Share feedback on the Algorütm Discord

---

📚 Resources

• Podcast Episode: Praktilisi võtteid AI rakendamisest arenduses
• Soldera: https://www.soldera.org
• Algorütm Podcast: https://algorytm.captivate.fm

---

📜 License

These prompts are shared freely for the benefit of the developer community. Attribution to Soldera is appreciated when sharing or adapting these materials.

---

Brought to you by the Algorütm podcast and Soldera team. Making AI practical for Estonian developers, one prompt at a time. 🇪🇪