Claude Code Settings - ID8Labs
Personal Claude Code configuration for cross-machine sync and team sharing.
Quick Start
New Machine Setup
cd ~
git clone https://github.com/eddiebe147/claude-settings.git .claude
Sync Between Machines
# Pull latest
cd ~/.claude && git pull
# Push changes
cd ~/.claude && git add . && git commit -m "update" && git push
What's Inside
| Folder |
Purpose |
Count |
agents/ |
Specialized AI agents for specific domains |
38+ |
skills/ |
Reusable skill modules (slash commands) |
21 |
hooks/ |
Automation scripts (pre/post actions) |
26 |
commands/ |
Quick slash commands |
21 |
plugins/ |
Claude Code plugin configs |
- |
Core Files
| File |
Purpose |
CLAUDE.md |
Global instructions for ALL projects |
settings.json |
Claude Code preferences |
hooks.json |
Hook configurations |
mcpServers.json |
MCP server connections |
Agents
Specialized AI agents in agents/ folder. Each handles a specific domain.
Development Agents
| Agent |
Description |
nextjs-senior-dev.md |
Next.js 14+ App Router expert |
backend-architect.md |
Backend system architecture |
database-migration-specialist.md |
Database schema migrations |
MCP Ecosystem Agents
| Agent |
Description |
mcp-server-architect.md |
Design MCP servers |
mcp-protocol-specialist.md |
Protocol compliance |
mcp-integration-engineer.md |
Multi-server orchestration |
mcp-deployment-orchestrator.md |
Production deployments |
mcp-security-auditor.md |
Security reviews |
mcp-testing-engineer.md |
Testing & QA |
mcp-registry-navigator.md |
Registry discovery |
Business & Strategy Agents
| Agent |
Description |
market-intelligence-analyst.md |
Market research & trends |
steve-jobs-advisor.md |
Visionary product guidance |
strategic-think-tank.md |
Major business decisions |
operations-manager.md |
Project coordination |
relationship-builder.md |
Client relationships |
Content & Marketing Agents
| Agent |
Description |
social-media-manager.md |
Social content creation |
x-viral-optimizer.md |
X/Twitter optimization |
nana-image-generator.md |
AI image generation |
notebooklm-producer.md |
Audio/video from docs |
reality-tv-beat-writer.md |
Documentary production |
TMNT Dev Team (Fun Names!)
| Agent |
Role |
leonardo-strategist-agent.md |
Strategy & planning |
donatello-architect-agent.md |
Technical architecture |
michelangelo-builder-agent.md |
Implementation |
raphael-guardian-agent.md |
Security & protection |
splinter-mentor-agent.md |
Mentorship |
krang-brain-agent.md |
AI/ML expertise |
bebop-devops-agent.md |
DevOps |
rocksteady-database-agent.md |
Database |
casey-tester-agent.md |
Testing |
Full Projects
| Project |
Description |
reddit-research/ |
Market research agent using Reddit's JSON API |
Skills
Reusable modules in skills/ that extend Claude's capabilities.
Development Skills
| Skill |
Purpose |
nextjs-project-manager |
Next.js 14+ project guidance |
api-design |
RESTful API design |
database-design |
Schema & Supabase |
supabase-expert |
Supabase integration |
testing-qa |
Test automation |
performance-optimization |
Speed & Core Web Vitals |
state-management |
React state (Zustand, Context) |
ui-builder |
React + Tailwind + Shadcn |
Infrastructure Skills
| Skill |
Purpose |
deployment-automation |
Vercel & CI/CD |
file-uploads |
File handling & cloud storage |
error-monitoring |
Logging & Sentry |
real-time-features |
WebSockets & Supabase Realtime |
mcp-builder |
Build MCP servers |
Business Skills
| Skill |
Purpose |
llc-ops |
LLC operations for ID8Labs |
analytics-tracking |
User analytics & A/B testing |
email-notifications |
Transactional emails |
Hooks
Automation scripts in hooks/ that run before/after actions.
Quality Gates
| Hook |
Trigger |
Purpose |
code-review-gate.sh |
Before PR |
Code quality check |
quality-gate-check.sh |
Before commit |
Standards enforcement |
pre-commit.sh |
Before commit |
Pre-commit checks |
post-commit.sh |
After commit |
Post-commit actions |
Workflow Automation
| Hook |
Purpose |
auto-commit.sh |
Automatic commits |
auto-git-workflow.sh |
Git flow automation |
auto-documentation.sh |
Doc generation |
enforce-feature-branch.sh |
Branch protection |
suggest-feature-branch.sh |
Branch suggestions |
Verification
| Hook |
Purpose |
verify-after-edit.sh |
Verify edits worked |
verify-after-write.sh |
Verify writes worked |
verify-deployment.sh |
Check deployments |
deployment-check.sh |
Pre-deploy validation |
Session Management
| Hook |
Purpose |
session-persist.sh |
Save session state |
session-recovery-check.sh |
Recover sessions |
progress-report.sh |
Progress tracking |
milestone-tracker.sh |
Milestone tracking |
Specialized
| Hook |
Purpose |
browser-automation-check.sh |
Playwright/Comet checks |
accessibility-check.sh |
A11y validation |
performance-alert.sh |
Performance monitoring |
Commands
Quick slash commands in commands/ for common actions.
Feature Development
| Command |
Purpose |
/start |
Begin new feature |
/feature-dev |
Complete feature workshop |
/ship |
Complete & create PR |
/idea |
Brainstorm & plan |
Code Management
| Command |
Purpose |
/fix |
Debug & fix issues |
/test |
Run Playwright tests |
/cleanup |
Clean up project |
/compare |
Compare changes |
/preview |
Preview before commit |
/rollback |
Undo changes |
Documentation
| Command |
Purpose |
/docs |
Generate documentation |
/explain |
Explain in plain English |
/status |
Project status report |
Session
| Command |
Purpose |
/save-state |
Save session checkpoint |
/resume |
Resume from checkpoint |
Help
| Command |
Purpose |
/CHEATSHEET |
Quick reference |
/COMMAND-MAP |
Visual command map |
/GETTING-STARTED |
Getting started guide |
/WHICH-COMMAND |
Find right command |
Configuration Files
CLAUDE.md (Global Instructions)
The CLAUDE.md file contains global instructions that apply to ALL projects:
- Agentic Patterns: Reflection, PEV (Plan-Execute-Verify), Metacognitive
- ID8Pipeline: 12-stage build process for all projects
- Auto-Approve Commands: Commands that don't need confirmation
- Comet Browser Automation: Playwright MCP integration
hooks.json
Configures which hooks run and when:
{
"hooks": [
{ "event": "pre-commit", "script": "hooks/pre-commit.sh" },
{ "event": "post-edit", "script": "hooks/verify-after-edit.sh" }
]
}
settings.json
Claude Code preferences (theme, model defaults, etc.)
Project: Reddit Research Agent
Full market research agent at agents/reddit-research/:
cd ~/.claude/agents/reddit-research
npm install
npx tsx src/agent/index.ts help
Features:
- Extracts pain points, opportunities, competitor mentions
- Uses Reddit's hidden JSON API (add
/.json to any URL)
- Web dashboard at localhost:3456
- Slack/Email alerts
- Notion sync
- Multi-agent parallel scanning
File Structure
~/.claude/
├── CLAUDE.md # Global instructions
├── README.md # This file
├── settings.json # Preferences
├── hooks.json # Hook configs
├── mcpServers.json # MCP servers
│
├── agents/ # 38+ specialized agents
│ ├── *.md # Agent definitions
│ └── reddit-research/ # Full project
│
├── skills/ # 21 skill modules
│ ├── nextjs-project-manager/
│ ├── supabase-expert/
│ └── ...
│
├── hooks/ # 26 automation scripts
│ ├── code-review-gate.sh
│ ├── auto-commit.sh
│ └── ...
│
├── commands/ # 21 slash commands
│ ├── start.md
│ ├── ship.md
│ └── ...
│
└── plugins/ # Plugin configs
└── marketplaces/
Tips
Adding a New Agent
- Create
agents/my-agent.md
- Define role, capabilities, and when to use
- Commit and push
Adding a New Skill
- Create
skills/my-skill/ directory
- Add skill definition files
- Register in manifest if needed
Adding a New Hook
- Create
hooks/my-hook.sh
- Make executable:
chmod +x hooks/my-hook.sh
- Register in
hooks.json
Sync Troubleshooting
Merge conflicts:
cd ~/.claude
git stash
git pull
git stash pop
# Resolve conflicts manually
Reset to remote:
cd ~/.claude
git fetch origin
git reset --hard origin/main
License
MIT - ID8Labs
