Skip to content

dleerdefi/claude-code-construction / skills/code-researcher

code-researcher

Verified

Researches 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).

FileKindSize
SKILL.mdskill md23.2 KB
agents/openai.yamlconfig292 B
references/discipline_notes.mdmarkdown1.9 KB
references/gap_report_template.mdmarkdown5.2 KB
references/schemas.yamlconfig14.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."
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall