git404hub

what is codesplain fr?

opitaru-sys/codesplain — explained in plain English

Analysis updated 2026-05-18

4Audience · pm founderLicenseSetup · easy

tl;dr

A Claude Code skill that keeps a plain-language file explaining what your AI-built project does, so non-coders can check the AI's work.

vibe map

mindmap
  root((repo))
    What it does
      Plain language project map
      Decision log
      Glossary of terms
    Tech stack
      Claude Code skill
      Markdown file
    Use cases
      Verify AI claims
      Track decisions
      Learn terminology
    Audience
      Non-coders
      Founders
      Vibe coders
    Setup
      Copy to skills folder
      Run slash command
      Auto updates as you build

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Verify an AI's explanation of a bug fix by checking it against a plain language map of the project.

VIBE 2

Keep a running decision log of every meaningful choice made while building software through AI.

VIBE 3

Learn what terms like dependency or state mean by seeing them defined for your own project.

VIBE 4

Get warned before an AI-driven change costs money or risks losing existing data.

what's the stack?

Claude CodeMarkdown

how it stacks up fr

opitaru-sys/codesplain0labs-in/vision-link1038lab/agnes-ai
Stars444
LanguageTypeScriptPython
Setup difficultyeasymoderateeasy
Complexity3/52/5
Audiencepm founderdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Claude Code to run the skill, no other dependencies.

in plain english

Codesplain is a Claude Code skill built for people who direct an AI to build software for them but cannot read the code it produces. It solves a specific trust problem: if you cannot read code, you have no way to check whether the AI actually fixed a bug, quietly added a new dependency, or changed how your data is stored. Codesplain gives you a second file you can actually read and check against what the AI tells you. That file is called CODESPLAIN.md and lives in your project. It has three parts. A map section describes five to ten recognizable areas of the project in plain language, such as what a section does, why it exists, and which files it touches, without ever listing every file one by one. A decision log records every meaningful choice made while building, written as three to five plain sentences covering what was decided, why, what the alternative was, and what might cause problems later. A glossary defines every technical term used, once each. You install it by copying the skill folder into your Claude Code skills directory. Running a command starts a new map on an existing project by reading the code, or lays down an empty starting point on a brand new one. You can also ask plain language questions about the project, such as why something is slow, and get an answer grounded in the map. Once the file exists, the skill keeps it updated automatically as you keep building. Small additions like a new library get logged with a short note in chat, while anything that costs money, locks you into a choice, or risks losing data stops and asks for your approval first. Minor changes like typo fixes or renames are never logged, so the file stays short enough to actually read. It is aimed specifically at people building real software through AI without a coding background, and is released under the MIT license.

prompts (copy fr)

prompt 1
Install codesplain in my Claude Code skills directory and run /codesplain to start a map of my project.
prompt 2
Ask codesplain why saving is slow in my app and explain the answer in plain language.
prompt 3
Show me the decision log entry codesplain wrote for the last change to my project.
prompt 4
Add the codesplain activation snippet to my global CLAUDE.md so it turns on automatically.

Frequently asked questions

what is codesplain fr?

A Claude Code skill that keeps a plain-language file explaining what your AI-built project does, so non-coders can check the AI's work.

How hard is codesplain to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codesplain for?

Mainly pm founder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.