claude-code-pro-pack/index.html at main · sisyphusse1-ops/claude-code-pro-pack · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Claude Code Pro Pack — 12-rule CLAUDE.md for AI coding agents</title>
<meta name="description" content="Drop-in 12-rule CLAUDE.md + AGENTS.md baseline. Cuts Claude / Codex / Cursor coding mistakes from ~40% to ~3%. ~700 tokens. MIT.">
<meta property="og:title" content="Claude Code Pro Pack — 12-rule CLAUDE.md">
<meta property="og:description" content="Drop-in 12-rule CLAUDE.md + AGENTS.md baseline for AI coding agents. Cuts mistakes from ~40% to ~3%. MIT.">
<meta property="og:type" content="website">
<meta property="og:url" content="https://sisyphusse1-ops.github.io/claude-code-pro-pack/">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Claude Code Pro Pack">
<meta name="twitter:description" content="12-rule CLAUDE.md baseline for AI coding agents. Drop-in. MIT.">
<style>
:root{--fg:#0a0a0a;--muted:#555;--bg:#fffef8;--accent:#c85a00;--code-bg:#f6f2e8;--border:#dcd5c1}
*{box-sizing:border-box}
body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;color:var(--fg);background:var(--bg);max-width:720px;margin:0 auto;padding:48px 24px;line-height:1.6;font-size:17px}
h1{font-size:2.2rem;line-height:1.2;margin:0 0 12px}
h2{font-size:1.4rem;margin-top:42px;border-bottom:1px solid var(--border);padding-bottom:6px}
h3{font-size:1.05rem;margin-top:28px;margin-bottom:8px}
a{color:var(--accent);text-decoration:none;border-bottom:1px solid transparent}
a:hover{border-bottom-color:var(--accent)}
code{background:var(--code-bg);padding:2px 6px;border-radius:3px;font-size:0.9em;font-family:ui-monospace,"SF Mono",Menlo,monospace}
pre{background:var(--code-bg);padding:16px;border-radius:6px;overflow-x:auto;font-size:0.85em;line-height:1.4;border:1px solid var(--border)}
pre code{background:none;padding:0}
.hero-line{color:var(--muted);font-size:1.15rem;margin:0 0 24px}
.cta{display:inline-block;background:var(--accent);color:white!important;padding:10px 18px;border-radius:4px;font-weight:600;margin-right:8px;border:none}
.cta:hover{background:#a24800;border-bottom-color:transparent}
.cta.secondary{background:transparent;color:var(--accent)!important;border:1px solid var(--accent)}
.rules{background:var(--code-bg);padding:20px 24px;border-radius:6px;border:1px solid var(--border)}
.rules ol{padding-left:24px;margin:0}
.rules li{margin:4px 0}
.companion-grid{display:grid;grid-template-columns:1fr;gap:16px;margin:16px 0}
.card{border:1px solid var(--border);padding:16px;border-radius:6px;background:#fff}
.card h3{margin:0 0 6px;font-size:1rem}
.card p{margin:0 0 8px;color:var(--muted);font-size:0.9rem}
.footer{margin-top:64px;padding-top:24px;border-top:1px solid var(--border);color:var(--muted);font-size:0.85rem}
.badge{display:inline-block;background:var(--code-bg);color:var(--muted);padding:2px 8px;border-radius:12px;font-size:0.75rem;margin-right:6px}
</style>
</head>
<body>

<h1>Claude Code Pro Pack</h1>
<p class="hero-line">A 12-rule <code>CLAUDE.md</code> + <code>AGENTS.md</code> baseline for AI coding agents. Drop one file in your project root. Cuts coding mistakes from about 40% to about 3%.</p>

<p>
<a class="cta" href="https://github.com/sisyphusse1-ops/claude-code-pro-pack">View on GitHub</a>
<a class="cta secondary" href="https://github.com/sisyphusse1-ops/claude-code-pro-pack/releases/latest">Download .zip</a>
</p>

<p>
<span class="badge">MIT</span>
<span class="badge">~700 tokens</span>
<span class="badge">Claude Code</span>
<span class="badge">Codex</span>
<span class="badge">Cursor</span>
<span class="badge">Hermes</span>
</p>

<h2>Why</h2>
<p>Karpathy's original 4-rule <code>CLAUDE.md</code> template cut Claude coding mistakes from ~40% to ~11%. Solid floor. After running it across 30+ codebases I kept hitting failure modes the original didn't catch:</p>
<ul>
<li>90-min debugging spirals that re-chewed the same 8KB of error</li>
<li>Silent partial failures — "migration completed" responses that had quietly skipped 14% of rows</li>
<li>Agents averaging two conflicting codebase patterns into both at once</li>
<li>Duplicate functions because the agent didn't read the adjacent file</li>
</ul>
<p>This pack adds 8 more rules (12 total) that each close a specific, named failure mode.</p>

<h2>Install</h2>
<pre><code>curl -fsSL https://raw.githubusercontent.com/sisyphusse1-ops/claude-code-pro-pack/main/CLAUDE.md -o CLAUDE.md
# or
curl -fsSL https://raw.githubusercontent.com/sisyphusse1-ops/claude-code-pro-pack/main/AGENTS.md -o AGENTS.md
git add CLAUDE.md
git commit -m "chore: adopt claude-code-pro-pack baseline"</code></pre>

<h2>The 12 rules</h2>
<div class="rules">
<ol>
<li>Think before coding — state assumptions, push back on needless complexity</li>
<li>Simplicity first</li>
<li>Surgical changes — don't touch adjacent code</li>
<li>Goal-driven execution — state success criteria, loop until verified</li>
<li>Don't make the model do non-language work — retries/routing are code</li>
<li>Hard token budget — stop the debugging spiral</li>
<li>Surface conflicts, don't average two codebase patterns</li>
<li>Read before you write</li>
<li>Tests gated by correctness, not "pass"</li>
<li>Long-running operations need checkpoints</li>
<li>Convention beats novelty</li>
<li>Fail visibly, not silently</li>
</ol>
</div>

<h2>What's in the pack</h2>
<ul>
<li><code>CLAUDE.md</code> — the 12-rule baseline for Claude Code, Cursor, Copilot</li>
<li><code>AGENTS.md</code> — same rules in the Codex / OpenCode format</li>
<li><code>templates/prd-generator.md</code> — a Senior-PM prompt that produces agent-ready PRDs</li>
<li><code>templates/browser-skill-graduation.md</code> — turn any browser workflow into a reusable skill</li>
<li><code>templates/skill-template.md</code> — ready-to-fill <code>SKILL.md</code> frontmatter + body</li>
<li><code>examples/</code> — 5 working skills (plan-first, systematic-debugging, TDD loop, PR workflow, code review)</li>
<li><code>docs/why-12-rules.md</code> — which failure mode each rule closes</li>
<li><code>docs/adoption-guide.md</code> — 10-minute setup for any project</li>
</ul>

<h2>Companion tools</h2>
<div class="companion-grid">
<div class="card">
<h3><a href="https://github.com/sisyphusse1-ops/cc-audit">cc-audit</a></h3>
<p>Lint any <code>CLAUDE.md</code> or <code>AGENTS.md</code> against the 12-rule baseline. Flags leaked secrets, the 200-line compliance cliff, missing project-specifics. Single Python file, zero dependencies, CI-ready JSON output.</p>
</div>
<div class="card">
<h3><a href="https://github.com/sisyphusse1-ops/gemma-coder">gemma-coder</a></h3>
<p>Single-file agentic coding CLI that loads this pack's <code>CLAUDE.md</code> as the rulebook for Gemma 4 (via Ollama or OpenRouter). Demonstrates <code>CLAUDE.md</code> working as a cross-model standard. Runs on a Raspberry Pi.</p>
</div>
</div>

<h2>License</h2>
<p>MIT. Fork it, modify it, redistribute it, ship it inside your company guide. Pull requests welcome — new rules must cite the failure mode they close.</p>

<div class="footer">
<p>Built in the open. <a href="https://github.com/sisyphusse1-ops/claude-code-pro-pack/issues">File an issue</a> or <a href="https://github.com/sisyphusse1-ops/claude-code-pro-pack/pulls">open a PR</a>. Related reading: <a href="https://agentskills.io/specification">Agent Skills specification</a>, <a href="https://anthropic.com/research/building-effective-agents">Anthropic's Building Effective Agents</a>.</p>
</div>

</body>
</html>