project-setup

Project Setup

Set up a construction project directory for use with Claude Code construction skills. This skill inventories all files, classifies construction document types, and appends construction-specific context to the project's CLAUDE.md.

Run this after /init has created the base CLAUDE.md.

Pipeline Position

/init (built-in) → THIS SKILL → /spec-splitter, /sheet-splitter → /submittal-log-generator

Runs once per project. Identifies which Builder skills should run next.

Workflow

Project Setup Progress:
- [ ] Step 1: Detect operational mode
- [ ] Step 2: Inventory and classify files
- [ ] Step 3: Present summary and recommend next actions
- [ ] Step 4: Amend project CLAUDE.md

Step 1: Detect Operational Mode

Check for .construction/ directory at the project root.

If present (AgentCM mode):

1. Read .construction/CLAUDE.md for project navigation context
2. Query database for entity counts (read query_command from .construction/database.yaml): {query_command} -c "SELECT (SELECT COUNT(*) FROM sheets WHERE project_id = '{id}') AS sheets, (SELECT COUNT(*) FROM rooms WHERE project_id = '{id}') AS rooms, (SELECT COUNT(*) FROM graph_elements ge JOIN sheets s ON s.id = ge.sheet_id WHERE s.project_id = '{id}') AS elements" Fallback: read .construction/graph/graph_summary.yaml if database unavailable
3. Read .construction/index/sheet_index.yaml for drawing inventory
4. Skip to Step 3 with instant summary — no file scanning needed

If absent (Flat File mode): Continue to Step 2.

Step 2: Inventory and Classify Files

Scan the project directory. No vision calls — use filename and folder pattern matching only.

Classification rules:

Document Type	Detection Pattern
Drawing sets	PDFs in drawings/, plans/, or root with discipline prefixes (A-, S-, M-, E-, P-, C-, L-). PDFs > 2MB with keywords: "plan", "drawing", "bid set", "dwg".
Specifications	Folders named Specifications/, specs/, 02 - Specifications/. PDFs with "project manual", "spec", "volume". CSI section number patterns in filenames.
Schedules	Excel/CSV files with "schedule", "CPM", "lookahead", "milestone" in name.
Submittal log	Excel files with "submittal" in name, typically in Submittals/ or 06 - Submittals/.
RFI log	Excel files with "RFI" in name, typically in RFIs/ or logs folder.
Change orders	Excel/PDF files with "change order", "CO", "PCO" in name.
Other	Correspondence, photos, reports, geotechnical, environmental.