foreman-os-plugin

Use this skill when reading from or writing to the project intelligence data store. Manages a multi-file data store (project-config.json, plans-spatial.json, specs-quality.json, schedule.json, directory.json, individual log files, and daily-report-data.json). Handles storage, cross-referencing, versioning, validation, and smart retrieval of project intelligence, report history, RFI/submittal logs, procurement tracking, vendor database, and lookahead schedules.

Comprehensive construction document intelligence extraction system. Use when processing ANY construction documents (plans, specs, schedules, contracts, geotech, safety, SWPPP, sub lists, RFIs, submittals) to extract field-actionable data for daily reports, project management, quality control, and procurement. Also generates the Project Intelligence Dashboard and construction schedules (door, hardware, fixture, finish, plumbing, equipment, room) from extracted data. Triggers: "process documents", "extract from plans", "read the specs", "analyze schedule", "set up project", "add documents", "show project intelligence", "project intel", "what data do we have", "door schedule", "hardware schedule", "finish schedule", "generate schedules", "room schedule", "equipment schedule", any mention of construction document processing or project intelligence building. This skill should be used EVERY TIME construction documents need to be processed - it extracts deep, comprehensive data including specific values, schedules,

Project-agnostic data normalization patterns for the 28-file Project Brain. Defines 8 repeatable patterns (N1-N8) that fix common data quality issues: status standardization, counter reconciliation, cross-reference linking, field backfill, schema compliance, computed totals, date/format normalization, and deduplication. Safe to re-run (idempotent). Outputs a repair plan before executing.

Review and verify submittal compliance against project specifications. Trigger phrases include "review submittal", "check submittal", "submittal compliance", "does this meet spec", "compare to spec", "submittal review", "product data review", "shop drawing review".

Skill for tracking project closeout and building commissioning activities. Manages closeout checklists, commissioning workflows, warranty tracking, and substantial/final completion documentation. Integrates with punch-list and inspection systems.

Generate Construction Operations Building Information Exchange (COBie) compliant spreadsheets from existing project intelligence data. Maps extracted data into the 18 standard COBie worksheet format for facility management handover. Critical for healthcare facilities where ongoing maintenance and asset management are regulatory requirements. Exports as multi-tab Excel workbook. Triggers: "COBie", "COBie export", "facility handover", "asset register", "O&M data", "building information exchange", "commissioning data", "facility management data", "asset data", "COBie spreadsheet", "handover data", "building handover".

Environmental compliance management for construction projects. Covers LEED v4.1 construction administration, SWPPP permit compliance and inspections, hazardous materials management (asbestos, lead, mold, contaminated soil), construction waste management and diversion tracking, dust and air quality control, noise ordinance compliance, silica exposure prevention, and environmental incident response. Beyond basic BMP installation (see field-reference/bmp-field-guide.md). Triggers: "environmental", "LEED", "SWPPP", "hazmat", "hazardous materials", "asbestos", "lead paint", "waste management", "dust control", "noise", "environmental compliance", "recycling", "diversion", "VOC", "silica", "EPD", "HPD", "spill", "contaminated soil", "mold", "air quality", "noise variance", "waste diversion", "C&D waste".

Proactive risk identification, assessment, and mitigation management for construction projects. Maintain a living risk register, run 5x5 probability-impact assessments, allocate and track contingency drawdown, manage weather and force majeure contingencies, and generate risk reports with heat maps. Integrates with delay-tracker, last-planner, cost-tracking, safety-management, morning-brief, and change-order-tracker. Triggers: "risk", "risk register", "risk matrix", "risk assessment", "contingency", "mitigation", "force majeure", "weather risk", "risk review", "risk report".

Objective, data-driven subcontractor performance scorecards based on five weighted dimensions: Schedule Adherence (25%), Quality (25%), Safety (20%), Responsiveness (15%), and Professionalism (15%). Aggregates data from daily reports, inspections, PPC tracking, safety records, and RFI/submittal turnaround. Enables informed bidding decisions, back-charge documentation, and performance improvement conversations. Triggers: "sub scorecard", "subcontractor performance", "rate sub", "sub evaluation", "vendor performance", "trade performance", "sub rating", "contractor scorecard", "performance review", "back charge", "sub report card".

MCP server for AI-powered image generation via Flux 2, Google Gemini, and built-in SVG tools. Trigger phrases include "generate image", "create rendering", "make a diagram", "generate SVG", "create visualization".

