Last active
March 12, 2026 15:39
-
-
Save LaurieScheepers/a7b9f839bd10377675d7089d50daad27 to your computer and use it in GitHub Desktop.
GRIP Evaluation Guide - AI Craftspeople Guild
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <!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 — 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> — 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 — 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" — 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 — 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