Claude Code Integration

Fp Switchboard includes built-in Claude Code commands for common development workflows. These are available when working in the repository with Claude Code.

Available Commands

`/verify-tool` — Verify Tool Implementation

Checks that a newly implemented or modified tool works correctly.

What it does:

Runs npm run build to verify compilation
Checks tool registration in the service’s tool list
Verifies tool schema (required fields, types, descriptions)
Checks tool annotations (readOnlyHint, destructiveHint, idempotentHint)
Reports findings with suggested fixes

Usage:

/verify-tool hubspot_create_contact

`/commit-push-pr` — Commit, Push & PR

Streamlined workflow to commit changes, push to remote, and create a pull request.

What it does:

Verifies build passes
Reviews changes and generates a commit message
Stages and commits
Pushes to remote
Creates a PR with summary and test plan

Usage:

/commit-push-pr

Auto-Triggered Skills

The repository includes skill definitions that Claude Code activates automatically based on context:

Skill	Triggers When
fp-switchboard-tools	Adding or modifying tools, implementing handlers
fp-switchboard-onboarding	Adding new services, OAuth setup
fp-switchboard-oauth	Token errors, OAuth debugging, auth issues
cloudflare-workers	D1 queries, Hono patterns, Workers deployment

These provide specialized context and guidance without needing to be invoked manually.

Prompt Generator Integration

The Switchboard Prompt Generator can output prompts in Skill Mode for Claude Code:

Minimal system prompt (~1K tokens)
Full service guidelines loaded on-demand via the skill system
Best for Claude Code users who want fast startup without large prompts

Project Structure

Key directories for Switchboard development:

Directory	Contents
`src/src/tools/`	Service tool implementations (one file per service)
`src/src/services/`	Service registry, permissions, tool-registry
`src/src/auth/`	Middleware, encryption, database, user management
`src/src/ui/`	Templates, styles, setup guides, prompt generator
`src/src/routes/`	Dashboard, OAuth, admin route handlers
`src/test/`	590+ Vitest tests
`docs/`	Architecture, planning, and reference documentation

Development Workflow

Make changes in the relevant src/src/ files
Run /verify-tool if you modified a tool
Run targeted tests: cd src && npx vitest run test/unit/<file>.spec.ts
Build: cd src && npm run build
Deploy: cd src && npx wrangler deploy
Use /commit-push-pr to commit and create a PR