Development

Git workflow

• Default branch: main.
• Prefer small changes, reviewable commits and meaningful commit messages.
• Use Merge Requests for significant work.
• Validate with CI before deployment.

Specification workflow

Spec Kit has been evaluated positively. The desired flow is:

Engineering principles

1. Prefer simple architecture until complexity is justified.
2. Keep a clean path toward scale without prematurely implementing scale infrastructure.
3. Infrastructure should be reproducible.
4. Documentation belongs in Git.
5. Architectural decisions must be documented.
6. Design security early.
7. Never commit secrets.
8. Prefer automation over undocumented manual operations.
9. Keep commits small and reviewable.
10. Use meaningful tests.
11. Keep APIs clearly defined.
12. Avoid technology choices based only on trends.
13. AI agents follow the same engineering rules as human developers.