---
id: kb-005
title: Project Alignment - Quick Reference
scope:
  type: project
  id: 4sgm
purpose: alignment-quick-reference
tags:
  - infrastructure
  - alignment
  - quick-reference
topics:
  - engineering
version: 1
created: 2025-11-26
updated: 2025-11-26
author: droid-agent
status: final
related_ids:
  - kb-002
external_refs: []
---

# Project Alignment - Quick Reference

## 🔴 Critical Gaps (Fix First)

| Item | atomsAgent | atoms-mcp-prod | Action |
|------|------------|----------------|--------|
| **fastmcp** | 0.11.0 🔴 | 2.13.1+ 🟢 | Upgrade atomsAgent |
| **Python** | 3.11-3.14 🟡 | 3.12 🟢 | Pin to 3.12 |
| **Coverage** | None 🔴 | 95% 🟢 | Add threshold |
| **Artifacts** | No 🔴 | Yes 🟢 | Add upload |

## ⚡ Quick Comparison

### Frameworks
- **atomsAgent:** FastAPI (REST)
- **atoms-mcp-prod:** FastMCP (MCP)

### CI/CD
- **atomsAgent:** Basic GitHub Actions
- **atoms-mcp-prod:** Enhanced with reporting & artifacts

### Quality
- **Linter:** Ruff (both)
- **Type Check:** MyPy (both)

## 📋 Migration Paths

### Option A: Fast Track
- Upgrade fastmcp
- Pin Python
- Add coverage CI

### Option B: Balanced (Recommended)
- Option A + Enhanced reporting + Config alignment

### Option C: Complete
- Option B + Full documentation + Team training
