From 439978f63313725a620cf4079447be5e3ba069ba Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 26 Mar 2026 11:30:56 +0000
Subject: [PATCH] Standardize CLAUDE.md and settings.json: fix typo, add
 schema, add git permissions, add build instructions

---
 .claude/settings.json | 13 ++++++++-----
 CLAUDE.md             |  9 ++++++++-
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/.claude/settings.json b/.claude/settings.json
index e0b139f..5686477 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -1,4 +1,5 @@
 {
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
   "attribution": {
     "commit": "",
     "pr": ""
@@ -6,17 +7,19 @@
   "permissions": {
     "allow": [
       "Bash(git add:*)",
+      "Bash(git branch:*)",
+      "Bash(git checkout:*)",
       "Bash(git commit:*)",
-      "Bash(git push:*)",
-      "Bash(git pull:*)",
-      "Bash(git status:*)",
       "Bash(git diff:*)",
-      "Bash(git log:*)"
+      "Bash(git fetch:*)",
+      "Bash(git log:*)",
+      "Bash(git pull:*)",
+      "Bash(git push:*)",
+      "Bash(git status:*)"
     ],
     "deny": [
       "mcp__github__create_or_update_file",
       "mcp__github__push_files",
-      "mcp__github__create_or_update_files",
       "mcp__github__delete_file"
     ]
   }
diff --git a/CLAUDE.md b/CLAUDE.md
index 3d10c5e..e5507bd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -7,5 +7,12 @@
 
 # Cycles strict rules
 - yaml API specs always the authority
-- always udated AUDIT.md files when making changes to server, admin, client repos
+- always update AUDIT.md files when making changes to server, admin, client repos
 - maintain at least 95% or higher test coverage for all code repos
+
+# Build & Test
+- Install: `pip install -e ".[dev]"`
+- Test: `pytest`
+- Test with coverage: `pytest --cov=runcycles`
+- Lint & format: `ruff check` / `ruff format`
+- Type check: `mypy`