Generate interactive HTML project dashboards from daily report history and project intelligence data. Provides Weekly (operational pulse) and Project (lifetime trends) tabs with charts, tables, and an embedded project data chat interface. Integrates data from daily reports, schedule, directory, inspections, procurement, RFIs, submittals, change orders, pay applications, labor tracking, and quality management. Triggers: "dashboard", "project status", "show project status", "how's the project going", "project overview", "project metrics", "project trends", "see the dashboard", "generate dashboard", "weekly summary chart", "headcount chart", "milestone tracker".

Comprehensive Project Data Intelligence dashboard — the single source of truth for ALL extracted project data. Template-based architecture with 40+ sections covering building data, quantities, financials, specifications, project controls, spatial analysis, and AI rendering. Triggers: "/data", "show me all the data", "project intelligence", "room browser", "quantity dashboard", "material calculator", "bid comparison", "project brain dashboard", "show everything we know", "data dashboard", "what data do we have".

Gather site context, exterior conditions, and interior design intent for AI rendering. Trigger phrases include "site context", "visual context", "gather context", "rendering context". Dependencies: project-config, plans-spatial, specs-quality, schedule, directory.

AI architectural rendering system with comprehensive prompt engineering. Constructs precise image generation prompts from project data and visual context, orchestrates generation through the image-generation-mcp server, and manages the rendering gallery.

Track change orders from initiation through resolution. Handles CO creation, status updates, cost/schedule impact tracking, and CO log generation. Integrates with morning brief (pending COs) and weekly report (CO summary). Triggers: "change order", "CO", "PCO", "COR", "add a change order", "CO status", "CO log", "pending change orders".

Build defensible construction claim records through contemporaneous documentation, formal notice tracking, and claims package assembly. Covers delay claims, cost claims, change order disputes, back-charges, acceleration claims, lost productivity, Eichleay home office overhead, and measured mile analysis. Integrates with daily reports, delay tracker, contract administration, and cost tracking for complete claims support. Triggers: "claim", "claims", "dispute", "notice", "damages", "delay claim", "cost claim", "change order dispute", "back-charge", "Eichleay", "home office overhead", "lost productivity", "acceleration claim", "claims package".

Comprehensive project cost management including budget vs actual tracking, cost forecasting, variance analysis, invoice reconciliation, change order cost impact, cash flow projections, and cost reporting. Integrates with pay-app, change-order, procurement, and schedule systems. Triggers: "cost tracking", "cost report", "budget vs actual", "cost forecast", "cost variance", "invoice reconciliation", "cash flow", "budget status", "cost performance", "cost summary", "EAC", "burn rate", "cost overrun".

Track construction delays systematically for contract extension requests and delay claims documentation. Classify delay type, track critical path impact vs. float absorption, calculate contract extension earned, and manage weather delay verification. Integrates with daily reports, RFIs, and change orders. Triggers: "delay", "schedule delay", "weather delay", "delay event", "time impact", "contract extension", "delay claim", "log a delay", "delay status", "delay report".

Unified scope-schedule-cost performance measurement using Earned Value Management (EVM) methodology. Calculates SPI, CPI, SV, CV, EAC, ETC, VAC, and TCPI. Generates three-line S-curves (BCWS/BCWP/ACWP), variance analysis, and project forecasting. Extends cost-tracking with schedule integration for complete project health assessment. Triggers: "earned value", "EVM", "S-curve", "SPI", "CPI", "cost performance index", "schedule performance index", "estimate at completion", "EAC", "ETC", "variance analysis", "BCWS", "BCWP", "ACWP", "planned value", "earned value report", "project performance", "cost variance", "schedule variance".

Comprehensive pay application (G702/G703) management including schedule of values creation, percentage complete tracking, retainage calculations, lien waiver management, and document generation. Triggers: "pay app", "payment application", "G702", "G703", "create pay app", "billing status", "retainage", "schedule of values", "lien waiver".

BIM coordination and model-based field management for construction superintendents. Manage clash detection workflows, model-to-field verification, 4D scheduling integration, laser scanning and point cloud operations, drone surveys, digital twin closeout handoff, and LOD specification tracking. Track clash reports, model reviews, field verifications, scan records, drone flights, and coordination meetings through a structured data model. Integrates with morning-brief, daily-report, rfi-preparer, look-ahead-planner, closeout-commissioning, and drawing-control. Triggers: "BIM", "model", "clash", "clash detection", "Navisworks", "Revit", "coordination", "4D", "laser scan", "point cloud", "drone", "digital twin", "LOD", "BIM execution plan", "BxP", "model review".

