chore: bootstrap repo with chunks 1 and 2
Establishes the global AI development config repo from scratch: - Chunk 1: repo skeleton, install.sh, statusline, deploy manifest - Chunk 2: core instructions (coding/git/testing), CLAUDE.md rewrite (always-on + content index two-tier model), docs restructure, 6 ADRs, ROADMAP.md, .gitkeep placeholders - Bootstrap skills in .claude/skills/ (to be catalogued and migrated to .agents/skills/ in Chunk 3) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
26
docs/issues/0004-rewrite-claude-md.md
Normal file
26
docs/issues/0004-rewrite-claude-md.md
Normal file
@@ -0,0 +1,26 @@
|
||||
# 0004 — Rewrite providers/claude-code/CLAUDE.md and retire global.md ✅
|
||||
|
||||
## 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
|
||||
Reference in New Issue
Block a user