---
name: dna-assembly
description: Guidance for DNA assembly tasks including Golden Gate assembly, Gibson assembly, and restriction enzyme-based cloning. This skill should be used when designing primers for Type IIS restriction enzymes (BsaI, BsmBI, etc.), creating fusion proteins, or assembling multiple DNA fragments. Covers primer structure requirements, overhang design, and verification strategies.
---

# DNA Assembly

## Overview

This skill provides procedural knowledge for DNA assembly tasks, particularly Golden Gate assembly using Type IIS restriction enzymes. It addresses common pitfalls in primer design and provides verification strategies to ensure correct assembly designs.

## Critical Requirements for Type IIS Restriction Enzyme Primers

### Complete Primer Structure

When designing primers for Type IIS enzymes (BsaI, BsmBI, etc.), the complete structure must include ALL components:

```
[clamp ≥1bp]-[recognition site]-[spacer N]-[4bp overhang]-[binding region 15-45bp]
```

**For BsaI-HFv2 specifically:**
```
[clamp ≥1bp]-GGTCTC-N-[4bp overhang]-[binding region]
```

**Critical: The clamp sequence is MANDATORY.** Type IIS restriction enzymes require additional nucleotides flanking the recognition site for efficient binding and cutting. Primers starting directly with the recognition sequence (e.g., `GGTCTC...`) will fail validation.

### Component Details

| Component | Requirement | Purpose |
|-----------|-------------|---------|
| Clamp | ≥1 nucleotide (typically 2-6bp) | Enzyme binding efficiency |
| Recognition site | Enzyme-specific (e.g., GGTCTC for BsaI) | Enzyme targeting |
| Spacer (N) | 1 nucleotide | Separates recognition from cut site |
| Overhang | 4bp for Golden Gate | Determines assembly order |
| Binding region | 15-45bp, Tm 50-65°C | Template specificity |

## Approach for DNA Assembly Tasks

### Step 1: Verify External Requirements First

Before implementing any primer design:

1. Look up the specific enzyme requirements from the manufacturer (NEB, Thermo, etc.)
2. Document the complete primer structure explicitly
3. Verify clamp length requirements for the specific enzyme
4. Check for any special buffer or temperature requirements

### Step 2: Parse and Validate Input Sequences

When working with input DNA sequences:

1. Parse FASTA/GenBank files correctly
2. Check for internal restriction sites that would interfere with assembly
3. Verify reading frames for fusion proteins (length divisible by 3)
4. Identify start/stop codons and determine if they need modification

### Step 3: Design Overhangs Strategically

For ordered multi-fragment assembly:

1. Choose 4bp overhangs that are unique and non-complementary
2. Avoid palindromic sequences in overhangs
3. Ensure overhangs don't create internal recognition sites when joined
4. For fusion proteins, remove stop codons between fragments

### Step 4: Calculate Binding Regions

For the template-binding portion of primers:

1. Target melting temperature (Tm) within specification (typically 50-65°C)
2. Use appropriate Tm calculation method (nearest-neighbor preferred)
3. Ensure binding region is 15-45 nucleotides
4. Check for secondary structures or primer dimers

## Verification Strategies

### Independent Validation Approach

Self-verification can encode the same incorrect assumptions. To avoid this:

1. **Test against published examples**: Find published Golden Gate primer sequences and verify the design logic produces the same structure
2. **Use external tools**: Validate primers with established tools (Benchling, SnapGene, NEB primer design tools)
3. **Check component counts**: Verify primers contain all required components by position

### Verification Checklist

```
[ ] Clamp sequence present (≥1bp before recognition site)
[ ] Recognition site correct and complete
[ ] Spacer nucleotide present after recognition site
[ ] Overhang is exactly 4bp
[ ] Binding region Tm within specification
[ ] No internal restriction sites in inserts
[ ] Overhangs are unique and non-conflicting
[ ] Frame preserved for fusion proteins
[ ] Start/stop codons handled correctly
```

### Programmatic Verification

When writing verification code:

1. Check primer structure by position, not just content
2. Verify the recognition site does NOT start at position 0
3. Confirm overhang sequences match expected assembly order
4. Calculate actual Tm using consistent method

## Common Pitfalls

### 1. Missing Clamp Sequence

**Error**: Primer starts directly with recognition site
```
WRONG: GGTCTCAAAGC...  (GGTCTC at position 0)
RIGHT: GCGGTCTCAAAGC... (clamp 'GC' before GGTCTC)
```

### 2. Incomplete Requirements Verification

**Error**: Acknowledging the need to check enzyme requirements but not following through
**Solution**: Always document the complete primer structure before writing any design code

### 3. Self-Verification Bias

**Error**: Creating verification scripts that encode the same assumptions as the design
**Solution**: Use external references or published examples to validate design logic

### 4. Ignoring Manufacturer Specifications

**Error**: Using generic enzyme knowledge instead of specific product requirements
**Solution**: Check manufacturer documentation for the specific enzyme variant (e.g., BsaI-HF**v2** vs standard BsaI)

### 5. Overhang Conflicts

**Error**: Choosing overhangs that are complementary to each other or create unintended recognition sites
**Solution**: Systematically verify all overhang pairs for compatibility

## Reusable Code Patterns

When implementing DNA assembly tasks, consider creating reusable functions for:

1. **FASTA/sequence parsing** - Avoid rewriting parsing logic multiple times
2. **Reverse complement calculation** - Standard function used throughout
3. **Melting temperature calculation** - Consistent Tm method across all primers
4. **Primer structure validation** - Single source of truth for structure requirements

## Reference Materials

For detailed enzyme specifications and protocols, consult:

- `references/golden_gate_primer_structure.md` - Complete primer structure documentation
- Manufacturer protocols (NEB, Thermo Fisher) for specific enzymes
- Published Golden Gate assembly papers for validated examples