claude-code

Claude Code Integration

Documentation for the Claude Code integration with the PSI Wiki, including CLAUDE.md setup, commands, and structured data.

---

Overview

The PSI Wiki is designed for dual consumption by humans and AI agents. This page documents the Claude Code-specific integration that enables AI-assisted documentation, terminology lookup, and wiki maintenance.

Last Updated: February 2026

---

Architecture

PSI-Wiki-Site/
├── CLAUDE.md                    # Project context (auto-loaded)
├── content/
│   ├── CLAUDE_CONTEXT.md        # Detailed AI entry point
│   └── llms.txt                 # Documentation index
│
└── .claude/
    ├── README.md                # Installer docs
    ├── install.ps1              # Windows installer (interactive)
    ├── install.sh               # Mac/Linux installer
    ├── installer/
    │   ├── manifest.json        # Tool/skill registry
    │   └── setup.ps1            # Setup automation
    ├── skills/
    │   └── deploy-webapp/
    │       └── SKILL.md         # Azure deployment guide
    ├── commands/
    │   ├── wiki-read.md         # /wiki:read command
    │   ├── wiki-search.md       # /wiki:search command
    │   ├── wiki-terminology.md  # /wiki:terminology command
    │   └── wiki-update.md       # /wiki:update command
    └── data/
        ├── terminology.json     # Structured glossary
        └── data-schema.json     # Data source schemas

# Global installation (after running installer)
~/.claude/
├── CLAUDE.md                    # PSI context (always loaded)
└── skills/
    └── deploy-webapp/
        └── SKILL.md             # Available from any project

---

Components

1. Global CLAUDE.md (Primary — Recommended)

The most important integration point. A global ~/.claude/CLAUDE.md gives Claude PSI context in every project:

• PSI terminology (Redbook, AFTEC, BOM, etc.)
• Wiki update workflow and structure
• Application-to-wiki-page mapping
• GitHub API fallback commands
• Technology stack conventions

Setup: See Connect AI Agents for the complete template and setup steps.

Auto-loading: Claude Code reads ~/.claude/CLAUDE.md at the start of every session, so PSI context is always available.

2. Project Context (CLAUDE.md)

The root CLAUDE.md in the PSI-Wiki-Site repo provides additional context specific to working in the wiki itself:

• Wiki structure and key pages
• How to edit and deploy content
• Skill and command locations
• Repo structure overview

3. Wiki Commands (Slash Commands)

Available when working in the wiki repo:

Command	Purpose	Usage
/wiki:read	Read a wiki page	/wiki:read company/terminology.md
/wiki:search	Search wiki content	/wiki:search redbook
/wiki:terminology	Look up PSI terms	/wiki:terminology ECN
/wiki:update	Update a wiki page	/wiki:update applications/redbook-web.md

4. Deploy WebApp Skill

Location: .claude/skills/deploy-webapp/SKILL.md

Interactive deployment guide for Azure web applications. Invoke with /deploy-webapp.

5. Structured Data

JSON exports enable programmatic access to key data:

terminology.json:

• 50+ PSI terms with definitions
• Category classification
• Related terms and aliases
• Department codes
• Acronym expansions

data-schema.json:

• Schema definitions for all data sources
• Field types and descriptions
• Record counts and formats
• Data quality metrics
• Known limitations

---

Usage Examples

Reading Wiki Content

# Via GitHub API
gh api repos/ProgressiveSurface/PSI-Wiki-Site/contents/content/company/terminology.md?ref=v4 \
  --jq '.content' | base64 -d
 
# Via command
/wiki:read company/terminology.md

Looking Up Terminology

# Structured JSON lookup
gh api repos/ProgressiveSurface/PSI-Wiki-Site/contents/.claude/data/terminology.json?ref=v4 \
  --jq '.content' | base64 -d | jq '.terms[] | select(.term == "Redbook")'
 
# Via command
/wiki:terminology Redbook

Searching Wiki

# Find pages about quality
gh api "search/code?q=quality+repo:ProgressiveSurface/PSI-Wiki-Site+path:content+extension:md" \
  --jq '.items[].path'
 
# Via command
/wiki:search quality metrics

---

Access Methods Comparison

