matthalltech/developing-with-claude
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

fix: clean Mermaid, verified links, remove license, add bootstrap prompts

Browse source
This commit is contained in:
matthalltech 2026-04-01 12:53:54 +00:00
parent 321a023c90
commit e0ec29ecc1
1 changed files with 19 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
README.md
View file

@ -2,7 +2,6 @@
> Run AI coding agents safely on your own machine — where the **Git repository is the memory**, not the chat history. > Run AI coding agents safely on your own machine — where the **Git repository is the memory**, not the chat history.
![License](https://img.shields.io/badge/license-CC%20BY%204.0-lightgrey)
![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue) ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue)
![Status](https://img.shields.io/badge/status-active-brightgreen) ![Status](https://img.shields.io/badge/status-active-brightgreen)
@ -13,27 +12,27 @@
```mermaid ```mermaid
flowchart TB flowchart TB
subgraph host["💻 Your Machine"] subgraph host["💻 Your Machine"]
secrets["🔑 Secrets & Keys\nnever enter the workspace"] secrets["🔑 Secrets and Keys"]
folders["📁 Workspace Folders\nbind-mounted, always persist"] folders["📁 Workspace Folders"]
end end
subgraph container["🐳 Bounded Container — Agents Work Here"] subgraph container["🐳 Bounded Container — Agents Work Here"]
direction LR direction LR
claude["Claude\nCode"] claude["Claude Code"]
codex["Codex\nCLI"] codex["Codex CLI"]
gemini["Gemini\nCLI"] gemini["Gemini CLI"]
end end
subgraph repo["📚 Git Repository — The Persistent Memory"] subgraph repo["📚 Git Repository — The Persistent Memory"]
direction LR direction LR
rules["Rules &\nBoundaries"] rules["Rules"]
state["System\nState"] state["State Docs"]
tools["Scripts\n& Tools"] tools["Scripts"]
end end
folders -->|mounts into| container folders -->|mounts into| container
container <-->|"reads before acting\nwrites when done"| repo container <-->|reads before acting / writes when done| repo
secrets -.->|stays here,\nnever shared| host secrets -.->|stays on host — never enters container| host
``` ```
The container is bounded and disposable. The repository is permanent. Agents read the repo before every session — not the chat history — so context survives restarts, rebuilds, and parallel sessions. The container is bounded and disposable. The repository is permanent. Agents read the repo before every session — not the chat history — so context survives restarts, rebuilds, and parallel sessions.
@ -42,7 +41,7 @@ The container is bounded and disposable. The repository is permanent. Agents rea
## Why this exists ## Why this exists
Most AI-assisted development setups have the same failure mode: context lives in chat history. The session ends, the context is gone. The next session starts blind. Most AI-assisted development setups share the same failure mode: context lives in chat history. The session ends, the context is gone. The next session starts blind.
This guide describes a different model: This guide describes a different model:
@ -81,13 +80,13 @@ Works on a laptop with no GPU, no VPN, no server. Grows as far as you want to ta
```mermaid ```mermaid
graph LR graph LR
A["💻 Laptop\nDocker + Claude Code\n―――――――\nDay 1"] A["💻 Laptop\nDocker + Claude Code"]
B["☁️ VPS\nForgejo · WireGuard\nPrometheus · Loki\n―――――――\nWhen needed"] B["☁️ VPS\nGit hosting + VPN\n+ Monitoring"]
C["🏠 Home Server\nLocal AI · Ollama\nOpen WebUI\n―――――――\nWhen justified"] C["🏠 Home Server\nLocal AI\n+ Ollama"]
D["📱 Mobile\nRemote operator\naccess\n―――――――\nWhen ready"] D["📱 Mobile\nRemote operator\naccess"]
A -->|stable baseline| B A -->|stable baseline| B
B -->|stable infra| C B -->|stable infrastructure| C
C -->|stable local AI| D C -->|stable local AI| D
``` ```
@ -117,9 +116,3 @@ Laptop first. Server when you need one. Local AI when the hardware justifies it.
## Getting started ## Getting started
→ **[Read GETTING-STARTED.md](./GETTING-STARTED.md)** → **[Read GETTING-STARTED.md](./GETTING-STARTED.md)**
---
## License
[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — use it, adapt it, share it with attribution.