A structured workspace template for planning computer hardware upgrades with Claude Code. Whether you're upgrading a gaming PC, workstation, homelab server, or managing multiple machines, this template provides an organized environment for AI-assisted hardware planning.

• Structured context gathering - Systematic collection of user preferences, budget constraints, and requirements
• Hardware profiling - Document current specs for compatibility analysis
• Multi-machine support - Plan upgrades for multiple computers in one workspace
• Formal estimates - Generate VAT-compliant quotes for business use
• Currency localization - All outputs in your preferred currency
• Privacy-aware - Tools to redact sensitive data before sharing

1. Use this template - Click the green "Use this template" button above
2. Clone your new repo - git clone <your-repo-url>
3. Open with Claude Code - cd Claude-Rig-Planner && claude
4. Run setup - Type /setup to begin the initial interview

Claude-Rig-Planner/
├── context/              # User preferences, budget, hardware specs
│   ├── user-context.md   # Your preferences and requirements
│   ├── budget.md         # Budget constraints
│   └── machines/         # Hardware profiles per machine
├── inputs/               # Files for the agent to process
│   └── (screenshots, quotes, system exports)
├── data/                 # Retrieved pricing and specification data
├── outputs/              # Agent's analysis and recommendations
│   ├── analysis/         # Compatibility and bottleneck analysis
│   ├── estimates/        # Formal cost estimates
│   ├── recommendations/  # Component recommendations
│   └── reports/          # Summary reports
├── prompts/              # Your custom prompts and instructions
├── agent-instructions/   # Detailed agent behavior guidelines
└── .claude/commands/     # Slash commands for common workflows

Run /setup to complete the initial interview. The agent will ask about:

• Your location and preferred currency
• Budget constraints (total and per-component)
• Preferred vendors and brands
• Use case (gaming, AI/ML, content creation, etc.)
• Business context (if estimates need VAT formatting)

Run /profile to document your current hardware. The agent can:

• Scan local machines directly
• Connect via SSH to network machines
• Process screenshots or exports you place in /inputs/
• Accept manual specification input

Run /analyze to identify bottlenecks and upgrade opportunities, then /recommend to get specific component suggestions within your budget.

Run /estimate to generate formal quotes. Business users can get VAT-compliant estimates suitable for accountant review or internal approval.

Place files in the /inputs/ directory for the agent to process:

• Screenshots - Shopping cart images, spec screenshots
• System exports - JSON/CSV from hardware detection tools
• Quotes - Existing quotes or invoices for comparison

For enhanced functionality, consider installing these MCP servers:

See agent-instructions/mcp-recommendations.md for setup details.

This template supports planning upgrades for multiple computers:

• Each machine gets its own profile in /context/machines/{name}/
• Track per-machine and aggregate budgets
• Cross-reference shared components for bulk purchasing
• Generate consolidated reports

Before sharing your workspace:

• The agent will offer to redact serial numbers and sensitive data
• /inputs/ may contain personal screenshots - review before sharing
• /context/business.md contains business details - exclude if sharing publicly

MIT License - see LICENSE for details.

To view an index of my Claude Code related projects, click here.