Method	Use Case	Capabilities
Global CLAUDE.md	Always-on PSI context (recommended)	Terminology, wiki workflow, structure, GitHub API commands
Local clone	Direct file access when working in wiki repo	Full read/write, local editing
GitHub API	Remote access from any project	Read, write, search via gh api commands
obsidian-mcp-server	Full MCP integration	Read/write/search via Model Context Protocol
Structured JSON	Programmatic lookups	Direct term/schema access via .claude/data/

---

Best Practices

For AI Users

1. Start with CLAUDE_CONTEXT.md - Contains key business context
2. Check terminology first - Use /wiki:terminology for unfamiliar terms
3. Use structured data - JSON files enable precise lookups
4. Reference sources - Note which wiki page provided information

For Wiki Authors

1. Update llms.txt - Add new pages to the index
2. Include frontmatter - Tags enable better discovery
3. Cross-link pages - Use [[wikilinks]] for connections
4. Define terms - Add new terms to terminology.md AND terminology.json

---

Configuration Files

Installer Manifest (installer/manifest.json)

Defines required tools, minimum versions, and available skills:

{
  "tools": {
    "github-cli": { "command": "gh", "minVersion": "2.40.0", "required": true },
    "claude-code": { "command": "claude", "minVersion": "1.0.0", "required": true },
    "nodejs": { "command": "node", "minVersion": "18.0.0", "required": true }
  },
  "skills": {
    "deploy-webapp": {
      "path": ".claude/skills/deploy-webapp",
      "files": ["SKILL.md"]
    }
  }
}

Commands (.claude/commands/)

Slash commands are defined as markdown files and auto-discovered by Claude Code:

File	Command	Purpose
wiki-read.md	/wiki:read	Read a wiki page
wiki-search.md	/wiki:search	Search wiki content
wiki-terminology.md	/wiki:terminology	Look up PSI terms
wiki-update.md	/wiki:update	Update a wiki page

---

Organization Skills (Non-Dev Rollout)

PSI has deployed 5 organization skills via the Claude Enterprise admin console. These skills give all org members — including non-developers — PSI business context automatically, without requiring CLAUDE.md setup or MCP server access.

Deployed Skills

Skill	Purpose
PSI Context	Company overview, terminology, key business concepts
Cowork Best Practices	Guidelines for effective AI-assisted work at PSI
Quality Workflows	Redbook, NCN, and quality process guidance
Controls & Engineering	PLC, electrical, and controls engineering context
Proposal Writing	Proposal and quoting conventions for sales engineering

How It Works

• Org skills are loaded automatically for all Claude Enterprise org members — no user action required
• Skills are a sanitized subset of what developers get via CLAUDE.md — no infrastructure details, server names, or deployment configs are exposed
• Skill source files are version-controlled in a separate private repo (psi-claude-org-skills)
• A managed settings.json is deployed org-wide via the admin console, applying moderate guardrails (blocks destructive operations) transparently to all users

Managing Org Skills

To update or add organization skills:

1. Edit the SKILL.md file in the psi-claude-org-skills repo
2. Package the skill as a .zip file
3. Upload to the Claude Enterprise admin console (admin access required)

Note: Only Claude Enterprise admins can deploy org skills. Contact ADevereaux for access.

---

Changelog

March 2026

• Deployed 5 organization skills for non-developer Claude users (AI Explorers group)
• Managed settings.json deployed org-wide with moderate guardrails
• Onboarding guide distributed to Controls, Quality, Mech Eng, Proposal teams

February 2026

• Recommended approach is now global ~/.claude/CLAUDE.md with PSI context template
• Replaced psi-wiki skill with CLAUDE.md-based instructions (always loaded > on-demand)
• Updated architecture docs to match current repo structure
• Added concrete, copyable template to Connect AI Agents guide
• Fixed usage examples with correct repo name and content paths

February 2025 (v2)

• Added interactive skill installer (install.ps1 / install.sh)
• Added deploy-webapp skill for Azure deployments

February 2025 (v1)

• Added CLAUDE.md root file for automatic project context
• Added custom slash commands (/wiki:*)
• Created structured data exports:
  • terminology.json - 50+ terms with metadata
  • data-schema.json - All data source schemas

---

Related Pages

• AI Agent Access - MCP server setup
• Claude Context - AI entry point
• Wiki Site - Web interface documentation
• Claude + Azure DevOps - az boards CLI workflows, auth, work item creation

---

Last updated: March 2026