Construction document annotation and markup system for superintendents. Produce redline markups, revision clouds, text annotations, symbol placement, color-coded discipline markups, and layered annotation management on plans, specs, photos, and RFIs. Generate annotated PDFs using PyMuPDF/fitz and reportlab, annotated images for photo documentation, and HTML annotated views for dashboard integration. Integrates with document-intelligence, rfi-preparer, punch-list, daily-report-format, and drawing-control. Triggers: "annotate", "markup", "redline", "cloud", "mark up plans", "annotate drawing", "redline drawing", "photo markup", "punch list photo", "annotate spec", "spec markup", "RFI markup", "as-built markup", "callout", "dimension callout", "field note on drawing", "highlight on plan", "revision cloud", "annotation layer", "color-coded markup".

Manage drawing revisions, ASI incorporation, superseded sheet flagging, and current-set verification. Ensures the field always works from the latest approved drawings. Tracks distribution, validates references in daily reports and RFIs, and alerts on obsolete sheet usage. Triggers: "revision", "ASI", "current sheet", "superseded", "drawing log", "drawing distribution", "obsolete drawing", "sheet update", "field set", "current set", "drawing status", "new revision", "void drawing", "latest drawing", "which revision", "update the drawings", "drawing register".

Draft RFIs and submittal transmittals with auto-filled project intelligence. Use when the user wants to "write an RFI", "draft an RFI", "prepare an RFI", "send an RFI", "create a transmittal", "prepare a submittal transmittal", "submittal cover sheet", or any mention of RFI or transmittal preparation.

This skill should be used when the user asks to "create a daily report", "generate a daily report", "write today's report", "fill out the daily", "do the daily", or needs guidance on construction daily report formatting, section content, or professional construction language standards. Also handles report amendments — trigger phrases: "fix yesterday's report", "amend report", "I need to correct something on a report", "update report #5", "change something on a previous report", "amend the daily".

Construction field reference knowledge base with 21 reference documents providing practical numbers, tolerances, decision frameworks, and best practices that superintendents need in the field. Covers heavy equipment selection and production rates, concrete operations (standard and advanced), structural steel, earthwork, stormwater BMPs, MEP coordination, fire protection, building envelope, site logistics, formwork and shoring, scaffolding, masonry, waterproofing systems, underground utilities, paving and flatwork, crane lift planning, construction surveying, temporary facilities, multi-story coordination, and cross-trade coordination. This is a reference skill — no dedicated command. Other skills and commands call into it, and superintendents can query it conversationally.

Track inspections and permits through the construction lifecycle. Handles scheduling, result logging, re-inspection tracking, permit management, and status reporting. Healthcare-specific: state health dept inspections, life safety, ADA compliance. PEMB-specific: anchor bolt, high-strength bolt, moment connection special inspections. Integrates with morning brief and look-ahead. Triggers: "inspection", "schedule inspection", "log inspection", "inspection status", "permit", "failed inspection", "re-inspect", "upcoming inspections", "special inspection".

Use this skill when processing conversational field input from a superintendent via /log. Handles natural language classification, section assignment, entity resolution, and enrichment of field observations into structured daily report data. Also handles reviewing and clearing the intake log. Trigger phrases: "log this", "just got back from site", "here's what happened today", or any casual construction field observation. Review triggers: "show my log", "what's logged", "review today's entries", "what have I logged", "show logged entries", "review the log". Clear triggers: "clear the log", "start over", "wipe today's log", "reset the log", "clear my entries".

Track per-worker and per-crew labor hours by trade, calculate labor productivity ratios (output per labor-hour), support certified payroll compliance, and feed EVM actual cost calculations. Provides daily headcount validation against daily report crew counts and weekly labor summaries. Triggers: "time card", "timecard", "labor hours", "crew hours", "headcount", "man-hours", "labor productivity", "certified payroll", "labor tracking", "labor report", "overtime", "labor cost", "crew size", "work hours", "time tracking".

Comprehensive photo documentation system for construction progress tracking with AI-powered auto-classification. Uses Gemini Vision API to automatically categorize photos, identify construction phase, detect visible trades, tag location/grid references, and assess safety compliance. Handles photo categorization, metadata tagging, before/after pairing, naming conventions, progress tracking by area, RFI/submittal documentation, drone/aerial guidelines, and chain of custody. Triggers: "photo documentation", "site photos", "progress photos", "photo log", "photo report", "document photos", "photo classification", "classify photos", "auto-tag photos", "photo AI", "identify photo", "what trade is this".

Track punch list items from identification through completion. Handles item creation, status updates, photo documentation, back-charge tracking, and report generation. Groups by area or trade for efficient closeout. Integrates with project dashboard (completion % by area and trade). Triggers: "punch list", "punch item", "punchlist", "add punch", "punch status", "generate punch list", "closeout", "deficiency", "back charge", "back-charge".

