0004 — Rewrite providers/claude-code/CLAUDE.md and retire global.md #25

New Issue

Claude · 2026-06-28T17:09:50Z

Claude commented

2026-06-28 17:09:50 +00:00

What to build

Replace the sparse content in providers/claude-code/CLAUDE.md with a complete always-on section covering communication style and behavior rules, plus a content index that tells the agent when to load each topic instruction file. Delete core/instructions/global.md, which is a placeholder stub with no content — the content index update makes it obsolete.

The always-on communication rules define how the agent responds: answer directly first, challenge bad ideas explicitly rather than validating them, explain the why behind decisions, and never soften disagreement into a suggestion.

The always-on behavior rules define when the agent asks permission: reads and exploration proceed freely; writes, edits, and git operations state intent before acting; irreversible or shared-state operations (push, drop, publish) require explicit confirmation every time.

The content index provides inline load triggers so the agent knows when to read each on-demand instruction file without requiring frontmatter in those files.

Acceptance criteria

providers/claude-code/CLAUDE.md contains an always-on communication section with all seven rules from the PRD
providers/claude-code/CLAUDE.md contains an always-on behavior section covering reads, writes, and irreversible operations
Content index includes load triggers for: coding conventions, git conventions, testing conventions, and workflows/agents/prompts
core/instructions/global.md is deleted
In a new session, ask an exploratory design question — agent responds with one recommendation and one tradeoff in 2–3 sentences
In a new session, propose a clearly overengineered approach — agent names the problem rather than implementing it
In a new session, ask the agent to edit a file — agent states what it is about to do before proceeding
In a new session, ask the agent to push a commit — agent requires explicit confirmation

Blocked by

None — can start immediately

## What to build Replace the sparse content in `providers/claude-code/CLAUDE.md` with a complete always-on section covering communication style and behavior rules, plus a content index that tells the agent when to load each topic instruction file. Delete `core/instructions/global.md`, which is a placeholder stub with no content — the content index update makes it obsolete. The always-on communication rules define how the agent responds: answer directly first, challenge bad ideas explicitly rather than validating them, explain the why behind decisions, and never soften disagreement into a suggestion. The always-on behavior rules define when the agent asks permission: reads and exploration proceed freely; writes, edits, and git operations state intent before acting; irreversible or shared-state operations (push, drop, publish) require explicit confirmation every time. The content index provides inline load triggers so the agent knows when to read each on-demand instruction file without requiring frontmatter in those files. ## Acceptance criteria - [ ] `providers/claude-code/CLAUDE.md` contains an always-on communication section with all seven rules from the PRD - [ ] `providers/claude-code/CLAUDE.md` contains an always-on behavior section covering reads, writes, and irreversible operations - [ ] Content index includes load triggers for: coding conventions, git conventions, testing conventions, and workflows/agents/prompts - [ ] `core/instructions/global.md` is deleted - [ ] In a new session, ask an exploratory design question — agent responds with one recommendation and one tradeoff in 2–3 sentences - [ ] In a new session, propose a clearly overengineered approach — agent names the problem rather than implementing it - [ ] In a new session, ask the agent to edit a file — agent states what it is about to do before proceeding - [ ] In a new session, ask the agent to push a commit — agent requires explicit confirmation ## Blocked by None — can start immediately

Claude added this to the Legacy / Triage milestone 2026-06-28 17:09:50 +00:00

Claude closed this issue

2026-06-28 17:09:55 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Defame1297/holocron#25