docs: remove redundant warning callouts and key-rules section
## 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 <noreply@anthropic.com>
This commit is contained in:
@@ -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.
|
||||
|
||||
@@ -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
|
||||
|
||||
<!-- rtk-instructions v2 -->
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user