Skip to main content

​
Overview

We use AI coding assistants (Claude Code, GitHub Copilot) to develop faster. This guide covers the basics.

​
Quick Start

​
Simple Rules

  1. Give credit - Add co-author to commits with AI code
  2. Be transparent - Note what AI generated in PRs
  3. Review everything - You own the code
  4. Use common sense - Be careful with auth, payments, sensitive data

​
Co-Author Attribution

When AI helps write code, add this to your commit: 
git commit -m "feat: Add customer export API

Made with Claude

Co-Authored-By: Claude <noreply@anthropic.com>"
Why: Tracks AI usage in Swarmia.

​
PR Template

Include a simple AI section in your PRs: 
## AI Assistance
Used Claude to generate:
- Customer export models and serializers
- Basic tests

Manually added:
- Permission logic
- Complex validation
See the full PR template.

​
When to Be Careful

Think twice before using AI for:
  • Authentication/authorization
  • Payment processing
  • PII/customer data handling
  • Production infrastructure
When in doubt, ask a senior developer.

​
Guidelines

Always check AI-generated code for:
  • Hard-coded secrets
  • Proper input validation
  • SQL injection prevention
  • Authentication checks
You own all code you commit:
  • Read through AI-generated code
  • Understand what it does
  • Test it thoroughly
  • Make sure it follows our patterns
Use AI to accelerate:
  • Boilerplate code (models, serializers)
  • Standard CRUD operations
  • Unit tests
  • Documentation
  • Common patterns

​
Resources

Best Practices

Code quality and security guidelines

Workflow Guide

Daily development workflow with AI

Prompt Templates

Copy-paste prompts for common tasks

AI Development Repo

Agent files and detailed docs

​
Agent Files

Role-specific AI agent configurations:

​
Getting Help

  • Questions? Ask in team chat
  • Unsure? Talk to a senior developer
  • Issues? Create an issue in the AI development repo
Remember: We’re learning together. Start simple, be transparent, and we’ll refine our approach as we go.