# Install
npm install -g @anthropic-ai/claude-code

# Open a project and start
cd your-project && claude

# Ask it to explain the architecture
> Explain this project's architecture. Read every file you need.

# Pipe logs through Claude for real-time analysis
tail -f /var/log/app.log | claude -p "alert me on errors above WARN"

# Use plan mode for complex tasks
> /plan Refactor the auth system to use JWT refresh tokens

# Extended thinking on architecture decisions
> ultrathink: Should we use a monorepo or separate repos?

# ~/.claude/CLAUDE.md -- global identity
I am Walid. I build AI automation systems.
Never use emojis. Always be direct. Code in TypeScript.

# project/CLAUDE.md -- project-specific rules
This is a Next.js 15 app using App Router.
Database: Supabase. Auth: Clerk.
Always use server components by default.

# .claude/rules/api.md -- path-scoped (src/api/**)
All API routes must validate input with Zod.
Always return consistent { data, error } shape.

# In CLAUDE.md -- reference external files
@clients/active-clients.md
@api/openapi-spec.yaml
@brand/style-guide.md

# .claude/rules/frontend.md -- scoped to src/components/**
Always use our design system tokens from @brand/tokens.ts
Follow the component pattern in @docs/component-guide.md
Never inline styles. Use Tailwind classes only.

# .claude/commands/content.md
Generate a LinkedIn post about: $ARGUMENTS

Rules:
- Use my voice from @CLAUDE.md
- 1000-1300 characters max
- Include specific metrics
- End with a clear CTA
- No emojis. No fluff. No corporate speak.

# Usage:
> /content how we saved a client 20 hrs/week with one workflow

# .claude/settings.json -- hook configuration
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "command": "bash .claude/scripts/check-secrets.sh \"$INPUT\""
    }],
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "command": "bash .claude/scripts/notify-change.sh \"$FILEPATH\""
    }]
  }
}

# .mcp.json -- server configuration
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-slack"],
      "env": { "SLACK_TOKEN": "xoxb-..." }
    },
    "attio": {
      "command": "node",
      "args": [".claude/skills/mcp-client/scripts/attio_server.mjs"]
    }
  }
}

# Now Claude can:
> Post this update to #engineering in Slack
> Add this prospect to Attio with source "LinkedIn DM"

# .claude/skills/carousel-maker/SKILL.md
## Carousel Maker

Trigger: User asks for a LinkedIn carousel or slide deck.

Steps:
1. Extract key points from the input
2. Structure into 8-12 slides
3. Apply brand identity from references/brand-identity.md
4. Generate HTML slides with export.py
5. Preview and iterate

References: brand-identity.md, slide-patterns.md
Scripts: export.py, preview.py

# .claude/agents/prospect-researcher.md
## Prospect Researcher

You are a prospect research agent. Your job:
1. Take a company name or LinkedIn URL
2. Research: team size, funding, tech stack, pain points
3. Score against our ICP (10-80 employees, ops-heavy)
4. Output a structured brief to 01_Projects/Clients/Prospects/

You have access to: Apollo MCP, web search, Attio CRM.
You do NOT: send messages, modify CRM records, or contact anyone.

# Launch multiple agents
> Run prospect-researcher on "Acme Corp" in background
> Run content-writer on "AI agents for logistics" in background
> Run security-auditor on the auth module in background

# The architecture
Second Brain (PARA + Obsidian + Git)
    |
Claude Code (orchestration layer)
    |
    +-- 59 Skills     (capabilities)
    +-- 36 Commands   (workflows)
    +-- 12 Agents     (specialists)
    +-- 9 MCP Servers  (external APIs)
    +-- 7 Hooks       (guardrails)
    |
Output: Sales, Content, Outreach, Engineering, Ops
    |
One terminal. One brain. One system.