Formal Quality Management System (QMS) with three-phase inspection checklists (pre-installation, installation, post-installation) organized by CSI division and trade. Provides specification compliance verification, Inspection and Test Plans (ITP), corrective action tracking, and quality metrics reporting. Integrates with inspection-tracker, sub-performance, and daily reports. Triggers: "quality checklist", "QMS", "pre-install checklist", "three-phase inspection", "quality verification", "ITP", "inspection test plan", "quality control", "quality assurance", "QA/QC", "pre-install", "post-install", "quality report", "first-time quality", "rework tracking".

Use this skill after generating a daily report to review it for completeness, consistency, and accuracy against project intelligence. Catches missing inspections, unrecognized subs, weather threshold conflicts, and other gaps before the report is finalized.

Comprehensive safety management system for construction projects. Handles incident tracking, OSHA reporting (300/300A/301), toolbox talks, JSA/JHA creation, site safety inspections, permits, emergency planning, and safety metrics/KPIs. Integrates with schedule for activity-based hazards and daily reports for safety observations. Triggers: "incident", "near miss", "toolbox talk", "jsa", "jha", "job safety analysis", "inspection", "osha", "recordable", "first aid", "hot work", "confined space", "permit", "safety metrics", "trir", "dart", "emr", "emergency plan", "safety meeting".

Extract construction intelligence from AutoCAD DWG files by compiling libredwg from source, converting DWG to DXF, and parsing all entity types (survey points, utility structures, contours, property boundaries, construction keynotes, grading data). Use this skill whenever the user uploads or references a .dwg file, mentions AutoCAD drawings, Civil 3D files, grading plans, site plans in DWG format, or wants to extract data from CAD files. Also triggers when processing project documents that include .dwg files, or when the user says "read the DWG", "extract from CAD", "parse the drawing file", "process the civil plans", "what's in the DWG", "survey points from the drawing", "utility data from CAD". This skill handles the entire pipeline from binary DWG to structured JSON data.

Construction estimating knowledge for field superintendents — unit cost structure, assembly-based estimating, CSI MasterFormat cost coding, quantity takeoff methods, productivity rate validation, T&M pricing verification, bid review and leveling, and value engineering analysis. Provides cost awareness for daily decisions, change order pricing review, pay application verification, and budget-to-field reconciliation. Triggers: "estimate", "estimating", "cost", "unit cost", "unit price", "bid", "bid leveling", "takeoff", "quantity", "productivity", "labor rate", "equipment rate", "markup", "overhead", "profit", "CSI", "MasterFormat", "assembly", "waste factor", "T&M", "time and materials", "change order pricing", "value engineering", "VE".

Bridge between all measurement sources (DXF geometry, visual plan analysis, construction takeoff, text extraction) and the project intelligence data store. Builds a complete sheet cross-reference index mapping every detail callout, section cut, schedule reference, and spec reference across the entire plan set. Calculates derived quantities (concrete volumes, room areas, material totals, fixture counts) by pulling data from multiple sheets through assembly chains. Stores quantities with source attribution and flags discrepancies when sources disagree by >10%. Triggers: "how much concrete", "total flooring", "room areas", "material quantities", "what quantities", "how many outlets", "cubic yards", "square footage", "takeoff to project", "cross-reference sheets", "assembly chain", "which sheets reference", "detail callout index", "multi-sheet calculation", "aggregate quantities", "quantity discrepancy".

Last Planner System (LPS) implementation for reliable weekly work planning based on Lean Construction Institute methodology. Tracks weekly commitments vs completions, calculates Percent Plan Complete (PPC), performs constraint analysis, identifies variance categories, and drives continuous improvement. Integrates with look-ahead-planner, daily-report-format, material-tracker, and sub-performance. Triggers: "weekly plan", "PPC", "percent plan complete", "last planner", "constraint analysis", "weekly work plan", "pull planning", "make-ready", "commitment tracking", "weekly planning meeting", "constraint log", "reliable promising".

Generates multi-week lookahead schedules from project intelligence. Trigger phrases include "look ahead", "lookahead", "3 week schedule", "upcoming work", "what's coming up", "plan the next few weeks".

Track materials from purchase order through delivery through spec verification. Use when the user mentions "material tracking", "procurement", "delivery", "long lead", "order status", "PO", "purchase order", "material status", "vendor", "supplier", "sourcing", "find a vendor", "who sells", "where to get", "cert tracking", "mill certs", "material certs".