From 9a0e0c31b94fce803e0c0a79c3d0a3551cd270db Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Sun, 28 Jun 2026 18:06:30 +0000 Subject: [PATCH] docs: remove redundant warning callouts and key-rules section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Why The WARNING admonition blocks in CLAUDE.md and providers/claude-code/CLAUDE.md added noise without adding clarity — the file paths already communicate which config is which. The "Key rules" block in AGENTS.md duplicated guidance already present in the content index above it. Co-authored-by: Claude Sonnet 4.6 --- AGENTS.md | 6 ------ CLAUDE.md | 5 ----- providers/claude-code/CLAUDE.md | 8 -------- 3 files changed, 19 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index bebf874..e225f92 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,14 +21,8 @@ Read these on demand: - `docs/ai-constitution.md` — full governance evidence base; read when a governance decision needs justification - `docs/research/ai-coding-factory/ai-coding-factory-principles.md` — factory design rationale; read when implementing, auditing, or reviewing skills or factory structure - `docs/notes/factory-integration-decisions.md` — decisions from the factory integration grill; read when making skill authoring or factory design decisions -- `docs/wiki/HUMANS.md` — human practitioner checklist; applies when working with AI tools in this repo - Governance rules are always in effect — `core/instructions/governance.md` (agent rules); `docs/research/governance_principles/CONTROLS.md` -## Key rules - -- `providers/claude-code/CLAUDE.md` is the deployed global config — edit it there, not here -- Governance constraints from `core/instructions/governance.md` apply when building content in this repo — hard prohibitions on secrets and data, HITL requirements before irreversible actions, sycophancy resistance, and deterministic execution preference are always in effect - ## Working context This repo is built by a junior developer as a homelab tool intended to scale to professional environments. Challenge ideas and reference industry standards rather than validate assumptions. Explain the why behind decisions — assume the user is learning, not just executing. Flag significant actions before taking them. diff --git a/CLAUDE.md b/CLAUDE.md index 46f4ee7..31c4b15 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,8 +1,3 @@ -> [!WARNING] -> **This is the repo meta-config.** It tells Claude how to work *inside this repository itself* — structure, conventions, how to add skills/workflows/providers. -> -> It is NOT the global config deployed to `~/.claude/`. That file lives at `providers/claude-code/CLAUDE.md`. Do not conflate the two. - @AGENTS.md diff --git a/providers/claude-code/CLAUDE.md b/providers/claude-code/CLAUDE.md index ba70a4c..1b0ed76 100644 --- a/providers/claude-code/CLAUDE.md +++ b/providers/claude-code/CLAUDE.md @@ -1,10 +1,2 @@ -> [!WARNING] -> **This is the global Claude Code config deployed to `~/.claude/`.** It is installed by `install.sh` and governs Claude's behavior across all projects. -> -> It is NOT the repo meta-config. That file lives at the root `CLAUDE.md` and tells Claude how to work inside this repo. Do not conflate the two. - -# Always-on rules - @~/.agents/AGENTS.md - @~/.claude/core/instructions/governance.md