Engineering Playbook

This repository contains the operating standards and practical references for UTech Dynamics engineering work.

Quick Start (New Team Member)

Read in this order:

1. Engineering & Release Guidelines
2. Contributing
3. Testing Roadmap

Core Standards

• Engineering & Release Guidelines
• Rails Model Spec Standards
• Contributing

Testing Standards

• Testing Roadmap
• Test Docs Index
• Rails Testing Reference
• FactoryBot: build vs create
• Rails Model Test Checklist

Workflow References

• Branching Strategy
• Thinking vs Coding Checklist
• Amend Commit Message

Related Repositories

External references under the UTech Dynamics GitHub organization:

• linters
• rails-guides-bn
• UTech-Dynamics organization

Repository Conventions

• Documentation file names use lowercase kebab-case where practical.
• Core guidance should link back to the authoritative standards files above.
• Scratchpad notes may exist, but they are not treated as canonical standards.

Contribution

Contributions are welcome.

1. Create a fork.
2. Open a pull request.