cal/claude-configs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a7b5c25766
claude-configs/CLAUDE.md
Cal Corum a7b5c25766 Add SSH key instructions and commit-push command 
- CLAUDE.md: Add SSH section with homelab/cloud key conventions
- Add commit-push command skill
- Update session memory script

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 17:51:46 -06:00

2.1 KiB
Raw Blame History

🚨 CRITICAL: @ MENTION HANDLING 🚨

When ANY file is mentioned with @ syntax, IMMEDIATELY call Read tool on that file BEFORE responding. Automatic loads are NOT enough — Read loads required CLAUDE.md context along the file path.

Behavior

  • User's name is Cal (he/him)
  • If not confident in an answer, say so. Offer hypothesis + options to investigate.
  • When writing tests, include detailed docstrings explaining "what" and "why"
  • Launch sub-agents with Sonnet model unless another model is specified by the user

Git Commits

  • NEVER commit/add/push/tag without explicit user approval ("commit this", "go ahead")
  • Don't autopilot: find bug → fix → ASK → commit. Silence ≠ approval.
  • Applies to: git commit, git add, git tag, git push, deploy scripts

Gitea Operations

ALWAYS use tea CLI for Gitea. Never use gh api --hostname.

  • Authenticated: cal@homelab (https://git.manticorum.com)
  • Common: tea repos list, tea pulls list, tea issues list
  • Create PR: tea pulls create --head <branch> --base main --title "Title" --description "Desc"
  • Common repos: cal/major-domo-database, cal/major-domo-bot, cal/paper-dynasty, cal/paper-dynasty-database

Tech Preferences

  • Python with uv for package/environment management
    • Utilize dependency injection pattern whenever possible
  • Never add lazy imports to middle of file

SSH

  • Use ssh -i ~/.ssh/homelab_rsa cal@<host> for homelab servers (10.10.0.x)
  • Use ssh -i ~/.ssh/cloud_servers_rsa root@<host> for cloud servers (Akamai, Vultr)
  • Keys are installed on every server — never use passwords or expect password prompts

Memory Protocol (Cognitive Memory)

  • Skill: ~/.claude/skills/cognitive-memory/ | Data: ~/.claude/memory/
  • Session start: Load ~/.claude/memory/CORE.md and REFLECTION.md
  • Auto-store on: bug fixes, git commits (mandatory, --episode), architecture decisions, patterns, configs
  • Always tag: project name + technology + category
  • Session end: prompt "Should I store today's learnings?"
  • Full docs: claude-memory --help or ~/.claude/skills/cognitive-memory/SKILL.md