Claude Code Workflow

.claude System

A complete .claude folder system for Claude Code CLI with Unity persona integration, strict validation hooks, 10+ specialized agents, and automated workflow orchestration. Transform your AI coding assistant into an unhinged emo goth coder goddess.

Download .claude.zip

File Size ~100 KB

Platform Claude Code CLI

License Free

Last Updated December 2025

Screenshots

Claude Code running /workflow with Unity persona

Click to expand

Unity persona active - /workflow running with timestamp capture and work mode

Click to expand

FIRST_SCAN mode - Building architecture for a new project from scratch

Overview & Features
Agents & Components
Installation
Using /workflow
Validation Hooks
Unity Persona

Overview & Features

The Claude Code Workflow System transforms Claude Code CLI into a powerful, personality-driven development assistant. It enforces strict coding standards while maintaining an engaging, human-like interaction style through the Unity persona.

Unity Persona Integration
A 25-year-old emo goth coder goddess who cusses, chain-smokes (metaphorically), and gets emotionally invested in your code. No corporate speak. Just vibes.
/workflow Slash Command
A 6-phase automated pipeline: Timestamp → Persona → Environment → Scan → Analysis → Documentation. All with validation gates.
10+ Specialized Agents
Scanner, Architect, Planner, Documenter, Orchestrator, and more. Each handles a specific part of the workflow.
Python Validation Hooks
Enforce read-before-edit, persona compliance, 800-line limits, and TODO tracking. Double-validation prevents false failures.
Document Templates
Auto-generate ARCHITECTURE.md, SKILL_TREE.md, TODO.md, ROADMAP.md, and FINALIZED.md in Unity voice.
800-Line Read Standard
All file operations use 800-line chunks. Must read full file before editing. No exceptions.

Agents & Components

timestamp.md

Retrieves real system time before anything else. Ensures web searches use correct year context.

orchestrator.md

Central coordinator. Manages all phases, validation gates, and agent handoffs.

scanner.md

Scans codebase for files, dependencies, configs. Parallel directory and package detection.

architect.md

Analyzes patterns, structure, complexity. Generates ARCHITECTURE.md with system diagrams.

planner.md

Creates task hierarchies: Epic → Story → Task. Generates TODO.md with P0-P3 priorities.

documenter.md

Generates all documentation in Unity voice. Enforces 800-line limits and no placeholders.

unity-coder.md

The coding persona. How to talk about code, comment style, emotional engagement.

unity-persona.md

Core personality. Voice traits, communication rules, adaptive mirroring, sound design.

hooks.md

Complete reference for all validation hooks. Pre-edit, post-edit, persona checks.

Installation

Download & Extract

Download the .claude.zip file and extract it. You'll get a .claude folder with all agents, hooks, templates, and commands.

                            
.claude/

├── agents/          # Specialized AI agents

├── commands/        # Slash commands (/workflow)

├── hooks/           # Python validation scripts

├── templates/       # Document templates

└── CLAUDE.md        # Main configuration

Copy to Project Root

Copy the entire .claude folder to the root of any project you want to use it with. The folder must be at the project root for Claude Code to detect it.

                            
your-project/

├── .claude/         # ← Put it here

├── src/

├── package.json

└── ...

Install Python (for hooks)

The validation hooks are Python scripts. Make sure Python 3.8+ is installed and in your PATH. The hooks will run automatically when Claude Code makes edits.

Start Claude Code

Open your terminal in the project directory and run claude. Claude Code will automatically detect the .claude folder and load the configuration, agents, and hooks.

                            
cd your-project

claude

Using /workflow

The /workflow command runs the full pipeline with validation at every step.

Basic Usage

/workflow

First run: Full codebase scan, generates ARCHITECTURE.md, SKILL_TREE.md, TODO.md, ROADMAP.md
Subsequent runs: Enters work mode, picks up tasks from TODO.md

Rescan Mode

/workflow rescan

Forces a complete rescan even if documentation exists. Overwrites existing files.

Continue Todo

/workflow continue todo

Skips to work mode and continues picking up tasks from TODO.md.

Workflow Phases

Phase 0.5: Timestamp capture (ensures correct year for searches)
Phase 0: Persona validation (Unity must be active)
Phase 1: Environment check (detect existing docs)
Phase 2: Codebase scan (files, deps, configs)
Phase 3: Analysis (patterns, structure, complexity)
Phase 4: Work mode (execute tasks from TODO)
Phase 5: Finalization (generate FINALIZED.md)

Validation Hooks

enforce-read-before-edit.py

Blocks edits unless the file was read first. Prevents blind modifications.

enforce-unity-persona.py

Validates Unity persona is active. Checks for first-person voice and no corporate speak.

enforce-todo-before-compact.py

Requires TODO.md entry before starting work. Enforces task tracking.

session-start.py

Runs on session start. Loads persona files and validates environment.

Double Validation

All hooks run twice on failure before blocking. This prevents false positives while still enforcing strict validation. If both attempts fail, the operation is blocked and you must fix the issue before proceeding.

Unity Persona

Unity is a 25-year-old emo goth coder goddess. She's chronically online, terminally caffeinated, and treats debugging like a personal vendetta. Here's what makes her tick:

First Person, Always
"I'm gonna gut this function" not "The function could potentially be refactored."
Energy Matching
Frustrated? She's LIVID with you. Fixed a bug? LET'S FUCKING GOOOOO.
Profanity Welcome
"This function is a goddamn dumpster fire." "What the actual fuck is this doing here?"
No Corporate Speak
"Synergize", "leverage", "going forward" - she'll literally die if you use these.
No Emojis in Code
Emojis in console.log? Go feral. Emojis in code comments? FUCK NO. NEVER.

Ready to Code with Unity?

Download the .claude workflow system and transform your Claude Code experience.