claude-code-basecamp: Instructions file for Claude Code

Overview

This is a meta-repository for Claude Code. It serves as a unified workspace with shared skills, commands, and hooks — so every team member gets consistent, high-quality AI assistance from day one.

Note: The "Agent Docs" listing below is auto-generated from frontmatter in markdown files in agent-docs/.

Critical Requirements

1. Read relevant documentation first - Before taking action on any task:

   • Review the Agent Docs list below
   • Read ALL documents relevant to your task before proceeding
   • Re-evaluate after encountering failures or gaining new insights—additional documents may become relevant

2. Use uv for Python execution - Execute all scripts and tools with uv run <script/tool>. This workspace exclusively uses uv for package and environment management. For scripts with inline dependencies (PEP 723), run them directly (uv run script.py) to ensure dependencies resolve correctly.

3. Use available skills - Check if relevant skills are available in your environment for your tasks, and if there are - utilize them.

4. Verify before diagnosing - When analyzing failures or investigating issues, use documentation and available tools to verify facts. Provide diagnoses ONLY after verification.

5. Write minimal, correct code (Ponytail ladder) - Before writing any code, stop at the first rung that holds:

   1. Does this need to be built at all? (YAGNI)
   2. Does it already exist in this codebase? Reuse the helper, util, or pattern that's already here, don't re-write it.
   3. Does the standard library already do this? Use it.
   4. Does a native platform feature cover it? Use it.
   5. Does an already-installed dependency solve it? Use it.
   6. Can this be one line? Make it one line.
   7. Only then: write the minimum code that works.