blumeops/CLAUDE.md
Erich Blume dd6d024b3a Add Brewfile and document dependency tracking
- Add Brewfile with tea (Forgejo CLI) for forge interaction
- Update CLAUDE.md with dependency tracking guidance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 21:38:58 -08:00

1.4 KiB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

blumeops is Erich Blume's GitOps repository for personal infrastructure management, orchestrated via tailnet tail8d86e.ts.net.

Documentation

Project documentation lives in the zettelkasten at ~/code/personal/zk. Start with the project card: 1767747119-YCPO.md.

You are encouraged to explore the zk, follow links, and propose updates to it as the project evolves.

Tool Preferences

  1. mise - preferred for tool/runtime management (check first)
  2. homebrew - for system packages

Dependency Tracking

Track project dependencies in version control:

  • Brewfile (repo root) - homebrew packages (brew bundle)
  • mise.toml (per-directory) - runtimes and tools (mise install)

Service Management

  • Homebrew services: brew services start|stop|restart <service>
  • Non-homebrew services: use mcquack (LaunchAgent manager for macOS)

Ansible

Run playbooks from the ansible/ directory.

# Install collection dependencies
ansible-galaxy collection install -r requirements.yml

# Dry-run before committing changes
ansible-playbook playbooks/indri.yml --check --diff

# Apply changes
ansible-playbook playbooks/indri.yml

Always dry-run (--check --diff) ansible changes before committing.