arach

Personal skill index for Arach (@arach). This is the entry point for understanding my projects, conventions, and how to work with my codebase.

Conventions

Always follow these when working on my projects:

• Use pnpm over npm (check for pnpm-lock.yaml first)
• Add gitmoji to all commit messages (✨ feature, 🐛 fix, 🎨 improve, etc.)
• NEVER add co-authoring attribution or "Generated with Claude Code" footers
• Allow all Puppeteer uses without asking
• Prefer editing existing files over creating new ones

Key Projects

Documentation & Dev Tools

| Project | Description | Skill | |---------|-------------|-------| | dewey | Documentation toolkit for AI-agent-ready docs | npx skills add arach/dewey | | arc | Visual architecture diagram editor | npx skills add arach/arc | | og | Open Graph image generator | — | | hooked | Voice & until loops for Claude Code | — |

Apps — macOS/iOS

| Project | Description | Path | |---------|-------------|------| | Talkie | Voice conversation app | ~/dev/talkie | | Scout | Audio transcription | ~/dev/scout | | Speakeasy | Voice assistant | ~/dev/speakeasy | | Pomo | Pomodoro timer | ~/dev/pomo | | Tempo | Time tracking | ~/dev/tempo |

Web Properties

| Project | Description | Path | |---------|-------------|------| | arach.dev | Personal site | ~/dev/arach.dev | | arach.io | Portfolio | ~/dev/arach.io | | usetalkie.com | Talkie landing page | ~/dev/usetalkie.com | | agentlist.io | AI agent directory | ~/dev/agentlist.io |

Libraries & Experiments

| Project | Description | Path | |---------|-------------|------| | agentloop | Agent loop primitives | ~/dev/agentloop | | fabric | UI framework experiments | ~/dev/fabric |

Installing Skills

When working on a specific project, install its skill for deeper context:

# Install all arach skills (this meta-skill)
npx skills add arach/arach

# Install specific project skills
npx skills add arach/arc        # Architecture diagrams
npx skills add arach/dewey      # Documentation toolkit

Project Detection

When I mention or you detect I'm working in:

| Context | Action | |---------|--------| | ~/dev/arc or "architecture diagram" | Load arc-diagrams skill | | ~/dev/dewey or "documentation" | Load dewey-docs skill | | ~/dev/talkie or "voice app" | Swift/SwiftUI macOS app context | | Any ~/dev/* project | Check for local CLAUDE.md first |

Tech Stack Preferences

| Category | Preference | |----------|------------| | Package manager | pnpm | | Frontend | React + TypeScript + TailwindCSS | | Desktop apps | Swift/SwiftUI (macOS), Tauri (cross-platform) | | Build tools | Vite, Turbo | | Testing | Vitest, Playwright | | State | Zustand |

Common Commands

# Development
pnpm dev          # Start dev server
pnpm build        # Production build
pnpm test         # Run tests
pnpm lint         # Lint code

# Swift/macOS
swift build       # Build Swift package
swift run         # Run in debug mode

# Git (always with gitmoji)
git commit -m "✨ Add new feature"
git commit -m "🐛 Fix bug in component"
git commit -m "🎨 Improve code structure"
git commit -m "📝 Update documentation"
git commit -m "🔧 Update configuration"

Directory Structure

~/dev/
├── arach/          # This repo (GitHub profile + meta-skill)
├── arc/            # Architecture diagrams [has skill]
├── dewey/          # Documentation toolkit [has skill]
├── talkie/         # Voice conversation app
├── speakeasy/      # Voice assistant
├── arach.dev/      # Personal website
├── ...             # ~100 other projects

When Starting Fresh

On a new machine, bootstrap everything:

# 1. Install this meta-skill
npx skills add arach/arach

# 2. Claude now knows all projects and can install specific skills as needed

Links

• GitHub: github.com/arach
• Site: arach.dev
• X: @arach
• Site: arach.io