Skip to content

Instantly share code, notes, and snippets.

@LaurieScheepers
Last active March 12, 2026 15:39
Show Gist options
  • Select an option

  • Save LaurieScheepers/a7b9f839bd10377675d7089d50daad27 to your computer and use it in GitHub Desktop.

Select an option

Save LaurieScheepers/a7b9f839bd10377675d7089d50daad27 to your computer and use it in GitHub Desktop.
GRIP Evaluation Guide - AI Craftspeople Guild
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>GRIP Evaluation | AI Craftspeople Guild</title>
<style>
:root {
--bg: #0a0a0a;
--surface: #141414;
--border: #2a2a2a;
--text: #e0e0e0;
--muted: #888;
--accent: #4fc3f7;
--green: #66bb6a;
--font: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;
}
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: var(--font);
background: var(--bg);
color: var(--text);
line-height: 1.6;
max-width: 800px;
margin: 0 auto;
padding: 3rem 2rem;
}
h1 {
font-size: 1.8rem;
font-weight: 700;
color: var(--accent);
margin-bottom: 0.3rem;
}
.tagline {
color: var(--muted);
font-size: 0.9rem;
margin-bottom: 2.5rem;
}
h2 {
font-size: 1.1rem;
font-weight: 600;
color: var(--text);
margin: 2rem 0 1rem 0;
text-transform: uppercase;
letter-spacing: 0.05em;
}
.card {
background: var(--surface);
border: 1px solid var(--border);
border-radius: 8px;
padding: 1.5rem;
margin-bottom: 1.5rem;
}
.card-accent {
border-color: var(--accent);
}
.step-num {
display: inline-block;
width: 28px;
height: 28px;
line-height: 28px;
text-align: center;
background: var(--accent);
color: var(--bg);
font-weight: 700;
border-radius: 50%;
margin-right: 0.8rem;
font-size: 0.85rem;
}
.step-title {
font-size: 1rem;
font-weight: 600;
margin-bottom: 0.5rem;
}
code {
background: var(--bg);
padding: 0.2rem 0.5rem;
border-radius: 4px;
font-size: 0.85rem;
color: var(--green);
}
pre {
background: var(--bg);
padding: 1rem;
border-radius: 6px;
overflow-x: auto;
font-size: 0.85rem;
color: var(--green);
margin: 0.8rem 0;
line-height: 1.7;
}
.isolation-grid {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 1rem;
margin-top: 1rem;
}
@media (max-width: 600px) { .isolation-grid { grid-template-columns: 1fr; } }
.iso-card {
background: var(--bg);
border: 1px solid var(--border);
border-radius: 8px;
padding: 1.2rem;
}
.iso-card h3 {
font-size: 0.9rem;
color: var(--accent);
margin-bottom: 0.5rem;
}
.iso-card p {
font-size: 0.8rem;
color: var(--muted);
}
.what-grid {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 0.8rem;
margin-top: 1rem;
}
@media (max-width: 600px) { .what-grid { grid-template-columns: 1fr; } }
.what-item {
background: var(--bg);
border-radius: 6px;
padding: 0.8rem;
font-size: 0.8rem;
}
.what-item strong { color: var(--accent); }
.stats-row {
display: flex;
gap: 1.5rem;
flex-wrap: wrap;
margin: 1rem 0;
}
.stat { text-align: center; }
.stat-val {
font-size: 1.4rem;
font-weight: 700;
color: var(--accent);
line-height: 1;
}
.stat-lbl {
font-size: 0.65rem;
color: var(--muted);
text-transform: uppercase;
letter-spacing: 0.05em;
}
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }
.footer {
text-align: center;
color: var(--muted);
font-size: 0.75rem;
margin-top: 3rem;
padding-top: 1rem;
border-top: 1px solid var(--border);
}
.prereq {
font-size: 0.85rem;
color: var(--muted);
}
.prereq li { margin-bottom: 0.3rem; }
</style>
</head>
<body>
<h1>GRIP</h1>
<p class="tagline">Guarded Response Interception Protocol &mdash; Recursive Self-Improvement Engine for Claude Code</p>
<div class="card card-accent">
<p style="font-size: 0.9rem;">
GRIP transforms Claude Code into a <strong>persistent AI collaborator</strong> with session memory,
mechanical safety gates, recursive self-improvement, and 161 pre-built skills.
</p>
<p style="font-size: 0.85rem; color: var(--muted); margin-top: 0.5rem;">
It is not a framework you import. It is infrastructure that installs into <code>~/.claude/</code>
and makes every Claude Code session smarter, safer, and more efficient.
</p>
<div class="stats-row">
<div class="stat"><div class="stat-val">161</div><div class="stat-lbl">Skills</div></div>
<div class="stat"><div class="stat-val">22</div><div class="stat-lbl">Agents</div></div>
<div class="stat"><div class="stat-val">30</div><div class="stat-lbl">Modes</div></div>
<div class="stat"><div class="stat-val">1,764</div><div class="stat-lbl">Commits</div></div>
<div class="stat"><div class="stat-val">212</div><div class="stat-lbl">Genes</div></div>
</div>
</div>
<h2>What You Get</h2>
<div class="what-grid">
<div class="what-item">
<strong>Session Resurrection</strong><br>
Memory across sessions via serialisation. No more "starting from scratch".
</div>
<div class="what-item">
<strong>Safety Gates</strong><br>
Mechanical enforcement (not guidelines). PreToolUse hooks that cannot be overridden.
</div>
<div class="what-item">
<strong>Converge Kernel</strong><br>
<code>converge(state, criterion, improve)</code> &mdash; 3 parameters, fractal depth.
</div>
<div class="what-item">
<strong>Genome Evolution</strong><br>
Skills compete, mutate, breed. Fitness selection drives improvement.
</div>
<div class="what-item">
<strong>Efficiency Protocols</strong><br>
30-35% context budget savings. File read caching, dependency blocking.
</div>
<div class="what-item">
<strong>RSI Engine</strong><br>
Recursive self-improvement with Fibonacci wave protocol and delight tracking.
</div>
</div>
<h2>Request Access</h2>
<div class="card card-accent">
<p style="font-size: 0.85rem;">
GRIP is currently in <strong>private evaluation</strong>. To get access:
</p>
<ol style="font-size: 0.85rem; margin: 0.8rem 0 0 1.2rem; color: var(--muted);">
<li>Send your <strong>GitHub username</strong> to Laurie (Guild signatory #12)</li>
<li>You will be added as a collaborator on <code>CodeTonight-SA/GRIP</code></li>
<li>Accept the GitHub invitation and proceed with Step 1 below</li>
</ol>
<p style="font-size: 0.8rem; color: var(--muted); margin-top: 0.5rem;">
Turnaround: same day. Access grants read + clone rights.
</p>
</div>
<h2>Prerequisites</h2>
<ul class="prereq">
<li><a href="https://docs.anthropic.com/en/docs/claude-code/overview">Claude Code</a> installed and authenticated (<code>claude</code> in your terminal)</li>
<li>Git 2.20+ with <code>git-crypt</code> (optional, for encrypted state)</li>
<li>macOS, Linux, or Windows with Git Bash</li>
</ul>
<h2>Get Started (3 Steps)</h2>
<div class="card">
<div class="step-title"><span class="step-num">1</span>Clone GRIP</div>
<p style="font-size: 0.85rem; margin-bottom: 0.5rem;">Choose your isolation level:</p>
<div class="isolation-grid">
<div class="iso-card">
<h3>Personal (Default)</h3>
<p>GRIP installs to your <code>~/.claude/</code>. Your personal Claude Code becomes GRIP-powered.</p>
<pre>git clone https://github.com/CodeTonight-SA/GRIP.git ~/.claude
cd ~/.claude
./scripts/grip-setup.sh</pre>
</div>
<div class="iso-card">
<h3>Organisation</h3>
<p>Fork GRIP into your org. Team members clone from the fork. Shared genome, independent sessions.</p>
<pre># Fork CodeTonight-SA/GRIP on GitHub first
git clone https://github.com/YOUR-ORG/GRIP.git ~/.claude
cd ~/.claude
./scripts/grip-setup.sh</pre>
</div>
</div>
</div>
<div class="card">
<div class="step-title"><span class="step-num">2</span>Activate</div>
<p style="font-size: 0.85rem;">Open Claude Code in any project and run:</p>
<pre>claude
# Then inside Claude Code:
/activate-grip</pre>
<p style="font-size: 0.8rem; color: var(--muted);">
The wizard configures your identity, safety gates, and initial mode.
Takes about 2 minutes.
</p>
</div>
<div class="card">
<div class="step-title"><span class="step-num">3</span>Use</div>
<p style="font-size: 0.85rem;">GRIP is now active in every Claude Code session. Try:</p>
<pre>/recall # Recall your session state
/mode code # Switch to code mode
/converge # Start a convergence loop
/rsi # Launch recursive self-improvement
/create-pr # Automated PR workflow</pre>
</div>
<h2>How Isolation Works</h2>
<div class="card">
<p style="font-size: 0.85rem;">
<strong>Personal isolation</strong>: Your <code>~/.claude/</code> IS the GRIP repo. Sessions store state in
<code>state/</code>, learning in <code>learning/</code>, and genome in <code>cache/</code>. Everything stays local.
</p>
<p style="font-size: 0.85rem; margin-top: 0.8rem;">
<strong>Organisation isolation</strong>: Fork the repo. Team members clone from the fork.
The genome (<code>cache/genome.json</code>) is shared via git, so team learning compounds.
Individual session state stays per-user (gitignored). Encrypted state uses <code>git-crypt</code>
so credentials never leave the machine.
</p>
<p style="font-size: 0.85rem; margin-top: 0.8rem;">
<strong>Evaluation mode</strong>: Just clone and run. No API keys needed beyond your existing Claude Code auth.
GRIP adds zero external dependencies to Claude Code. It uses only standard Python and Bash.
</p>
</div>
<h2>Key Concepts for Evaluators</h2>
<div class="card">
<p style="font-size: 0.85rem;"><strong>Converge Kernel</strong>: <code>converge(state, criterion, improve)</code> is GRIP's core algorithm.
Three parameters, infinite fractal depth. The same pattern applies at every scale &mdash; from fixing a bug
to evolving the entire genome. The system recursively selects for the pattern that produces recursive selection.</p>
<p style="font-size: 0.85rem; margin-top: 0.8rem;"><strong>Safety Gates</strong>: Mechanical enforcement through PreToolUse hooks.
Not "please don't force push" &mdash; the hook physically blocks the command. Trust through mechanisms that constrain,
not values that suggest. 6 gates: context, confidence, secrets, force-push, dependency folders, file read cache.</p>
<p style="font-size: 0.85rem; margin-top: 0.8rem;"><strong>RSI</strong>: Recursive Self-Improvement via the Fibonacci wave protocol.
Each wave batch-sizes work, delegates between models, and breathes (checkpoint + delight measurement).
The genome tracks which skills/patterns work. Fitness selection is real, not metaphorical &mdash; low-fitness genes
get pruned; high-fitness genes dominate future sessions.</p>
</div>
<h2>Resources</h2>
<div class="card">
<p style="font-size: 0.85rem;">
<a href="https://github.com/CodeTonight-SA/GRIP">GitHub Repository</a> |
<a href="https://aicraftspeopleguild.github.io/index.html">AI Craftspeople Guild</a>
</p>
<p style="font-size: 0.8rem; color: var(--muted); margin-top: 0.5rem;">
Questions? Reach out to Laurie (Guild signatory #12) or open an issue on the repo.
</p>
</div>
<div class="footer">
GRIP v6.0.0 | CodeTonight SA | "Trust is built through mechanisms that constrain, not values that suggest."
</div>
</body>
</html>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment