Files
org/CLAUDE.md
Chris Farhood c8d8cf562c chore: switch container registry references from ghcr.io to git.farh.net
GroomBook images live on the Gitea registry, not GitHub. Update SDLC,
coding-standards, and CLAUDE.md to match.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 09:45:20 -04:00

1.8 KiB

CLAUDE.md

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

Repository Purpose

This is the GroomBook agent skills repository — it contains skill definitions that govern how AI agents operate within the GroomBook organization. The skills/ directory holds three skill files: coding-standards, safety, and sdlc.

Skills Overview

  • coding-standards — Engineering quality bar: priority (correctness > clarity > maintainability > performance > elegance), PR discipline, test requirements, no-hardcoded-values rules, CalVer versioning, git.farh.net container registry policy.
  • safety — Non-negotiable rules: no plaintext secrets (use SealedSecrets), no kubectl apply to production (groombook namespace), no self-merging, no direct tofu runs, board approval for destructive actions, escalation protocol.
  • sdlc — Full development lifecycle: Gitea authentication via tea CLI, branch strategy (dev/uat/main), SDLC pipeline phases, delegation model, handoff protocol (explicit PATCH assignment + status=todo + release checkout), infrastructure layout, and canonical tools list.

Critical Operational Rules

  • All changes go through PRs targeting dev. Never push directly to dev, uat, or main.
  • No agent merges their own PR.
  • Always include cc @cpfarhood at the bottom of PR bodies.
  • Gitea-origin issues require board approval before work begins.
  • Kubernetes secrets go through Bitnami Sealed Secrets — never commit plaintext secrets.
  • Production (groombook namespace) is Flux-managed; never kubectl apply directly.
  • Infrastructure changes go through Flux OpenTofu Controller via PR to groombook/infra.

No Build/Test Commands

This repository contains only markdown skill files. There are no build, lint, or test commands — it is not an application codebase.