ORGANIZED CODEBASE

A lightweight boilerplate and scaffolding system for Claude Code projects.

Implements the Boris methodology — verification-first development from Claude Code's creator.

npx create-organized-codebase my-project

Works on Mac, Windows, and Linux.

"Finally, a template that actually understands how Claude Code works."

"The Boris methodology commands alone are worth it. /verify changed how I ship code."

"Applied it to 3 existing projects in under 5 minutes each."

Why This Exists · How It Works · Commands · Plugin Marketplace

---

Why This Exists

Most project templates are designed for humans. This one is designed for Claude.

When you give Claude Code a messy codebase with no structure, you get inconsistent results. Claude doesn't know where to put things. It doesn't know your conventions. It makes stuff up.

Organized Codebase fixes that. It gives your project a predictable structure that Claude understands:

• Where planning docs live
• Where architecture decisions go
• How to verify work before committing
• What permissions are safe to auto-approve

The template implements the Boris methodology — a verification-first workflow designed by Claude Code's creator. Every commit gets verified. Every PR gets reviewed. No more "it works on my machine."

— Organized AI

---

Who This Is For

Developers who use Claude Code and want:

• Consistent project structure across all their work
• Built-in verification commands (/verify, /commit, /review)
• A sensible permissions system (allow/ask/deny)
• Planning docs that actually get used

Not for you if you like reinventing folder structures for every project.

---

Getting Started

New Project

npx create-organized-codebase my-project
cd my-project

Done. You have:

• .claude/ directory with commands and agents
• PLANNING/ for implementation phases
• AGENT-HANDOFF/ for context transfer
• Pre-configured permissions
• Boris methodology ready to go

Existing Project

Use the organized-codebase-applicator — our flagship skill:

# Install Just (one-time)
brew install just          # macOS
# cargo install just       # Linux
# winget install casey.just  # Windows

# Get the justfile
curl -o justfile https://raw.githubusercontent.com/Organized-AI/organized-codebase/main/templates/justfile

# Apply everything
just apply-organized

Or apply only what you need:

just add-claude    # Just .claude/ (commands, agents, permissions)
just add-planning  # Just PLANNING/ (phase templates, decisions)
just add-handoff   # Just AGENT-HANDOFF/ (context transfer docs)

Via Claude Code

Just ask:

• "Apply Organized Codebase template"
• "Set up verification infrastructure"
• "Add Boris methodology commands"

---

How It Works

The Structure

your-project/
├── .claude/                 # Claude Code configuration
│   ├── commands/            # Slash commands
│   │   ├── verify.md        # /verify — run all checks
│   │   ├── commit.md        # /commit — smart commits
│   │   ├── review.md        # /review — self-review before PR
│   │   └── status.md        # /status — project health
│   ├── agents/              # Verification agents
│   │   ├── verify-build.md
│   │   └── verify-architecture.md
│   └── settings.json        # Permissions (allow/ask/deny)
│
├── PLANNING/                # Planning documentation
│   ├── implementation-phases/
│   │   └── PHASE-0-PROMPT.md
│   └── decisions/           # Architecture Decision Records
│
├── AGENT-HANDOFF/           # Context transfer
│   ├── HANDOFF.md
│   └── CONTEXT-WINDOW.md
│
├── justfile                 # Scaffolding recipes
└── CLAUDE.md                # Project overview for Claude

Claude reads CLAUDE.md first. It knows the structure. It follows the conventions.

Boris Methodology

"Always give Claude a way to verify its work."

That's it. That's the whole philosophy. Every task should have a verification step.

The workflow:

/status → See where you are
    ↓
Plan Mode → Think before coding
    ↓
Build → One feature at a time
    ↓
/verify → Run all checks
    ↓
/commit → Commit with verification
    ↓
/review → Self-review before PR

The commands enforce the discipline. You can't forget to verify because the workflow includes it.

Permissions

The .claude/settings.json uses three tiers:

Tier	What it means	Examples
allow	Auto-approve, no prompt	git status, npm run *, just *
ask	Prompt before running	git push, npm install
deny	Never allow	git push --force, rm -rf /

You stop approving git status 50 times per session. Claude just works.

---

Commands

Core Workflow

Command	What it does
/status	Project health check — git state, recent changes, what's next
/verify	Run lint, typecheck, tests, build — all your checks
/commit	Smart commit with pre-verification
/review	Self-review before creating PR

Verification Agents

Agent	What it does
verify-build	Validates build works from clean state
verify-architecture	Checks code follows project patterns

Just Recipes

Recipe	What it creates
just apply-organized	Full template structure
just add-claude	.claude/ directory only
just add-planning	PLANNING/ docs only
just add-handoff	AGENT-HANDOFF/ only
just verify	Run verification suite
just project-status	Show git status and structure

---

Plugin Marketplace

Want more commands, agents, and skills?

👉 github.com/Organized-AI/plugin-marketplace

# Add the marketplace
/plugin marketplace add Organized-AI/plugin-marketplace

# Install plugins
/plugin install boris@organized-ai-marketplace
/plugin install phased-planning@organized-ai-marketplace

Featured Plugins

Plugin	What it does
boris	Full Boris methodology orchestration
phased-planning	Generate structured implementation plans
long-runner	Multi-session development orchestration
git-worktree-master	Parallel branch workflows

---

Configuration

Selective Application

Don't want everything? Pick what you need:

just add-claude    # Commands + agents + permissions
just add-planning  # Phase templates + ADRs
just add-handoff   # Context transfer docs
just add-ralphy    # Ralphy workflow config

Customizing Permissions

Edit .claude/settings.json:

{
  "permissions": {
    "allow": [
      "git status",
      "git diff",
      "npm run *",
      "just *"
    ],
    "ask": [
      "git push",
      "npm install"
    ],
    "deny": [
      "git push --force",
      "rm -rf /"
    ]
  }
}

Add your own patterns. Remove what you don't need.

---

Troubleshooting

Commands not found?

• Restart Claude Code to reload slash commands
• Check files exist in .claude/commands/

Just not installed?

brew install just        # macOS
cargo install just       # Linux/cross-platform
winget install casey.just  # Windows

Want to update?

npx create-organized-codebase@latest my-project

---

Resources

• Boris Methodology Video — Original source from Claude Code's creator
• Plugin Marketplace — More commands, agents, skills
• Organized AI Events — Live sessions and workshops
• Community — Join the conversation

---

License

MIT License. See LICENSE for details.

---

Claude Code is powerful. Structure makes it reliable.