From d8bd81758880f1775bd17ab1573fecf7577e9e08 Mon Sep 17 00:00:00 2001
From: nuestraai <david@nuestra.ai>
Date: Wed, 22 Apr 2026 01:31:22 -0500
Subject: [PATCH] chore: add CLAUDE.md with stack conventions and control-plane
 pointer (#2)

---
 CLAUDE.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..3fb53b287
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,19 @@
+# picoclaw — Claude Code Rules
+
+## What This Is
+Tiny, fast, deployable-anywhere automation CLI — part of the claw family of AI assistants.
+
+## Stack & Conventions
+- **Go** (module `github.com/sipeed/picoclaw`). CLI entry in `cmd/`, config in `config/`, docker in `docker/`.
+- Tests: `go test ./...`. Build: `make build` (see `Makefile`).
+- This repo is a nuestra-ai fork that tracks an upstream; be conservative about restructuring that would conflict with upstream merges.
+
+## Control Plane
+Directives, skills, agent definitions, and the broader context tree live in the **agent-platform umbrella repo** at `../agent-platform/`. For cross-repo work or any `/directive` pipeline usage, open Claude from there:
+
+```bash
+cd ../agent-platform && claude
+```
+
+## Git Operations
+NEVER perform git operations without explicit user approval.