Claude + Codex · one shared context

Your context in one place that is yours

Claude, Codex, or the next model all work with the same context. When a better AI comes along, just plug it in.

Banner: context layer — your business in one place, readable by any AI
In a nutshell

This is a free kit for keeping your business context (what you do, your voice, your audience, your rules) in a private repository that belongs to you, rather than inside an AI app. Claude and ChatGPT/Codex read and write in the same place, so you avoid diverging copies and dependence on one company. The kit includes a folder structure, one instruction block for both apps, ready-to-use prompts, and a checker that blocks passwords and databases before upload. All you need is a free GitHub account and Claude or ChatGPT.

What it is

Three layers; one belongs to you

AI apps now work in their own cloud. Great for always-on access; a problem when your context gets stuck there.

The steps: three layers, files and data, where to keep them, set up, connect both apps, and test

🤖 Top: the AI

Where the work runs: Claude, Codex, or the next AI. It changes; the rest stays.

🌉 Middle: the bridge

Git, MCP connector, or API. Each app needs its own permission to connect.

🗄️ Bottom: what belongs to you

Your business files in a private repository. Change the AI; keep the source.

Guide · step by step

Build your layer in 6 steps

First clone the kit. Run the commands from inside its folder.

git clone https://github.com/inematds/camada-contexto
cd camada-contexto
Illustration: two islands in the sky, each with a copy of the same folder, drifting apart
1

Understand the problem with two copies

When you upload your context separately to each app, two versions of your business emerge. They drift further apart each week, and whoever holds your context keeps you tied to them.

Illustration: a shelf of notebooks on one side and a live task board on the other
2

Separate files from live data

Files change little: business, voice, audience, decisions, skills. Keep them as markdown in the repository. Live data changes constantly: tasks, clients, records. Put it in a cloud database (such as Supabase), never in a folder of files.

Illustration: a vault, a shared editing desk, and a drawer with a magnifying glass
3

Choose where to keep it

On your own or in a small team: GitHub, free, private, with a history of every change. Non-technical team: Notion, built for people to edit together. Drive: first check that the app connector can edit files, not just read them.

Illustration: a robot carries folders from a laptop into a vault
4

Set up the private repository

Create a private repository on GitHub. Generate its structure with the kit, fill it in, and check it before uploading. If you already have a context folder, use the prompt to have an agent copy everything to the right place.

scripts/iniciar.sh ~/minha-empresa-contexto
python3 scripts/checar_contexto.py ~/minha-empresa-contexto
# OK: 0 block(s) … — passwords, databases, and spreadsheets are blocked
cat prompts/copiar-contexto.md
Illustration: two robots read the same instruction sheet pinned to a board
5

Connect both apps with the same block

Connect GitHub in Claude and ChatGPT/Codex, then paste the same block into each app’s project instructions: the repository is the source of truth, read before acting, write on main, ask before deleting, and never save passwords.

cat instrucoes/bloco-projeto.md
Illustration: notes leave an app box and are filed into folders
6

Move memory out of the app

What automatic memory has learned about you should not stay trapped there. Put rules in contexto/regras.md; process steps in a skill; business facts in the business file.

cat prompts/memoria-para-arquivos.md
The proof

The two-agent test

One creates, the other edits. If both can do it, the bridge works in both directions.

1

Codex creates

Ask Codex to create entregas/teste-ponte.md in the repository.

2

Claude edits

Ask Claude to open the same file and add a line.

3

You check

Does the file have both lines? Then both agents are working with the same context.

cat prompts/teste-dois-agentes.md
Illustration: one robot writes a page, sends it through a vault, and the other edits it
Video

Watch the context layer explained

The full explainer with illustrations and animated screens, plus a short reel to share with someone who needs it.

Full video (16:9)

Reel (9:16)

In the repository

What’s included

modelo/

AGENTS.md, CLAUDE.md, and the contexto/ folder with business, voice, audience, rules, decisions, and skills.

instrucoes/

The single block to paste into Claude and ChatGPT/Codex projects.

prompts/

Copy the context, run the two-agent test, and move memory into files.

scripts/

iniciar.sh creates the structure; checar_contexto.py blocks passwords and databases.