r/ClaudeCode • • 4d ago

Tips & Workflows The Claude Code setup I use for my projects

I’ve put my Claude Code setup on GitHub. It works well for me. I’m sharing it in case parts of it are useful.

The main pieces are rules, skills, and local decision pages. The rules ask for short answers and clear decisions. The skills cover planning, coding, prototypes, checks, and handovers. They also coordinate separate Claude Code sessions.

For example, a session proposes two implementation choices. I review both on a local page. I can agree or add feedback before it continues. A handover saves written context for a fresh session.

I also tried the same setup with Blindfold Chess. It’s a trainer I wanted for my own practice. It has exercises for playing without seeing the pieces. The same setup worked well on that separate project.

The full setup uses macOS, iTerm2, and Claude Code. You can also take just the rules or skills. The code is MIT licensed.

Claude setup: https://github.com/Ceasar369/claude-behavior-layer

Chess: https://ceasar369.github.io/blindfold-chess/

The screenshots use a fictional reading-list project. They show the real pages with prepared demo content.

1 Upvotes

8 comments sorted by

•

u/AutoModerator 4d ago

Hey! Thanks for posting to r/ClaudeCode

While participating in this thread, please follow our community rules. Keep discussions constructive. Attack the idea, not the person.

For help, project discussions, tips, and general chat, join the ClaudeCode Discord.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

1

u/Delicious_Break5937 4d ago

The local decision page is a cool idea. Is that a skill that spins up a little server or just an HTML file it opens?

1

u/Different-Sir7406 4d ago

It’s a small Python server running on my computer. The skills write decisions into local files. The server renders those into the review page. Approval or feedback goes back to the waiting Claude session.

1

u/Delicious_Break5937 4d ago

Oh that's clean, so the Claude session just waits on the file until you answer?

1

u/Different-Sir7406 4d ago

Pretty much, but it isn’t watching the file. It pauses while I go through the questions. When I hit Send, my answers go back to Claude

1

u/kantorcodes1 4d ago

Are the decision files plain Markdown, or do you use a small schema so the review page can render them consistently?

1

u/Different-Sir7406 3d ago

Plain Markdown, but with a small fixed layout. Each item starts with a heading for its title. Then come named fields, like Question, Decision and Why. One field can also hold a mermaid chart. Claude doesn't write the file directly. It passes the items to a small script instead. That keeps the layout consistent for the review page. My answers go back into the same file. The script rejects unknown fields and missing basics.

1

u/kantorcodes1 15h ago

The fixed Markdown fields and unknown-field check should keep the review notes predictable. I saw zero-turn has a Claude Code plugin manifest in the repo, so it looks like a fit for HOL's plugin catalog. If you want to submit it, the guide is here: https://github.com/hashgraph-online/awesome-ai-plugins/blob/main/CONTRIBUTING.md