nobodyiscertain-dev-flow

Claude Code Configuration Repository

A centralized collection of instructions, guidelines, and custom slash commands for AI coding agents, specifically optimized for Claude Code. This repository provides structured workflows for feature development from ideation through production.

Purpose

This repository provides:

• AGENTS.md - Core agent workflow and instructions following the AGENTS.md standard
• Custom Slash Commands - Complete workflow commands for Claude Code (brainstorming, requirements, task orchestration, git workflows)
• Specialized Agent Roles - Focused implementer and review-architect agents for structured development
• Development Guidelines - Language-specific conventions, testing practices, and git workflows

Repository Structure

claude-config/
├── README.md                      # This file - complete guide and workflows
├── CLAUDE.md                      # Repository-specific Claude Code instructions
├── AGENTS.md                      # Core agent guidelines (use in project roots)
├── Rakefile                       # Automated setup/uninstall tasks
├── .gitignore                     # Ignore OS files, editors, generated tasks
├── agents/                        # Specialized agent role definitions
│   ├── implementer.md            # Task execution agent (no scope creep)
│   └── review-architect.md       # Code review and quality assurance agent
├── commands/                      # Custom Claude Code slash commands
│   ├── brainstorm.md             # Interactive idea refinement
│   ├── create-prd.md             # Product requirements generation
│   ├── create-erd.md             # Engineering requirements generation
│   ├── generate-tasks.md         # Task breakdown from requirements
│   ├── task-orchestrator.md      # Automated task execution with AI agents
│   ├── process-task-list.md      # Manual task list workflow guidance
│   ├── smart-commit.md           # Intelligent commit creation
│   ├── create-pr.md              # Draft PR creation
│   └── update-docs.md            # Documentation sync from git history
└── guidelines/                    # Language-specific development guidelines
    ├── git-workflow.md           # Branch naming, commits, PRs, rebasing
    ├── ruby-rails.md             # Rails conventions and best practices
    ├── javascript.md             # JS/TS, React, Hotwire/Stimulus guidelines
    └── testing.md                # RSpec, Jest, FactoryBot, mocking strategies

Quick Start

For Claude Code Users

Automated Setup (Easiest):

# Clone or navigate to this repository
cd ~/Code/claude-config

# Run the automated setup
rake setup

# This will:
# - Create ~/.claude/ directory if needed
# - Symlink AGENTS.md to ~/.claude/CLAUDE.md
# - Symlink all files in agents/, commands/, and guidelines/ to ~/.claude/

# To remove symlinks later:
rake uninstall

Manual Setup (Alternative):

# Reference this repo in your global Claude Code config
echo "For all projects, follow guidelines in ~/Code/claude-config/AGENTS.md" >> ~/.claude/CLAUDE.md

Project-Specific Setup:

# Copy commands to use in a specific project
cp -r ~/Code/claude-config/commands /path/to/project/.claude/

# Copy AGENTS.md to project root for project-specific context
cp ~/Code/claude-config/AGENTS.md /path/to/project/

Install as Claude Plugin (Recommended for Web/IDE):

This repository is configured as a Claude plugin and can be installed directly in Claude Code (web version, VS Code extension, or JetBrains IDE):

1. Open Claude Code in your preferred environment (web, VS Code, or JetBrains)
2. Use the plugin menu to install from this repository:
   • In Claude Code, go to the Plugins section
   • Search for or paste the repository URL
   • Click "Install" to add this plugin
3. Verify installation:
   • After installation, all slash commands (like /task-orchestrator, /brainstorm, etc.) will be available
   • Agent guidelines will be loaded automatically
   • This repository's CLAUDE.md will be available as your configuration

The plugin configuration is defined in .claude-plugin/plugin.json and includes:

• All custom slash commands from commands/ directory
• Specialized agents from agents/ directory
• Development guidelines from guidelines/ directory

For AI Agents Reading This

1. Read AGENTS.md first - Contains core workflow instructions and philosophy
2. Check CLAUDE.md - Repository-specific architecture and conventions
3. Reference the Workflows section below - Complete workflow decision trees and examples
4. Use language-specific guidelines in guidelines/ as needed

Installation

Options Overview

This repository can be installed in three ways: