mirror of
https://github.com/wassname/.tweakcc.git
synced 2026-06-27 16:43:27 +08:00
d2be4d6bf948d839b4be178c4810669ea78ce595
tweakcc-minimal
Minimal system prompts for Claude Code.
Principle: System prompts provide tool access and safety rails. CLAUDE.md/AGENTS.md provide workflow and conventions. Inspired by Pi's context engineering.
23 files changed, -47k chars (~10% of total), targeting the verbose files that override CLAUDE.md. Some tools were converted to stubs and moved to skills
Quick start
# 1. Clone into ~/.tweakcc
git clone https://github.com/wassname/tweakcc-minimal ~/.tweakcc
# 2. Backup, patch in place, save patched copy
VERSION=$(claude --version | head -1 | cut -d' ' -f1)
BINARY=~/.local/share/claude/versions/$VERSION
cp "$BINARY" ~/.tweakcc/native-binary.backup # unpatched backup
npx tweakcc --apply # patches $BINARY in place
cp "$BINARY" ~/.local/share/claude/versions/${VERSION}-min # save as -min
cp ~/.tweakcc/native-binary.backup "$BINARY" # restore stock binary
# 3. Create symlinks so both versions coexist
ln -sf ~/.local/share/claude/versions/${VERSION}-min ~/.local/bin/claude-mn # patched
# claude symlink already points to $VERSION (stock, now restored)
# 4.Install skills (optional, some tools converted to stub+skills)
mkdir -p ~/.claude/skills
ln -s $PWD/skills/* ~/.claude/skills
Now claude = stock, claude-mn = minimal prompts.
Re-apply after edits
Edit .md files in system-prompts/, then:
VERSION=$(claude --version | head -1 | cut -d' ' -f1)
cp ~/.tweakcc/native-binary.backup ~/.local/share/claude/versions/${VERSION}-min
npx tweakcc --apply
Disable auto-updates
CC auto-updates overwrite patched binaries:
// ~/.claude/settings.json
{ "autoUpdates": false }
Or via env in ~/.claude/settings.json:
{ "env": { "DISABLE_AUTOUPDATER": "1" } }
Key files to edit
| File | Controls |
|---|---|
system-reminder-plan-mode-is-active-5-phase.md |
Plan mode workflow (was overriding CLAUDE.md) |
system-reminder-plan-mode-is-active-iterative.md |
Iterative plan mode variant |
system-prompt-main-system-prompt.md |
Role definition, ~10 lines |
system-prompt-doing-tasks.md |
Task execution rules + tool hints |
system-prompt-tone-and-style.md |
Output style |
system-prompt-tool-usage-policy.md |
Parallel calls, tool preferences |
system-prompt-hooks-configuration.md |
Hook event definitions (don't drop events) |
~200 files untouched (already 6-8 lines, tool descriptions, agent/skill prompts loaded on-demand).
What changed
| File | Before | After | Notes |
|---|---|---|---|
| plan-mode-5-phase | 90 | 20 | Defers to CLAUDE.md for workflow |
| plan-mode-iterative | 61 | 18 | Same |
| main-system-prompt | 17 | 10 | Pi-style minimal |
| doing-tasks | 18 | 7 | "Read first, follow CLAUDE.md" |
| learning-mode | 80 | 11 | Kept core, cut examples |
| insights-* (5 files) | 170 | 45 | Kept JSON schema, cut examples |
| hooks-configuration | 163 | 33 | Kept structure + all events, cut examples |
| mcp-cli | 124 | 25 | Kept commands, cut 6x repeated examples |
Links
Description
Languages
Markdown
100%