Claude Context: PSI Knowledge Base

Purpose: AI agent entry point. Read this first for business context, terminology, and a reading order.


Reading Order

  1. Terminology — 80+ PSI-specific terms. Read this first.
  2. About PSI — Company overview, products, organizational structure.
  3. Engineering — Design workflow, ECN/NCN process.
  4. Manufacturing — Build process, departments, assembly.
  5. Quality — Redbook system, quality metrics.
  6. Data Brain — Master reference for all PSI data — what exists, where, how to access.
  7. PSI Web App Compliance Standard — Canonical standard for compliant PSI web app changes.
  8. llms.txt — Full index of all documentation.

What is PSI?

Progressive Surface Inc. (PSI) is a custom industrial machine manufacturer based in Grand Rapids, Michigan. PSI builds surface treatment equipment including:

  • Blast rooms/cabinets: Abrasive blasting for cleaning/finishing
  • Spray booths: Coating application systems
  • Peen systems: Shot peening for fatigue resistance
  • Thermal spray: Metal/ceramic coating systems

Each machine is a custom project (not mass production) with 6-18 month lead times. Customers include aerospace, automotive, energy, and general manufacturing industries.


Essential Terminology

These terms appear throughout PSI systems and documentation. See Terminology for the complete glossary.

Must-Know Terms

TermMeaning
RedbookQuality issue ticket (not a physical book)
ECNEngineering Change Notice (formal design change)
NCNNon-Conformance Notice (vendor quality issue)
PHYS.Physical-level part (lowest reusable design unit)
BOMBill of Materials (hierarchical parts list)
GTCodeGroup Technology Code (FACILITY > ASSEMBLY > MODULE > PHYS.)
New BuildNew machine project (4-digit job numbers)
RetrofitModification to existing machine (5-digit job numbers >=10000)

Department Codes

CodeDepartment
110Mechanical Engineering
111Controls/Electrical Engineering
106Mechanical Assembly
108Electrical Assembly
120MVI (Machine Verification & Inspection)
135Field Service

Key Business Metrics

MetricDefinitionTarget
Quality %Quality Cost / Project Value<2%
Early Detection Rate% issues found >90 days before ship>50%
Field Escape Rate% issues found post-ship<3%

Data & Systems

Primary Systems

SystemPurpose
AFTECCore ERP database (UniData)
SolidWorks PDMEngineering drawings and BOMs
Redbook SystemQuality issue tracking

Key Data Sources

SourceRecordsPurpose
Redbook Export49,758Quality issue tickets (1999-2025)
Project XML3,084Project metadata
BOM Exports1,704 filesBill of Materials per project
Parts Master419,627All parts with classification

See Data Brain for complete inventory.


Wiki Structure

content/
├── index.md                        # Homepage with navigation
├── CLAUDE_CONTEXT.md               # This file
├── llms.txt                        # Full page index for AI navigation
│
├── company/                        # WHO WE ARE — PSI context & domain knowledge
│   ├── about.md                    # Company overview, products, services
│   ├── terminology.md              # 80+ term glossary
│   ├── lds-methodology.md          # LDS engineering framework
│   ├── engineering.md              # Design workflow, ECN/NCN process
│   ├── manufacturing.md            # Build process, departments, assembly
│   └── quality.md                  # Redbook system, quality metrics
│
├── applications/                   # WHAT WE BUILD — living docs per app/tool
│   ├── index.md                    # Portfolio overview with links
│   ├── redbook-web.md              # Redbook Web RFC management
│   ├── psi-explorer.md             # PSI Explorer Web
│   ├── project-explorer.md         # Project Explorer
│   ├── erp-migration.md            # ERP Migration Tool
│   ├── psi-portal.md               # PSI Portal launcher
│   ├── unidata-api.md              # UniData REST API
│   ├── cli-export.md               # PSI Export CLI
│   ├── wiki-site.md                # This wiki
│   ├── proapps.md                  # 35+ WPF desktop apps
│   └── redbook-analysis.md         # Quality analytics pipeline
│
├── development/                    # HOW WE BUILD — patterns, tools, guides
│   ├── webapp-compliance-standard.md # Canonical web app compliance baseline
│   ├── deploy-to-azure.md          # Web apps architecture & Azure deployment guide
│   ├── u2-toolkit-migration.md     # UniData access migration guide
│   ├── agentic-implementation.md   # AI-assisted dev methodology
│   ├── claude-code.md              # Claude Code integration & skills
│   └── webapp-testing.md           # Testing best practices
│
├── data/                           # OUR DATA — schemas, catalogs, systems
│   ├── data-brain.md               # Master data reference (hub page)
│   ├── data-dictionary.md          # Field definitions for analytics
│   ├── redbook-schema.md           # REDBOOK.1287 field reference
│   ├── fabric-progressive-dataset.md  # Power BI/Fabric table schemas
│   ├── inventory-and-work-orders.md   # WO types, inventory tables, IBM
│   └── psiall-architecture.md      # .NET codebase & UniData subroutines
│
├── reference/                      # DEEP REFERENCE — technical catalogs
│   └── aftec/                      # AFTEC subroutine catalog (21 files)
│       ├── index.md
│       └── ... (20 domain files)
│
├── analytics/                      # METRICS — dashboards & methodology
│   ├── dashboards.md               # Dashboard docs
│   └── methodology.md              # Metric calculations
│
└── guides/                         # HOW-TO — step-by-step tutorials
    ├── getting-started.md          # Wiki orientation (15 min)
    ├── dev-setup.md                # Developer environment setup
    ├── connect-ai.md               # AI agent access setup
    ├── edit-wiki.md                # Wiki editing guide
    ├── obsidian-tips.md            # Obsidian power tips
    └── training-presentation.md    # Team training slides

For AI Agents: Common Tasks

| Task | Start Here | | --------------------------------- | ---------------------------------------- | -------------------------------------- | ------------- | | Understanding a term | Terminology | | Finding data sources | Data Brain | | Learning about quality | Quality | | Understanding engineering | Engineering | | Understanding the technology | PSI.All Architecture | | Working on analytics | Dashboards + Methodology | | Making a compliant web app change | PSI Web App Compliance Standard | | Deploying an app | Deploy to Azure | | Understanding an application | Applications Overview | | Finding a subroutine | AFTEC Catalog |


Last updated: March 2026