https://github.com/enriquefft/mere
A zero-context, cache-optimized architecture toolkit for AI-native development.
https://github.com/enriquefft/mere
ai-tools claude code-architecture developer-tools golang modular scaffolding
Last synced: about 1 month ago
JSON representation
A zero-context, cache-optimized architecture toolkit for AI-native development.
- Host: GitHub
- URL: https://github.com/enriquefft/mere
- Owner: Enriquefft
- License: mit
- Created: 2026-03-08T07:22:26.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-03-08T09:58:39.000Z (about 1 month ago)
- Last Synced: 2026-03-08T12:32:24.681Z (about 1 month ago)
- Topics: ai-tools, claude, code-architecture, developer-tools, golang, modular, scaffolding
- Language: Go
- Homepage: https://mere.enriquefft.com
- Size: 49.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# Mere
**The minimal, module-first architecture toolkit for Claude Code.**
> Just structure. AI does the rest.
[](https://go.dev/)
[](https://github.com/Enriquefft/Mere/stargazers)
[](LICENSE)
[](https://github.com/Enriquefft/Mere/actions/workflows/test.yml)
---
## Quick Start
Get from zero to your first AI-powered module in 60 seconds:
```bash
# 1. Install (one line)
curl -fsSL https://mere.enriquefft.com/install | bash
# 2. Initialize your project
mere init
# 3. Open Claude Code and create a module
/module
```
**That's it.** Mere scaffolds the architecture, you describe the interface, and AI builds the implementation.
---
## Why Mere?
Traditional AI-assisted development problems:
| Problem | Traditional Approach | Mere Approach |
|----------|-------------------|--------------|
| Context loss | Fresh agents start cold = 3-5x token cost | Single session + cached prefix = 10-20% cost |
| Inconsistent output | Prompts drift over time | Fixed interface contracts lock behavior |
| No boundaries | AI modifies everything | Taste applied at module boundaries only |
| Prompts over code | 15,000-line agent configs | 50-line `.claude/` directory |
**The insight:** Your codebase structure is the most critical factor in AI-assisted development — far outweighing prompt engineering or agent orchestration.
Mere replaces bloated meta-prompting frameworks with a single Go binary that enforces John Ousterhout's "Deep Modules" pattern.
### Architecture Principles
**Structure Over Prompts**
Your codebase, not prompts or agent configs, is the biggest influence on AI output. Mere enforces deep modules: lots of implementation controlled by a simple interface.
**Cache Advantage**
Stay in a single session to exploit Claude Code's prefix caching. Cache reads cost 10% of normal tokens vs cold cache.
**Taste at the Boundaries**
Apply taste at module boundaries by writing `INTERFACE.md` contracts and boundary tests. Implementation inside modules is a "graybox" managed by AI.
---
## Installation
### Recommended (One-Command Install)
```bash
curl -fsSL https://mere.enriquefft.com/install | bash
```
This downloads the standalone binary and places it in `/usr/local/bin`.
### Alternative Install Methods
**From Go:**
```bash
go install github.com/Enriquefft/Mere@latest
```
**From Source:**
```bash
git clone https://github.com/Enriquefft/Mere.git
cd mere
just build && just install
```
**From GitHub Releases:**
Download the latest binary from [releases](https://github.com/Enriquefft/Mere/releases) and add to your PATH.
---
## Usage
```bash
mere init # Initialize .claude/ directory
mere version # Show version
mere --help # Show all commands
```
After `mere init`, use these AI commands in Claude Code:
- **`/module`** - Create or work on a deep module
- **`/status`** - Report project state
The AI automatically detects your project language (Go, Python, TypeScript, Java, Rust, etc.) and adapts file patterns accordingly.
---
## Development
### Build & Test
```bash
just build # Build to ./bin/
just test # Run tests
just dev # Full workflow (clean + deps + build + test)
```
### Nix Development
Uses flakes for reproducible environment:
```bash
direnv reload # Load dev shell
```
### Other Commands
```bash
just help # Show all commands
just fmt # Format code
just lint # Run linter
just deps # Tidy dependencies
```
---
## License
MIT - see [LICENSE](LICENSE) for details.
## Contributing
Contributions welcome! Please review [contributing guidelines](CONTRIBUTING.md) before submitting PRs.