# Prairie HVAC Agent

Prairie HVAC Agent is a simple Claude Project starter folder for Saskatchewan HVAC work.

It is not a web app. It has no MCP server, no database, no package install, no API keys and no runtime. It is just project instructions and source documents that Claude can use inside a Project.

## What This Folder Is

This folder has two jobs:

1. Give Claude clear project instructions.
2. Give Claude source documents to reason from.

## Folder Layout

```text
prairie-hvac-agent/
  README.md                  Human setup guide.
  PROJECT_INSTRUCTIONS.md    Paste this into the Claude Project Instructions field.
  TEST_PROMPTS.md            Copy/paste examples for testing the Claude Project.
  knowledge/
    MANIFEST.md              Table of contents for loaded sources.
    ADD_SOURCES.md           Guide for adding manuals, SOPs and licensed documents.
    sk/                      Saskatchewan source library, organized by discipline.
      building/
      boiler-pressure-vessel/
      electrical/
      energy/
      fire/
      gas/
      plumbing/
      refrigeration/
      safety/
```

## Claude Project Setup

1. Create a new Claude Project.
2. Open `PROJECT_INSTRUCTIONS.md`.
3. Copy the full contents into the Project `Instructions` field.
4. Upload Project Knowledge.

Full demo upload:

   - `knowledge/MANIFEST.md`
   - `knowledge/ADD_SOURCES.md`
   - `knowledge/sk/`

Lean upload when size is tight:

   - `knowledge/MANIFEST.md`
   - `knowledge/ADD_SOURCES.md`
   - only the specific `knowledge/sk/<discipline>/` folders needed for the demo

5. Start with one of these prompts:
   - "Summarize what sources this project already has."
   - "Ask a Saskatchewan code question."
   - "Start a field troubleshooting case."
   - "Handle an office call."
   - "Help me add a manufacturer manual."

For a fuller demo script, use `TEST_PROMPTS.md`.

## What Is Included

- `PROJECT_INSTRUCTIONS.md`: paste this into Claude's Project instructions field.
- `TEST_PROMPTS.md`: copy/paste questions for testing the agent in Claude.
- `knowledge/`: original public PDFs, metadata and extracted text.
- `knowledge/sk/`: Saskatchewan public sources organized by discipline and source type.
- `knowledge/MANIFEST.md`: table of contents for the loaded sources.
- `knowledge/ADD_SOURCES.md`: how to add company procedures, manuals or licensed documents.

## What Is Not Included

- Licensed CSA/ASME standards or manufacturer manuals unless you add your own lawful copies.
- Company procedures unless you add them.
- Fake customer data, fake manuals or fake cases.
- MCP tools, search indexes, Node/Python apps or hosted services.

## Core Rule

Use the sources in `knowledge/`. If the source is not present, Claude should say what is missing and help the operator add it instead of guessing.

## Where Future Sources Go

- Company procedures, call scripts and checklists: add under `knowledge/company/`.
- Manufacturer manuals, service bulletins and fault-code references: add under `knowledge/equipment/`.
- Licensed CSA, ASME or paid standards: add under `knowledge/standards/` only when storage rights are confirmed.
- Sanitized service history and known-good fixes: add under `knowledge/service-history/`.
- New Saskatchewan public code, guide or safety documents: add under the matching `knowledge/sk/<discipline>/<source-type>/` folder.

Those folders do not need fake starter data. Create them only when adding real context.
