Skip to content
Grafica Group logo Grafica Blog Grafica Blog

Case studies and notes from Grafica's work

Grafica Group logo Grafica Blog Grafica Blog

Case studies and notes from Grafica's work

  • Services
  • Work
  • Approach
  • About
  • Blog
  • Contact
  • Services
  • Work
  • Approach
  • About
  • Blog
  • Contact
Close

Search

Let's talk
Grafica Group logo Grafica Blog Grafica Blog

Case studies and notes from Grafica's work

Grafica Group logo Grafica Blog Grafica Blog

Case studies and notes from Grafica's work

  • Services
  • Work
  • Approach
  • About
  • Blog
  • Contact
  • Services
  • Work
  • Approach
  • About
  • Blog
  • Contact
Close

Search

Let's talk
Home/Company/A brain on GitHub: the folder that makes an AI work the way I do
Company

A brain on GitHub: the folder that makes an AI work the way I do

By Luis Gallego
October 21, 2026 3 Min Read

Image generated with AI. Art direction: Grafica.

An AI chat knows only what it is given. Mine start from more, because before they start they read a folder. It is a private repository on GitHub, and I think of it as a brain: the written version of how I work, kept where every AI session can read it. This post is about its shape, and how it learns. What is in it stays private.

The folders

The first entry in its history is dated 7 August 2026. By 19 October it held 1,340 changes, and each folder answers one question an assistant would otherwise ask me.

  • Standards: how is this done here? Eighteen files. How a change is classed and rehearsed, how a session closes, what a handoff sheet carries.
  • Records: what was decided, and what is still open? Twenty-nine files, one per project or subject. Each decision is dated, with the reason and the options that were ruled out.
  • Plans: what comes next? The work, ranked, with who owns each step.
  • Lessons: what went wrong before? Twenty-six of them, each tied to a dated mistake.
  • Reports: what did each session actually do? Every piece of work ends with a written report that the next step can check.
  • Inbox: what has just come back? Sessions drop their reports here and the manager reads them first.

The chats I work in are numbered by brief. This post was drafted under brief 885.

How it learns

It does not learn the way people imagine. Nothing trains a model. It learns because a correction gets written down the same day.

An example. On 9 October I said that featured images should not contain text. That sentence is now a line in the design rules the sessions read, and a script on the repository checks a post card for words in its picture. The next session does not need me to say it again. It reads it, and a check can fail on it.

The same goes for what I reserve to myself. The acts that stay with a person are written down, so a session knows where to stop because the line is on file, not because it remembers being told. Our post How we use AI at Grafica, and the four things it is not allowed to do sets out the four things AI is not allowed to do here.

What «the way I do» means in practice

Not my voice. My judgment, where it can be written: what I check before a page goes to a client, what I refuse to put in a proposal, which numbers I want before I believe a result. When a session meets something the files do not cover, it is supposed to say so, and the answer goes into the files.

Where it falls short

It only knows what has been written. A correction I give in passing and nobody files is lost the next morning.

Files grow. A record that only ever gets longer becomes hard to read, so part of the work is condensing it.

A rule written too broadly misfires. When that happens the rule is narrowed, and the reason goes on file.

If you want one

Start with four files, not a system:

  1. The instructions you have typed more than once.
  2. The decisions you have made, each with a date and a reason.
  3. Your mistakes, each with the rule it taught you.
  4. A short report template every piece of work ends with.

Then give your AI those files to read before it starts. My earlier post, I stopped writing prompts. I brief a project manager., is about the manager that reads them. If you want to see how this would look for your team, talk to us.

How likely are you to recommend this article to a colleague?
0 · Not at all likely10 · Extremely likely

Gráfica built this survey as a WordPress plugin, and builds plugins like it for clients. Tell us what your site needs

Author

Luis Gallego

Published by Grafica, a design, branding, web development and marketing consultancy with global reach. Since 2012.

Follow Me
Other Articles
Previous

142 impressions, 0 clicks: an honest baseline for a company blog

Next

How we maintain WordPress sites on Kinsta: the routine, in order

No Comment! Be the first one.

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

Luis Gallego

Luis Gallego

Hi, I’m Luis. I founded Grafica in 2012 and I have designed and built websites ever since: hundreds of them.

I sign every post here. They come from the work we do for clients.

Book a call

Recent Posts

  • A backup that expires is a deadline: ours reads 4 November
    by Luis Gallego
    October 25, 2026
  • A man in glasses looking at a wall of glowing blue data screens
    How to scale your agency in 2026? Grafica’s guide to White Label Partnerships
    by Luis Gallego
    December 31, 2025
  • A smiling woman leaning back, hands behind her head, at her laptop
    The Invisible Powerhouse. How agencies scale with less risk.
    by Luis Gallego
    March 31, 2026
  • A hand reaching toward a glowing shopping-cart icon above a laptop
    “The problem wasn’t the images”, A WooCommerce Website Migration Story.
    by Luis Gallego
    July 30, 2026

Search

What we build with

The tools behind our work.

Design

  • Figma
  • Adobe Creative Cloud

Build

  • WordPress
  • WooCommerce
  • ACF
  • Elementor
  • Avada
  • Blogsy
  • Newspack
  • HTML
  • CSS
  • JavaScript
  • PHP
  • SQL
  • Python
  • GitHub
  • Apify
  • BrowserStack

Hosting

  • Kinsta
  • Cloudflare
  • Google Cloud
  • Hetzner
  • AWS

Security and monitoring

  • 1Password
  • Splunk
  • Chronicle
  • HetrixTools
  • Shodan
  • Tailscale

Marketing and ads

  • HubSpot
  • Google AdSense
  • Google Ad Manager
  • Google Tag Manager
  • Google Analytics
  • Search Console
  • Yoast SEO
  • Ahrefs

AI

  • Claude
  • Gemini
  • ChatGPT
  • Antigravity
  • DeepSeek

Work

  • Asana
  • Trello
  • Zoho
  • Clockify
  • Google Workspace
  • Slack

Each mark is its maker’s own and belongs to its maker. HTML5 logo by W3C, CC BY 3.0. PHP logo by Colin Viebrock, CC BY-SA 4.0. Hetzner logo: source Hetzner Online GmbH.

Kinsta Select Partner: our listing in Kinsta’s agency directory

A design, branding, web development and marketing consultancy with global reach.

Design meets your vision.

Explore
  • Home
  • Services
  • Work
  • Approach
  • About
  • For agencies
  • Blog
  • Contact
Showcase
  • Case studies
  • Migrations
  • Brands
  • Demos
  • AI X-Ray
Connect
  • Kinsta Select Partner
  • info@grafica.group
  • +504 9960 1911
  • LinkedIn
  • Instagram
  • Facebook
© 2026 Grafica Group. All rights reserved. Privacy · grafica.group