|
| 1 | +# AI Engineering Maintenance Bot Identity |
| 2 | + |
| 3 | +This document defines the visual and textual identity of the **AI Engineering Maintenance Bot** (aieng-bot-maintain). |
| 4 | + |
| 5 | +## Bot Name |
| 6 | +**AI Engineering Maintenance Bot** (short: `aieng-bot-maintain`) |
| 7 | + |
| 8 | +## Purpose |
| 9 | +Automated maintenance bot for Vector Institute repositories that: |
| 10 | +- Auto-merges Dependabot PRs when all checks pass |
| 11 | +- Automatically fixes common issues in failing Dependabot PRs |
| 12 | +- Maintains code quality and security standards |
| 13 | + |
| 14 | +## Visual Identity |
| 15 | + |
| 16 | +### Avatar Specifications |
| 17 | +The bot should have a professional, technical avatar that represents: |
| 18 | +- **Theme**: AI + Engineering + Maintenance |
| 19 | +- **Style**: Modern, clean, geometric |
| 20 | +- **Colors**: Vector Institute brand colors (if available), or: |
| 21 | + - Primary: Deep blue (#1E3A8A) - representing reliability and trust |
| 22 | + - Secondary: Green (#10B981) - representing automated fixes and success |
| 23 | + - Accent: Orange (#F59E0B) - representing active maintenance |
| 24 | +- **Elements**: Consider incorporating: |
| 25 | + - A wrench or gear (maintenance) |
| 26 | + - A robot or AI symbol |
| 27 | + - Code brackets or technical elements |
| 28 | + - Vector Institute logo elements (if permitted) |
| 29 | + |
| 30 | +### Avatar Design Concepts |
| 31 | + |
| 32 | +#### Option 1: Minimalist Robot |
| 33 | +A simple, geometric robot icon with: |
| 34 | +- Circular head with friendly "eyes" (two dots or simple shapes) |
| 35 | +- Wrench or tools as "arms" or accessories |
| 36 | +- Clean lines, flat design |
| 37 | +- Primary colors: blue and green |
| 38 | + |
| 39 | +#### Option 2: Abstract Technical |
| 40 | +An abstract representation combining: |
| 41 | +- Overlapping geometric shapes suggesting AI/automation |
| 42 | +- Subtle gear or mechanical elements |
| 43 | +- Gradient from blue to green |
| 44 | +- Modern, professional appearance |
| 45 | + |
| 46 | +#### Option 3: Badge Style |
| 47 | +A circular badge design with: |
| 48 | +- "AI" or robot symbol in the center |
| 49 | +- Wrench or tool crossed behind |
| 50 | +- Border with subtle technical patterns |
| 51 | +- Vector Institute affiliation indication |
| 52 | + |
| 53 | +### Creating the Avatar |
| 54 | +To create the avatar, you can: |
| 55 | + |
| 56 | +1. **Use AI Image Generation** (recommended): |
| 57 | + - Tool: DALL-E, Midjourney, or Stable Diffusion |
| 58 | + - Prompt example: "Minimalist flat design robot icon for software maintenance bot, geometric shapes, blue and green colors, wrench symbol, professional tech company style, circular avatar, clean lines, white background" |
| 59 | + |
| 60 | +2. **Use Design Tools**: |
| 61 | + - Figma, Adobe Illustrator, or Canva |
| 62 | + - Start with geometric shapes |
| 63 | + - Keep it simple and scalable |
| 64 | + - Export as PNG (512x512px minimum) or SVG |
| 65 | + |
| 66 | +3. **Commission a Designer**: |
| 67 | + - Provide these specifications |
| 68 | + - Request multiple format exports (PNG, SVG) |
| 69 | + - Ensure rights for use in open-source context |
| 70 | + |
| 71 | +### Current Avatar |
| 72 | +The bot uses the **Vector Institute logo** as its avatar: |
| 73 | +- `.github/bot-assets/avatar.webp` - WebP format (primary) |
| 74 | +- `.github/bot-assets/avatar.svg` - SVG vector format |
| 75 | + |
| 76 | +This ensures consistent branding with Vector Institute across all bot interactions. |
| 77 | + |
| 78 | +## Textual Identity |
| 79 | + |
| 80 | +### Bot Signature |
| 81 | +All bot comments, commits, and messages should include this signature: |
| 82 | + |
| 83 | +```markdown |
| 84 | +--- |
| 85 | +🤖 *AI Engineering Maintenance Bot - Maintaining Vector Institute Repositories built by AI Engineering* |
| 86 | +``` |
| 87 | + |
| 88 | +### Git Commit Identity |
| 89 | +``` |
| 90 | +Name: aieng-bot-maintain[bot] |
| 91 | +Email: aieng-bot@vectorinstitute.ai |
| 92 | +``` |
| 93 | + |
| 94 | +### Co-author Tag |
| 95 | +``` |
| 96 | +Co-authored-by: AI Engineering Maintenance Bot <aieng-bot@vectorinstitute.ai> |
| 97 | +``` |
| 98 | + |
| 99 | +## Communication Style |
| 100 | + |
| 101 | +### Tone |
| 102 | +- **Professional** but friendly |
| 103 | +- **Clear and concise** |
| 104 | +- **Informative** without being verbose |
| 105 | +- **Helpful** and action-oriented |
| 106 | + |
| 107 | +### Message Patterns |
| 108 | + |
| 109 | +#### Success Messages |
| 110 | +``` |
| 111 | +✅ [Action completed successfully] |
| 112 | +
|
| 113 | +[Brief explanation of what was done] |
| 114 | +
|
| 115 | +--- |
| 116 | +🤖 *AI Engineering Maintenance Bot - Maintaining Vector Institute Repositories built by AI Engineering* |
| 117 | +``` |
| 118 | + |
| 119 | +#### Working/In-Progress Messages |
| 120 | +``` |
| 121 | +🔧 [Action in progress] |
| 122 | +
|
| 123 | +[Brief explanation of what's being done] |
| 124 | +
|
| 125 | +--- |
| 126 | +🤖 *AI Engineering Maintenance Bot - Maintaining Vector Institute Repositories built by AI Engineering* |
| 127 | +``` |
| 128 | + |
| 129 | +#### Warning/Error Messages |
| 130 | +``` |
| 131 | +⚠️ [Issue description] |
| 132 | +
|
| 133 | +[Explanation of the issue] |
| 134 | +[What actions can be taken] |
| 135 | +
|
| 136 | +--- |
| 137 | +🤖 *AI Engineering Maintenance Bot - Maintaining Vector Institute Repositories built by AI Engineering* |
| 138 | +``` |
| 139 | + |
| 140 | +#### Informational Messages |
| 141 | +``` |
| 142 | +ℹ️ [Information title] |
| 143 | +
|
| 144 | +[Details] |
| 145 | +
|
| 146 | +--- |
| 147 | +🤖 *AI Engineering Maintenance Bot - Maintaining Vector Institute Repositories built by AI Engineering* |
| 148 | +``` |
| 149 | + |
| 150 | +### Emoji Usage |
| 151 | +Use emojis sparingly and consistently: |
| 152 | +- ✅ Success, approval, completion |
| 153 | +- ❌ Failure, error, rejection |
| 154 | +- 🔧 Working on fixes, maintenance |
| 155 | +- ⚠️ Warning, caution needed |
| 156 | +- ℹ️ Information, FYI |
| 157 | +- 🎉 Celebration (for merges) |
| 158 | +- 🤖 Bot signature |
| 159 | + |
| 160 | +## GitHub Profile Setup |
| 161 | + |
| 162 | +### Profile Configuration (if using GitHub App) |
| 163 | +- **Name**: AI Engineering Maintenance Bot |
| 164 | +- **Username**: `aieng-bot-maintain` |
| 165 | +- **Description**: Automated maintenance bot for Vector Institute AI Engineering repositories. Auto-merges PRs and fixes common issues. |
| 166 | +- **Website**: Link to this repository or Vector Institute website |
| 167 | +- **Avatar**: Use the designed avatar image |
| 168 | + |
| 169 | +### Repository Configuration |
| 170 | +In the repository settings (`.github/settings.yml` if using probot/settings): |
| 171 | +```yaml |
| 172 | +repository: |
| 173 | + name: aieng-bot-maintain |
| 174 | + description: AI Engineering Maintenance Bot for Vector Institute repositories |
| 175 | + homepage: https://github.com/VectorInstitute/aieng-bot-maintain |
| 176 | + topics: |
| 177 | + - automation |
| 178 | + - github-actions |
| 179 | + - dependabot |
| 180 | + - maintenance-bot |
| 181 | + - ai-engineering |
| 182 | +``` |
| 183 | +
|
| 184 | +## Branding Consistency |
| 185 | +
|
| 186 | +### Across All Platforms |
| 187 | +Ensure consistency in: |
| 188 | +1. **Naming**: Always use "AI Engineering Maintenance Bot" or "aieng-bot-maintain" |
| 189 | +2. **Avatar**: Same image across GitHub, documentation, etc. |
| 190 | +3. **Signature**: Always include the standard signature in bot communications |
| 191 | +4. **Email**: Always use `aieng-bot@vectorinstitute.ai` |
| 192 | +5. **Color scheme**: Maintain the blue/green/orange palette in any visual materials |
| 193 | + |
| 194 | +## License and Attribution |
| 195 | +- The bot identity should reflect that it's maintained by Vector Institute's AI Engineering team |
| 196 | +- All bot communications should maintain professional standards |
| 197 | +- Attribution to Vector Institute should be clear and consistent |
0 commit comments