Skip to content

🚀 Project Cheat Sheet: Standards & Conventions

Welcome! This cheat sheet summarizes the most important standards and conventions for contributing to this project. For full details, see the Standards & Conventions.


📚 Quick Reference Table

Task Command/Convention Example/Notes
Branch Naming launch_{number}_task_{number} launch_1_task_1
Commit Message Conventional Commits feat: add user login
Run Tests make test Uses pytest
Format Code make format Run before commit
Lint Code make lint Run before commit
Type Check make type-check
Security Check make secure

🏷️ Branch Naming

  • Pattern: launch_{number}_task_{number}
  • Example: launch_1_task_1

📝 Commit Guidelines

🔀 Pull Request (PR) Practices

✅ Testing & Quality

  • Write and pass unit tests (make test)
  • Use pytest as the test library
  • Ensure code is formatted and linted before committing

🛠️ Essential Make Commands

  • make test — Run unit tests
  • make format — Format code
  • make lint — Lint code
  • make secure — Security check
  • make type-check — Type check

📄 More Details

For comprehensive standards and conventions, see standards-conventions.md.