From cf2d6ad5ff4cf372ec3069c6f5c21a0f496afc9f Mon Sep 17 00:00:00 2001 From: Pawel Date: Sun, 28 Jun 2026 20:40:16 +0200 Subject: [PATCH 1/3] =?UTF-8?q?feat(steel-detailer-us):=20bolt-length-from?= =?UTF-8?q?-grip=20skill=20(RCSC=202020=20=C2=A72.7=20+=20Table=20C-2.2)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fills the one clear free-source gap in the public US AISC connection-detailing agent: how to size a high-strength bolt's LENGTH from the grip. Every other §J bolt rule (spacing/edge/holes/pretension/washers/bearing-tearout/block-shear) was already skilled; bolt length was not. New skill skills/bolt-length-and-grip.md, strictly free-source and cited the same way as the rest of the agent (rule -> condition -> source + verbatim quote, refuse-when-unsourced): - Grip = total thickness of the connected plies, excl. washers/DTIs (RCSC 2020 Glossary). - Normative length requirement: length shall achieve sufficient thread engagement (RCSC 2020 §2.7 + Glossary "Sufficient Thread Engagement"). - Selection method: length = grip + add-to-grip value, rounded to 1/4 in. (1/2 in. over 6 in.); +5/32 in. per flat washer, +5/16 in. per beveled washer (RCSC 2020 Commentary §2.7, Table C-2.2). - The more extensive add-to-grip TABLE = AISC Manual Table 7-18 (Carter 1996) — paid; cited by reference only, never reproduced (matches the agent's scope-and-citation copyright posture). All quotes verified against the genuine RCSC 2020 PDF (boltcouncil.org). Also adds 4 matching lookup rules to rules/aisc-360-22.json (66 -> 70) and lists the skill in manifest.yaml; agent version 0.2.0 -> 0.3.0. `aware agent validate` passes; skill installs, indexes, and renders. --- .../steel-detailer-us/manifest.yaml | 5 +- .../steel-detailer-us/rules/aisc-360-22.json | 44 ++++++++++++++- .../skills/bolt-length-and-grip.md | 53 +++++++++++++++++++ 3 files changed, 98 insertions(+), 4 deletions(-) create mode 100644 20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md diff --git a/20-agents/aeco/engineering/steel-detailer-us/manifest.yaml b/20-agents/aeco/engineering/steel-detailer-us/manifest.yaml index 2f217db6e..d9431902e 100644 --- a/20-agents/aeco/engineering/steel-detailer-us/manifest.yaml +++ b/20-agents/aeco/engineering/steel-detailer-us/manifest.yaml @@ -1,5 +1,5 @@ agent: steel-detailer-us -version: 0.2.0 +version: 0.3.0 sdk-target: aisc-360-22 # the code edition these rules are sourced from display-name: Steel Detailer — US (AISC) @@ -14,7 +14,7 @@ description: | ("no verified source") rather than guessing. Covers bolted + welded connection geometry and the governing limit states (edge distance, spacing, hole types, weld sizing, block shear), drawing & detailing conventions (AISC 303), - materials/sections, and a deterministic lookup command backed by a 66-rule + materials/sections, and a deterministic lookup command backed by a 70-rule verified JSON database. US/AISC only — never mix with Eurocode (that is the separate steel-detailer-uk agent). @@ -93,6 +93,7 @@ skills: - bolt-bearing-tearout.md - bolt-pretension-and-joint-types.md - bolt-washers.md + - bolt-length-and-grip.md - weld-fillet-sizing.md - weld-length-and-pjp.md - connecting-elements-block-shear.md diff --git a/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json b/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json index 36adcfaec..d39d3611e 100644 --- a/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json +++ b/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json @@ -1,8 +1,8 @@ { "agent": "steel-detailer-us", "standard": "aisc-360-22", - "version": "1.0.0", - "last_verified": "2026-06-14", + "version": "1.1.0", + "last_verified": "2026-06-28", "sources": [ "AISC 360-22 (free — aisc.org/standards)", "RCSC 2020 (free — boltcouncil.org)", @@ -320,6 +320,46 @@ "source_quote": "The specified minimum pretensions … are based on 70 percent of the tensile strength … rounded to the nearest kip", "found": true }, + { + "id": "bolt.length.grip", + "category": "bolts", + "rule": "Grip (basis for bolt-length selection)", + "value": "Total thickness of the connected plies the bolt passes through, EXCLUDING washers and direct-tension indicators (DTIs)", + "units": "in.", + "citation": "RCSC 2020 Glossary (\"Grip\")", + "source_quote": "Grip. The total thickness of material a bolt passes through, exclusive of washers or direct-tension indicators.", + "found": true + }, + { + "id": "bolt.length.engagement", + "category": "bolts", + "rule": "Bolt length must achieve sufficient thread engagement", + "value": "Length chosen so the installed bolt end is at least flush with (or beyond) the outer face of the nut — develops the bolt's strength", + "units": "—", + "citation": "RCSC 2020 §2.7; Glossary (\"Sufficient Thread Engagement\")", + "source_quote": "The bolt length used shall be such that, when installed, sufficient thread engagement (as defined in the Glossary) is achieved. [Glossary:] … the available bolt threads extending beyond or at least flush with the outer face of the nut; a condition that develops the strength of the bolt.", + "found": true + }, + { + "id": "bolt.length.select", + "category": "bolts", + "rule": "Selecting bolt length from grip", + "value": "length = grip + add-to-grip value (RCSC Table C-2.2), rounded to nearest ¼ in. (½ in. for lengths over 6 in.)", + "units": "in.", + "citation": "RCSC 2020 Commentary §2.7, Table C-2.2 (more extensive: AISC Manual Table 7-18)", + "source_quote": "To determine the required bolt length, the value shown in Table C-2.2 should be added to the grip … The length determined by the use of Table C-2.2 should be adjusted to the nearest ¼-in. increment (or ½-in. increment for lengths exceeding 6 in.). A more extensive table … is available (Carter, 1996).", + "found": true + }, + { + "id": "bolt.length.washer.add", + "category": "bolts", + "rule": "Washer thickness added to grip when selecting bolt length", + "value": "+5/32 in. per ASTM F436 flat washer; +5/16 in. per beveled washer (added to grip before length selection)", + "units": "in.", + "citation": "RCSC 2020 Commentary §2.7, Table C-2.2", + "source_quote": "For each ASTM F436 washer that is used, add 5/32 in.; for each beveled washer, add 5/16 in.", + "found": true + }, { "id": "weld.fillet.min.to.025in", "category": "welds", diff --git a/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md b/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md new file mode 100644 index 000000000..3a6b9b62f --- /dev/null +++ b/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md @@ -0,0 +1,53 @@ +--- +name: steel-detailer-us-bolt-length-and-grip +description: Use for US high-strength bolt LENGTH selection — how long a bolt must be for a given grip (the clamped plies), the grip definition, the "sufficient thread engagement" requirement that sets length, adding washer thickness to grip, and where the add-to-grip length table lives. RCSC 2020 §2.7, Glossary, and Commentary Table C-2.2. +--- + +# Bolt length & grip (RCSC) + +A high-strength bolt must be **long enough to develop its strength** — i.e. long enough that, when +installed, it achieves **sufficient thread engagement** with the nut. Length is selected from the **grip**. + +- **Grip** = the **total thickness of the connected plies** the bolt passes through, **excluding washers + and direct-tension indicators (DTIs).** (`grip` is the clamped structural material only.) +- **The length requirement is normative (RCSC §2.7):** the bolt length used **shall** be such that, when + installed, **sufficient thread engagement** is achieved. *"Sufficient thread engagement"* = the end of + the bolt (excluding a spline-end's spline) is **at least flush with — or extends beyond — the outer face + of the nut**; the condition that develops the bolt's strength (Glossary). Too short → the threads do not + fully engage the nut; the joint cannot develop the bolt. +- **How length is selected (method):** required length = **grip + the add-to-grip value from RCSC + Table C-2.2**, then **rounded to the nearest ¼ in. (½ in. for lengths over 6 in.)**. The tabulated + add-to-grip values already provide for manufacturing tolerances and sufficient thread engagement. +- **Washers add to the grip *for length selection*** (even though washers are not part of the grip + itself): add **5/32 in. per ASTM F436 flat washer** and **5/16 in. per beveled washer** to the grip + before selecting the length. +- **Where the orderable-length table lives:** the add-to-grip values are **RCSC Table C-2.2** (free, in + the RCSC 2020 Commentary). A *more extensive* bolt-length-selection table is the **AISC *Steel + Construction Manual*, Table 7-18** (Carter, 1996) — **paid; cite by reference, do not reproduce.** Both + encode the same grip-based rule. + +This agent gives the **rule + grip concept**, not the tabulated length values — read Table C-2.2 in the +free RCSC PDF (or AISC Manual Table 7-18) for the per-diameter add-to-grip numbers. + +> **Rule** → length develops the bolt only with sufficient thread engagement. **Condition** → every +> high-strength bolt; length = grip (+ washer thicknesses) + Table C-2.2 allowance, rounded. **Source** ↓. + +## Source + +- **Normative requirement — RCSC 2020 §2.7 ("Geometry of Bolting Components and Assemblies").** + *"The bolt length used shall be such that, when installed, sufficient thread engagement (as defined in + the Glossary) is achieved."* +- **Grip — RCSC 2020 Glossary.** *"Grip. The total thickness of material a bolt passes through, exclusive + of washers or direct-tension indicators."* +- **Sufficient Thread Engagement — RCSC 2020 Glossary.** *"Having the end of the bolt, not including the + spline of a spline-end bolt, or the available bolt threads extending beyond or at least flush with the + outer face of the nut; a condition that develops the strength of the bolt."* +- **Selection method — RCSC 2020 Commentary to §2.7, Table C-2.2.** *"To determine the required bolt + length, the value shown in Table C-2.2 should be added to the grip (i.e., the total thickness of all + connected material, exclusive of washers). For each ASTM F436 washer that is used, add 5/32 in.; for + each beveled washer, add 5/16 in. … The length determined by the use of Table C-2.2 should be adjusted + to the nearest ¼-in. increment (or ½-in. increment for lengths exceeding 6 in.). A more extensive table + for bolt length selection based upon these rules is available (Carter, 1996 …)."* +- The "more extensive table (Carter, 1996)" is the **AISC *Steel Construction Manual*, Table 7-18** — + paid; cited by reference only, never reproduced. +- Verified against the genuine RCSC 2020 PDF. Verify free at boltcouncil.org. From f91eac6909d92101f3aeb9bb721d996f885b01bc Mon Sep 17 00:00:00 2001 From: Pawel Date: Sun, 28 Jun 2026 20:51:19 +0200 Subject: [PATCH 2/3] fix(steel-detailer-us): ground the add-to-grip pointer in RCSC C-2.2 + Carter 1996, drop unverifiable Manual table no. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Addresses the dual review (Codex). The first cut equated RCSC's "more extensive table (Carter, 1996)" with "AISC Manual Table 7-18" — but that equivalence is not provable from any free source, and a check found the Manual's bolt-length table was historically Table 7-2 (older editions, since removed), not 7-18. For an agent whose whole value is verified-from-free-source citations, asserting an unverifiable paid-table number is a scope violation. Reworded (skill + the bolt.length.select JSON citation) to cite only what is free + verifiable: the per-diameter values live in RCSC 2020 Table C-2.2 (free, in the Commentary), and RCSC's own cited "more extensive" reference is Carter, C.J., "Specifying Bolt Length for High-Strength Bolts," AISC Engineering Journal, Vol. 33 No. 2 (2nd Qtr. 1996) — free. The AISC Manual is named only generically (paid; reference-only; no specific table number). Also: bolt.length.engagement units "—" -> "dimensionless" to match the DB's existing convention (pr-review-toolkit nit). The beveled-washer +5/16 in. value was confirmed from the RENDERED RCSC PDF page (the PDF's fraction-font glyphs garble in plain text extraction but render correctly). --- .../steel-detailer-us/rules/aisc-360-22.json | 4 ++-- .../skills/bolt-length-and-grip.md | 18 +++++++++++------- 2 files changed, 13 insertions(+), 9 deletions(-) diff --git a/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json b/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json index d39d3611e..4f6432ff1 100644 --- a/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json +++ b/20-agents/aeco/engineering/steel-detailer-us/rules/aisc-360-22.json @@ -335,7 +335,7 @@ "category": "bolts", "rule": "Bolt length must achieve sufficient thread engagement", "value": "Length chosen so the installed bolt end is at least flush with (or beyond) the outer face of the nut — develops the bolt's strength", - "units": "—", + "units": "dimensionless", "citation": "RCSC 2020 §2.7; Glossary (\"Sufficient Thread Engagement\")", "source_quote": "The bolt length used shall be such that, when installed, sufficient thread engagement (as defined in the Glossary) is achieved. [Glossary:] … the available bolt threads extending beyond or at least flush with the outer face of the nut; a condition that develops the strength of the bolt.", "found": true @@ -346,7 +346,7 @@ "rule": "Selecting bolt length from grip", "value": "length = grip + add-to-grip value (RCSC Table C-2.2), rounded to nearest ¼ in. (½ in. for lengths over 6 in.)", "units": "in.", - "citation": "RCSC 2020 Commentary §2.7, Table C-2.2 (more extensive: AISC Manual Table 7-18)", + "citation": "RCSC 2020 Commentary §2.7, Table C-2.2 (more extensive: Carter 1996, AISC Engineering Journal 2Q)", "source_quote": "To determine the required bolt length, the value shown in Table C-2.2 should be added to the grip … The length determined by the use of Table C-2.2 should be adjusted to the nearest ¼-in. increment (or ½-in. increment for lengths exceeding 6 in.). A more extensive table … is available (Carter, 1996).", "found": true }, diff --git a/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md b/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md index 3a6b9b62f..8e76a6d54 100644 --- a/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md +++ b/20-agents/aeco/engineering/steel-detailer-us/skills/bolt-length-and-grip.md @@ -21,13 +21,14 @@ installed, it achieves **sufficient thread engagement** with the nut. Length is - **Washers add to the grip *for length selection*** (even though washers are not part of the grip itself): add **5/32 in. per ASTM F436 flat washer** and **5/16 in. per beveled washer** to the grip before selecting the length. -- **Where the orderable-length table lives:** the add-to-grip values are **RCSC Table C-2.2** (free, in - the RCSC 2020 Commentary). A *more extensive* bolt-length-selection table is the **AISC *Steel - Construction Manual*, Table 7-18** (Carter, 1996) — **paid; cite by reference, do not reproduce.** Both - encode the same grip-based rule. +- **Where the add-to-grip table lives:** the per-diameter add-to-grip values are in **RCSC 2020 + Table C-2.2** (free, in the RCSC Commentary). RCSC itself points to a *more extensive* selection table — + **Carter (1996)**, *"Specifying Bolt Length for High-Strength Bolts,"* AISC *Engineering Journal*, + 2nd Qtr. 1996 (free, and RCSC's own cited reference). The AISC *Steel Construction Manual* has + historically tabulated the same selection (paid — reference only, never reproduced). This agent gives the **rule + grip concept**, not the tabulated length values — read Table C-2.2 in the -free RCSC PDF (or AISC Manual Table 7-18) for the per-diameter add-to-grip numbers. +free RCSC PDF (or Carter, 1996) for the per-diameter add-to-grip numbers. > **Rule** → length develops the bolt only with sufficient thread engagement. **Condition** → every > high-strength bolt; length = grip (+ washer thicknesses) + Table C-2.2 allowance, rounded. **Source** ↓. @@ -48,6 +49,9 @@ free RCSC PDF (or AISC Manual Table 7-18) for the per-diameter add-to-grip numbe each beveled washer, add 5/16 in. … The length determined by the use of Table C-2.2 should be adjusted to the nearest ¼-in. increment (or ½-in. increment for lengths exceeding 6 in.). A more extensive table for bolt length selection based upon these rules is available (Carter, 1996 …)."* -- The "more extensive table (Carter, 1996)" is the **AISC *Steel Construction Manual*, Table 7-18** — - paid; cited by reference only, never reproduced. +- RCSC's *"more extensive table … (Carter, 1996)"* is **Carter, C.J., *"Specifying Bolt Length for + High-Strength Bolts,"* AISC *Engineering Journal*, Vol. 33, No. 2 (2nd Qtr. 1996)** — the free, + canonical bolt-length-selection reference. (The AISC *Steel Construction Manual* also tabulates this + selection — paid; reference only, never reproduced. Edition numbering varies, so it is not cited to a + specific table number here.) - Verified against the genuine RCSC 2020 PDF. Verify free at boltcouncil.org. From 55619ba6c8b1e657de1e3929e4cbcbf5bf357514 Mon Sep 17 00:00:00 2001 From: Pawel Date: Sun, 28 Jun 2026 20:54:35 +0200 Subject: [PATCH 3/3] chore(stats): sync skill count 3,339->3,340 for the new bolt-length skill --- 40-diagrams/substrate-playground.html | 2 +- CLAUDE.md | 4 ++-- README.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/40-diagrams/substrate-playground.html b/40-diagrams/substrate-playground.html index bfc748df9..60e64b75e 100644 --- a/40-diagrams/substrate-playground.html +++ b/40-diagrams/substrate-playground.html @@ -90,7 +90,7 @@

Prompt — copy back to Claude