dleerdefi/claude-code-construction / skills/code-researcher
code-researcher
VerifiedResearches which building codes, accessibility standards and authority requirements (health department, fire marshal, state agency) apply to a scope or spec section, and which the project documents miss. Use for 'what codes apply', 'code check', 'ADA requirements', 'egress', 'health department'. Not for reading what the drawings or specs say (construction-guide).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 23.2 KB |
| agents/openai.yaml | config | 292 B |
| references/discipline_notes.md | markdown | 1.9 KB |
| references/gap_report_template.md | markdown | 5.2 KB |
| references/schemas.yaml | config | 14.7 KB |
references/schemas.yaml
View on GitHub# Code Researcher Output Schemas
# JIT-loaded per phase step — see SKILL.md for when each is used
# Each section is delimited and named for reference from SKILL.md
#
# The filled-in values below are illustrative. Bracketed values such as
# "[code] §[section]" are placeholders for what your research verified.
# Never copy a section number, threshold or regulation name from this file
# into a finding; every citation in your output comes from a source you read.
# ═══════════════════════════════════════════════════════════════
# PHASE 1a — Project Context
# Write to: .construction/skills/code-researcher/project_context.yaml
# ═══════════════════════════════════════════════════════════════
project_context:
project_name: ""
location:
address: ""
city: ""
county: ""
state: ""
occupancy_group: "" # IBC occupancy group(s), e.g. E, B, A-2, I-2
construction_type: "" # IBC construction type, e.g. Type IIA, VB
project_type: "" # new construction | renovation | addition | change of use
building_height_stories: 0
building_gross_area_sf: 0
sprinklered: null # true | false | partial | unknown
year_of_design: "" # infer from drawing date — determines code edition
ahj: # Authority Having Jurisdiction
building_department: ""
fire_marshal: ""
contact: "" # if found in docs
# ═══════════════════════════════════════════════════════════════
# PHASE 1b — Scope Definition
# Write to: .construction/skills/code-researcher/scope_definition.yaml
# ═══════════════════════════════════════════════════════════════
scope_definition:
research_question: "Are there code requirements for resinous flooring that we haven't addressed?"
target_scope:
spec_sections:
- "09 67 23" # primary section
- "09 65 00" # related sections if relevant
drawing_sheets: [] # specific sheets if named
systems: [] # systems if question is system-based
scope_packages: ["Scope C"] # if engineer uses package designations
engineer_scopes: ["A", "B", "C"] # all scopes the engineer manages
research_topics:
# Generated from the target scope and project context — not hardcoded
# These are discovered, not prescribed
- slug: ""
title: ""
description: ""
driven_by: "" # what about the scope triggers this topic
# ═══════════════════════════════════════════════════════════════
# PHASE 2b — Pass 1 Project Inventory
# Write to: .construction/skills/code-researcher/pass1_project_inventory.yaml
# ═══════════════════════════════════════════════════════════════
pass1_project_inventory:
source_documents_read:
- path: "specs/09_67_23_resinous_flooring.pdf"
type: "spec_section"
section: "09 67 23"
pages_read: "all"
code_citations_found:
- citation: "ASTM C 579"
context: "Compressive strength testing method — 09 67 23 §2.1-D-1"
edition_specified: "current"
how_cited: "test method for physical property compliance"
- citation: "ASTM F 1869"
context: "Moisture vapor emission rate testing — 09 67 23 §3.1-B-3"
edition_specified: null
how_cited: "substrate acceptance criterion (max 7 lb/1000 sf/24hr)"
- citation: "ACI 503R"
context: "Bond strength requirement — 09 67 23 §2.1-D-10"
edition_specified: null
how_cited: "bond strength test method (400 psi minimum)"
requirements_stated:
- topic: "installer qualification"
requirement: "Certified in writing by resinous flooring manufacturer"
source: "09 67 23 §1.3-B-1"
code_basis: null # project-imposed requirement, not code-derived
- topic: "substrate preparation"
requirement: "Shot-blast surfaces per manufacturer instructions"
source: "09 67 23 §3.1-B-1-a"
code_basis: null
- topic: "vapor barrier"
requirement: "Vapor barrier must be present for slabs on or below grade"
source: "09 67 23 §1.5-C"
code_basis: null
- topic: "slip resistance"
requirement: null # NOT FOUND in spec — this becomes a potential gap
source: null
code_basis: null
note: "No slip resistance requirement found in 09 67 23 or related sections"
topics_not_addressed:
# Pre-populate this during extraction — anything the researcher expects
# to see in a spec section of this type but didn't find
- "slip resistance / coefficient of friction"
- "VOC content limitations"
- "health department requirements"
- "fire classification / flame spread"
# ═══════════════════════════════════════════════════════════════
# PHASE 2c — Pass 1 Summary (flat inventory for gap diffing)
# Write to: .construction/skills/code-researcher/pass1_summary.yaml
# ═══════════════════════════════════════════════════════════════
pass1_summary:
topics_addressed:
compressive_strength:
addressed: true
by: "ASTM C 579 cited in 09 67 23 §2.1-D-1"
gap_risk: low
moisture_testing:
addressed: true
by: "ASTM F 1869 and ASTM F 2170 both cited"
gap_risk: low
installer_qualification:
addressed: true
by: "Manufacturer written cert required per §1.3-B-1"
gap_risk: low
slip_resistance:
addressed: false
by: null
gap_risk: high # food service/kitchen = high-traffic, wet, regulatory
voc_content:
addressed: false
by: null
gap_risk: medium # Div 01 may cover this globally
flame_spread:
addressed: false
by: null
gap_risk: medium
health_department_overlay:
addressed: false
by: null
gap_risk: high # kitchen complex = AHJ may include health dept
# ═══════════════════════════════════════════════════════════════
# PHASE 3a — Jurisdiction and Adopted Codes
# Write to: .construction/skills/code-researcher/jurisdiction.yaml
# ═══════════════════════════════════════════════════════════════
jurisdiction:
state: ""
jurisdiction: ""
adopted_codes:
building_code:
name: "" # IBC, or state-specific (CBC, NYC Building Code, etc.)
edition: 0 # year, e.g. 2021
adoption_date: ""
state_amendments: ""
local_amendments: ""
source: "" # URL where this was verified
fire_code:
name: ""
edition: 0
source: ""
accessibility:
federal: "ADA 2010 Standards"
state_code: "" # if state has additional requirements
exceeds_ada: null
source: ""
referenced_standards:
# Which editions of NFPA, ANSI, ASCE, etc. are adopted
# via the building code reference chain
- name: ""
edition: 0
adopted_via: "" # e.g. "IBC 2021 Chapter 35"
confidence: "" # confirmed | inferred | uncertain
confidence_notes: ""
# ═══════════════════════════════════════════════════════════════
# PHASE 3b — Per-Topic Research Findings
# Write to: .construction/skills/code-researcher/topics/{slug}.yaml
# ═══════════════════════════════════════════════════════════════
topic_findings:
topic: "Slip Resistance"
research_findings:
- code: "[accessibility standard, e.g. ADA 2010 Standards]"
section: "[section number as verified]"
requirement: "[requirement text quoted or closely paraphrased from the source]"
specific_to_this_scope: true
edition_confirmed: false # true only after you confirmed the adopted edition
source_url: "[URL or document you read]"
- code: "[building code and edition adopted by the jurisdiction]"
section: "[section number as verified]"
requirement: "[requirement text; include any numeric threshold exactly
as the source states it]"
specific_to_this_scope: true
edition_confirmed: false
source_url: ""
- code: "[test standard, e.g. ANSI A137.1 DCOF]"
section: null
requirement: "[what the standard measures and the threshold it sets, if any]"
specific_to_this_scope: true
edition_confirmed: false
source_url: ""
note: "[status of the standard (current, withdrawn, superseded) and
whether it applies to this floor system type]"
- code: "[state or local health regulation, if a food service area is in scope]"
section: null
requirement: "[requirement text as verified]"
specific_to_this_scope: true
edition_confirmed: false
source_url: ""
note: "[which rooms or areas in the scope trigger this regulation]"
applicable_test_standards:
- "[test standard and the material type it applies to]"
- "[note when no industry standard exists for the specified system and
manufacturer test data is the only source]"
gaps_identified:
- "No COF or slip resistance requirement in 09 67 23"
- "No test method for slip resistance specified"
- "No mention of food service/health department requirements despite
scope including kitchen complex"
# ═══════════════════════════════════════════════════════════════
# PHASE 4a — Gap Analysis
# Write to: .construction/skills/code-researcher/gap_analysis.yaml
# ═══════════════════════════════════════════════════════════════
gap_analysis:
gaps:
- id: "GAP-001"
topic: "Slip Resistance"
severity: HIGH
confidence: confirmed
code_requirement:
code: "[code and edition] §[section]" # as verified in topic_findings
text: "[requirement text, with any threshold exactly as the source states it]"
project_status:
addressed: false
in_documents: null
note: "09 67 23 specifies physical properties (compressive strength,
bond strength, hardness) but contains no COF or slip resistance
requirement. No reference to slip resistance test method."
recommended_action: "Add COF requirement to 09 67 23 §2.1 System
Characteristics and specify test method. Verify with
manufacturer what COF their system achieves wet."
engineer_action_required: true
pe_decision_required: false # factual gap, not an interpretation
- id: "GAP-002"
topic: "Health Department Requirements — Kitchen Complex"
severity: HIGH
confidence: needs_review
code_requirement:
code: "[state health department regulation, as verified]"
text: "[requirement text as verified]"
project_status:
addressed: false
in_documents: null
note: "Kitchen complex (Rooms 1411–1419) is within the resinous flooring
scope. No reference to health department requirements found in
09 67 23 or in the project manual."
recommended_action: "Confirm with Owner whether food service permit is
required. If yes, coordinate with health department
AHJ on floor system acceptability before spec is
finalized."
engineer_action_required: true
pe_decision_required: true # requires AHJ coordination
- id: "GAP-003"
topic: "VOC Content Limitations"
severity: MEDIUM
confidence: confirmed
code_requirement:
code: "[VOC regulation adopted for the project] (via Section 01 61 16)"
text: "VOC content of floor coatings shall comply with applicable
regulations"
project_status:
addressed: partial
in_documents: "Spec 01 61 16 — VOC Content Restrictions references
limits; 09 67 23 §1.5-C references vapor barrier but
does not reference 01 61 16 or state VOC limits"
note: "Division 01 likely covers this globally. Confirm that 09 67 23
is governed by 01 61 16 and that the resinous system products
meet those limits."
recommended_action: "Add cross-reference to Section 01 61 16 in 09 67 23
§1.1 or §1.5. Confirm manufacturer's VOC data for
the specified system against limits in 01 61 16."
engineer_action_required: false
pe_decision_required: false
already_addressed:
- topic: "Moisture Vapor Emission Testing"
addressed_by: "ASTM F 1869 and ASTM F 2170 both cited in §3.1-B-3 with
specific limits (7 lb/1000 sf/24hr and 85% RH)"
confidence: confirmed
note: "Well covered. Both test methods included."
- topic: "Substrate Preparation"
addressed_by: "Shot-blast requirement per §3.1-B-1-a; self-priming
noted; patching material specified"
confidence: confirmed
uncertain:
- topic: "[Local jurisdiction] Amendments to Slip Resistance"
note: "Could not confirm whether [local jurisdiction] has local amendments
that modify [code] §[section]. Recommend confirming with building
department AHJ."
recommended_action: "Call the [local jurisdiction] building department or
consult the project architect, who should have local
amendment knowledge."Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |