Engineering and architecture
Code analysis sheets and code compliance memos: what AI teams value
By SourceX Editorial · Reviewed by Noah Loul ·
Short answer
A code analysis sheet summarizes how a building meets the adopted codes, and a code compliance memo explains the reasoning behind a specific code decision. AI teams value both when they name the code edition, the local amendments and the rationale, and when the plan reviewer's response is attached. Quoted code text belongs to its publisher and is usually removed.
Key takeaways
- A code analysis sheet records the result; a code compliance memo records the reasoning.
- Every analysis should state the code edition and the local amendments adopted by the jurisdiction.
- Rationale plus the plan reviewer's response is what makes a code decision useful to AI developers.
- Model code text is third-party content, so licensed packages usually keep section references and drop quoted passages.
How does a code analysis sheet differ from a code compliance memo?#
A code analysis sheet is a drawing-set summary of how a building meets the adopted codes, while a code compliance memo is a narrative explaining how the design team resolved a specific code question. The sheet shows conclusions at a glance for the plan reviewer and the contractor. The memo shows the reasoning a senior architect used to get there.
Both are routine at architecture firms, and they are usually filed in different places. The sheet lives in the Revit model and the issued drawing set, often in the general series. Memos live in project folders, email threads with code consultants and correspondence with the authority having jurisdiction. A memo that follows a fixed outline, like the one below, is far easier to find, compare and reuse.
- Question: the code issue in one sentence and the project condition that raised it.
- Code basis: the governing code and edition, the local amendments, and any earlier interpretation from the same authority having jurisdiction.
- Analysis: the options considered, the section references relied on, and the reasoning that decided the outcome.
- Outcome: the conclusion, the plan reviewer's concurrence or comment, the date and the author's role.
| Attribute | Code analysis sheet | Code compliance memo |
|---|---|---|
| Purpose | Summarize code compliance for permit review and construction | Explain how one code question was resolved |
| Format | Tables and diagrams on a drawing sheet | Narrative letter or memo with code references |
| Typical contents | Occupancy, construction type, area, egress, fire ratings | Interpretation, alternatives considered, conclusion |
| Audience | Plan reviewer, contractor, fire marshal | Plan reviewer, client, internal team, code consultant |
| Where it lives | Revit model and issued drawing set | Project folder, email, permit correspondence |
A building code analysis template outline#
A building code analysis template should walk through the same sequence on every project, so each sheet can be read and compared the same way. The outline below follows the order most plan reviewers expect to see.
- Project data: scope of work, building use, and whether it is new construction or an alteration.
- Governing codes: building, fire, energy, accessibility, plumbing and mechanical, each with its edition.
- Local amendments and jurisdiction-specific ordinances that modify the model codes.
- Occupancy classification analysis, including the separated or nonseparated mixed-use approach.
- Construction type and the fire-resistance ratings it requires.
- Allowable height and area calculation, with any frontage or sprinkler increases used.
- Occupant load, egress capacity, travel distance and number of exits per floor.
- Life safety plan references: rated walls, exit paths, fire separations and smoke compartments.
- Accessibility approach and plumbing fixture calculation.
- Interpretations, variances or alternate methods agreed with the authority having jurisdiction.
What makes a code analysis useful to an AI team?#
A code analysis is useful to an AI team when it shows which rule applied, which version of the rule, and why the design team reached its conclusion. Developers building code-checking and plan-review tools generally need examples of expert reasoning under real conditions, not restatements of the code.
Three details separate a strong record from a weak one. The edition matters because requirements change between code cycles. Local amendments matter because jurisdictions modify the model codes. Rationale matters because two qualified architects can reach different answers on the same question, and the reasoning is what a model has to learn.
| Element | Weak record | Strong record |
|---|---|---|
| Code edition | Says IBC with no edition | Names the adopted edition and the date the analysis was prepared |
| Local amendments | Not mentioned | Lists the amendments that changed the analysis |
| Occupancy | Single classification stated | Classification with the reasoning for borderline uses |
| Rationale | Conclusion only | Options considered and why one was chosen |
| Outcome | No link to permit review | Plan review comments and the firm's responses attached |
The code text itself is third-party content#
Model code text is third-party content: the International Code Council publishes the International Building Code, and NFPA publishes standards such as the Life Safety Code. Code-writing organizations generally assert copyright in their published text, and the legal treatment of codes adopted into law has been contested, so counsel should assess any package that reproduces code language.
The practical approach is to keep section references and the firm's own analysis while removing quoted passages. A memo that names the section and explains how it applied is still complete without the code language, and the reasoning is the part the firm actually authored.
The same caution applies to code commentary, handbooks and paid code research services. Excerpts pasted from those sources into memos should be identified during preparation and usually removed.
Plan review comments close the loop#
Plan review comments close the loop because they show whether the authority having jurisdiction accepted the firm's analysis. A code analysis followed by the reviewer's comment and the firm's response letter forms a complete decision record: the question, the expert answer, the challenge and the resolution.
These records are scattered. Permit portals hold reviewer comments, project folders hold response letters, and revised sheets carry clouds and revision tags. Linking them by permit number or project number is often the largest preparation task.
Rights need the same care. Comment letters from public agencies may be public records, but the drawings and project details they reference belong to client projects, and client agreements may carry confidentiality terms. Treat each record type separately during rights review.
Illustrative: an architecture firm reviews its code memo archive#
Illustrative: a fictional architecture firm designs mixed-use, light industrial and tenant improvement projects. Its code analysis sheets come from Revit templates, its code memos sit in a SharePoint library organized by project, and its permit comments are spread across email and downloaded portal PDFs.
The COO asks whether the archive could support a licensing conversation. A first pass shows that newer memos name the edition and amendments while older ones do not, and that response letters are linked to reviewer comments on most recent projects but few older ones.
The firm scopes only projects with complete memo, comment and response chains. It plans to strip quoted code text and client identifiers, leaves undated memos out until they can be dated from the permit record, and excludes projects whose client agreements carry strict confidentiality terms.
How to prepare code records for licensing#
Preparing code records for licensing follows the same order on every project: confirm rights first, remove what the firm did not author, then remove what identifies people and places.
- Confirm the client agreement allows internal records to be used beyond the project, or carve the project out.
- Remove quoted code text, commentary excerpts and paid research content, keeping section references.
- Replace client names, addresses, parcel numbers and permit numbers with consistent keys.
- Remove names of reviewers, inspectors and staff, keeping their roles.
- Keep the edition, amendments, rationale and outcome on every record.
How SourceX handles code analysis records#
SourceX handles code records through the SourceX five-step transaction: Supply, Rights, Preparation, Approval and Delivery. Rights review comes before any preparation, so projects with restrictive client terms are removed before anyone spends time on redaction.
Each package that proceeds carries a SourceX Evidence Packet recording provenance, licensing rights, permitted use, the privacy record and release authorization. The firm approves the final scope, and the records remain the firm's: they are licensed for defined uses, not sold.
Frequently asked questions
Can we include the full text of the building code in a licensed package?
Usually not. Model code text is published by code-writing organizations that generally assert copyright, so licensed packages typically keep section references and the firm's own analysis and remove quoted passages. Whether a specific use is permitted is a question for counsel.
Do we need the client's permission to license code memos?
It depends on the client agreement. Some agreements treat all project documents as confidential or client-owned, while others leave the firm free to use its internal work product. Rights review checks each agreement, and projects with restrictive terms are usually excluded rather than negotiated one by one.
Should superseded code analyses be kept?
Yes, if they are dated. An analysis prepared under an older edition still shows valid expert reasoning for that edition. Undated analyses are less useful because no one can tell which rules applied when the decision was made.
Will AI code-checking tools replace the architect's code analysis?
Not on their own. Code-checking tools can flag likely issues and draft summaries, but the design professional remains responsible for the analysis submitted for permit. The firm's expertise shows up in interpretation, borderline occupancy calls and discussions with plan reviewers, which is why those records are scarce.
How should life safety plans be handled?
Life safety plans are often the clearest visual record of egress and separation decisions. They are drawings, so they need the same de-identification as other sheets: title blocks, addresses and client marks removed, with the plan logic and code references kept.
Related resources
- QuestionDo AI labs buy code?
- InsightCan you license CAD and engineering drawings to AI companies?
- InsightCan you license code reviews and pull requests to AI companies?
- InsightCode snapshot vs full git history: what to include in a code license
- SolutionEnterprise data: the records of how organizations actually work
- SolutionProprietary data: information only your company has
See if your company qualifies
A short company assessment. No data uploads are needed.