OctaCard Vibe-coding Rules

How to contribute to OctaCard via vibe-coding

How does it work?

Describe what you want in a GitHub issue. AI coding tools pick up these issues and write the code automatically.

How to create an issue

1. Go to OctaCard Issues.
2. Click New issue and choose the Vibe-coded Feature template (or Bug report for fixes).
3. Fill out the template as clearly as you can:
   • Feature name – A short, clear title
   • Describe the solution you'd like – What should the feature do?
   • The problem – What are you trying to do? What blocks or annoys you?
   • Navigation – Step-by-step: how would a user find and use this feature?
4. Submit the issue. The ai:fix label is added automatically.

What happens next?

AI tools process new issues roughly every 30 minutes. When your issue is picked up, an implementation will be proposed (usually as a pull request). The maintainer will review it and merge if it looks good, or discuss further with you in the issue.

Tips for better results

• Be specific about the problem and the desired behavior.
• Include step-by-step navigation so the AI understands the user flow.
• For bug reports, include what you expected vs. what actually happened.