# Detail Knowledge Base - Master Index

**Generated:** 2026-03-05
**Total Files:** 18 | **Total Lines:** 18,305 | **Total Size:** 856 KB
**Coverage:** 498 detail files from BD Architect library + comprehensive web research

---

## How to Use This Knowledge Base

When asked to draw a detail, load files in this order:
1. **detail-drawing-mastery.md** — Standards, line weights, scales, hatching, annotation rules
2. **detail-components-reference.md** — The 87-family component palette + quick lookup table
3. **revit-detail-techniques.md** — API methods, coordinate systems, workflow sequences
4. **[Category catalog]** — Find the specific detail type below
5. **[Domain mastery]** — Building science for that detail type

---

## Category Catalogs (Your Library)

| File | Category | Details | Lines | Key Content |
|------|----------|---------|-------|-------------|
| window-details-catalog.md | Windows | 84 | 1,602 | Head/jamb/sill x window type x wall type, South FL concrete focus |
| wall-details-catalog-part1.md | Walls (A-P) | 42 | 579 | Fire-rated, shaft walls, penetrations, stucco, parapets |
| wall-details-catalog-part2.md | Walls (P-Z) | 42 | 594 | Rated partitions, storefront, exterior, demising, rooftop |
| roof-details-catalog.md | Roofs | 57 | ~1,100 | Parapets, drains, scuppers, flashings, equipment curbs |
| door-details-catalog.md | Doors | 54 | ~1,000 | HM, wood, storefront, elevator, overhead, specialty |
| misc-details-catalog.md | Floor/Stair/Fire/MEP/Site | 98 | ~1,300 | Slab, stairs, firestopping, plumbing, typical conditions |
| cabinetry-millwork-catalog.md | Cabinetry | 43 | ~500 | Base/upper/tall, ADA vanities, countertop edges |
| bathroom-details-catalog.md | Bathrooms | 44 | ~400 | Shower pans, curbs, grab bars, waterproofing |
| ceiling-details-catalog.md | Ceilings | 34 | ~300 | GWB, ACT, soffits, fire-rated, cove lighting |

---

## Component & Technique References

| File | Lines | Key Content |
|------|-------|-------------|
| **detail-drawing-playbook.md** | ~200 | **PRIMARY REFERENCE** — Step-by-step workflow, leader API, fill strategy, callout formats |
| detail-components-reference.md | ~900 | 87 detail families in 16 groups, quick lookup table, assembly recipes |
| detail-drawing-mastery.md | ~500 | Line weights, scales, hatching, annotation, common mistakes, checklist |
| revit-detail-techniques.md | 1,076 | 65+ MCP methods, 4 workflow examples, coordinate systems, insulation methods |

---

## Building Science & Domain Mastery

| File | Lines | Key Content |
|------|-------|-------------|
| building-envelope-mastery.md | 819 | Water management, air barriers, thermal bridges, FL/HVHZ, sealant design |
| interior-details-mastery.md | ~700 | AWI cabinetry, shower waterproofing, stairs/railings, fire-rated assemblies |

---

## Quick Reference: Which Files for Which Detail?

### Exterior Wall Section
1. wall-details-catalog-part1.md or part2.md (find the wall type)
2. building-envelope-mastery.md (water/air/thermal management)
3. detail-components-reference.md (component palette)
4. detail-drawing-mastery.md (line weights, hatching)
5. revit-detail-techniques.md (API workflow)

### Window Head/Jamb/Sill
1. window-details-catalog.md (find the window x wall combination)
2. building-envelope-mastery.md (flashing, sealant joints)
3. detail-components-reference.md (glazing component families)
4. revit-detail-techniques.md (API workflow)

### Door Head/Jamb/Threshold
1. door-details-catalog.md (find the door type)
2. detail-components-reference.md (framing, trim components)
3. interior-details-mastery.md (ADA clearances if applicable)

### Roof/Parapet Detail
1. roof-details-catalog.md (find the roof condition)
2. building-envelope-mastery.md (membrane, flashing, drainage)
3. wall-details-catalog-part1.md (parapet details)

### Shower/Bathroom Detail
1. bathroom-details-catalog.md (find the condition)
2. interior-details-mastery.md (waterproofing systems, grab bars)
3. detail-components-reference.md (floor drain, tile components)

### Fire-Rated Partition
1. wall-details-catalog-part1.md (1-hr/2-hr assemblies)
2. interior-details-mastery.md (UL designs, firestopping)
3. misc-details-catalog.md (fire protection category)

### Cabinetry/Millwork
1. cabinetry-millwork-catalog.md (cabinet type)
2. interior-details-mastery.md (AWI grades, ADA, hardware)
3. residential-finish-details.md (kitchen cabinets, islands, countertop edges)

### Stair Section
1. misc-details-catalog.md (stair & railing category)
2. interior-details-mastery.md (IBC vs IRC, stringer types, nosing)
3. residential-finish-details.md (residential closed/open stringer, newel, handrail)

### Ceiling Detail
1. ceiling-details-catalog.md (ceiling type)
2. interior-details-mastery.md (ACT grid, seismic, light cove)

### Residential Wood Frame Wall
1. residential-wood-frame-details.md (2x4/2x6 assemblies, connections, foundations)
2. building-envelope-mastery.md (air barrier, thermal, moisture)
3. modern-cladding-details.md (cladding system over frame)

### Deck / Porch
1. residential-finish-details.md (ledger, post, railing, porch column)

### Fireplace / Chimney
1. residential-finish-details.md (masonry, zero-clearance, gas direct-vent, chimney flashing)

### Exterior Cladding (Any System)
1. modern-cladding-details.md (rain screen, metal panel, Hardie, brick veneer, stone, stucco, EIFS, mixed transitions)
2. building-envelope-mastery.md (drainage plane, air barrier continuity)

---

## Statistics

- **Total detail files cataloged:** 498
- **Detail component families documented:** 87
- **MCP API methods mapped:** 65+
- **UL assembly designs referenced:** U305, U419, U438, U453, U465, U466, U488, V438, V488
- **Building codes covered:** IBC, IRC, FBC, HVHZ, IECC, NFPA, ADA/ANSI, AAMA, ASTM
- **Waterproofing systems documented:** Traditional mortar bed, Schluter KERDI, liquid-applied membrane
- **Construction systems covered:** Wood frame, steel stud, CMU, concrete, curtain wall, storefront, rain screen, metal panel, fiber cement, brick veneer, stone veneer, stucco, EIFS
- **Residential detail types added:** 28 (kitchen, bath, stair, fireplace, deck, garage, exterior trim)
- **Cladding systems documented:** 7 (rain screen, metal panel, fiber cement, brick veneer, stone veneer, stucco/EIFS, mixed transitions)

---

## Gap Analysis

### Categories with Strong Coverage (UPDATED)
- Windows (84 details, South FL concrete + general)
- Walls (84 details, fire-rated + exterior + residential wood frame)
- Roofs (57 details, commercial + residential)
- Doors (54 details, commercial/storefront)
- Residential wood frame (walls, floors, roofs, foundations, connections) -- NEW
- Modern cladding (7 systems fully documented) -- NEW
- Residential finishes (28 detail types) -- NEW

### Remaining Gaps (minor)
- Revolving/automatic door assemblies
- Green roof / vegetated assembly details
- Curtain wall structural details (thermal breaks, anchors)
- Pool/spa construction details

### Recommended Next Steps
1. Extract actual element data from .rvt files via Revit MCP (line coordinates, component placements)
2. Build template JSON files for common detail types (parameterized for reuse)
3. Test drawing a detail end-to-end using the API workflow
