H.K — Structured Development Workflow for Claude Code

H.K is a complete development workflow that organizes every task into clear steps: brainstorm → design → plan → code → validate → ship. It adapts automatically to complexity and includes 20 specialized skills.

Installation

One command (recommended)

npx hk-workflow

Options:

npx hk-workflow --hooks      # Also install git hooks (pre-commit, security guard)
npx hk-workflow --force       # Overwrite existing installation
npx hk-workflow --uninstall   # Remove H.K workflow

Manual

cp -r H.K/hk/ ~/.claude/skills/hk/
cp -r H.K/skills/* ~/.claude/skills/
cp -r H.K/rules/* ~/.claude/rules/
cp -r H.K/meta/* ~/.claude/skills/shared/meta/

Quick Start

/hk add a logging system                    # Full workflow
/hk-dev implement JWT authentication        # Autonomous mode
/onetap fix the typo in the footer          # Ultra-fast, one task
/hk-help                                    # See all commands

All Commands

Workflow

| Command | Description | |---------|-------------| | /hk <task> | Full development workflow | | /hk-dev <task> | Autonomous mode (no interruptions + auto-save) | | /hk-help [command] | Display all commands and flags |

Creative & Planning

| Command | Description | |---------|-------------| | /hk-brainstorm <topic> | Creative brainstorming with Iris (15 techniques, 3 depth levels) | | /hk-design <description> | UI/UX design with Léo (adapt/create/redesign, HTML mockup) | | /hk-prd <description> | Product requirements with Aria (discovery → scope → FRs) |

Code Quality

| Command | Description | |---------|-------------| | /hk-audit-rules [--full\|--security] [path] | Code audit — 18 rules + custom CLAUDE.md rules | | /hk-debug <bug> | Systematic debugging — 3 hypotheses, differential diagnosis | | /hk-refactor [files] | Refactoring — 3 modes (full codebase / targeted / single file) | | /hk-changelog | Generate changelog from git commits | | /onetap <feature> | Ultra-fast implementation (explore → code → test) |

Project Context

| Command | Description | |---------|-------------| | /hk-context [update] | Generate/update project context | | /hk-monitoring <description> | Add entry to project journal |

Git

| Command | Description | |---------|-------------| | /commit | Quick commit + push | | /create-pr | Create PR with auto-generated description | | /merge <branch> | Smart merge with conflict resolution | | /fix-errors | Fix lint/typecheck errors in parallel | | /fix-pr-comments | Apply PR review feedback |

Security Audit (separate installation)

| Command | Description | |---------|-------------| | /threat-modeling | STRIDE threat analysis (9 phases) | | /adversary-simulation | Red team attack simulation (7 phases) | | /defensive-hardening | Blue team hardening with code (9 phases) |

Reference

| Command | Description | |---------|-------------| | /agent-prompt | Structured prompting for subagents/teams | | /prompt-creator | Prompt engineering guide (13 techniques) | | /skill-creator | Guide for creating Claude Code skills | | /claude-memory | Create/optimize CLAUDE.md files |

Complexity Levels

H.K auto-detects the right level. You can force it with --level.

| Level | When | Steps | |-------|------|-------| | L1 | Quick fix (1-3 files) | Execute → Validate | | L2 | Simple feature (4-7 files) | Analyze → Plan → Execute → Validate | | L3 | Full feature (8-15 files) | Full pipeline | | L4 | Major work (16+ files) | Full pipeline + mandatory Design |

Flags

| Flag | Effect | |------|--------| | -a / --autonomous | No interruptions except critical blockers | | -s / --save | Save state to .hk/hk-state.json | | -e / --economy | Direct tools only, no subagents | | -b / --branch | Create a dedicated git branch | | -l / --level | Force complexity level (L1/L2/L3/L4) | | -d / --design | Force design phase | | --force-harden | Mandatory security hardening | | --redesign | Force redesign mode in /hk-design | | --deep / --exhaustive | Brainstorming depth levels | | --full / --security | Audit depth levels |

Project Output

All generated files go to {project}-output/:

| File | Generated by | |------|-------------| | brainstorming/session-{date}.md | /hk-brainstorm | | prd.md | /hk-prd | | design-specs.md | /hk-design | | mockup-{name}.html | /hk-design | | project-context.md | /hk-context | | project-monitoring.md | /hk-monitoring | | learnings.md | /hk-debug |

Structure

H.K/
├── hk/                   # Main workflow
│   ├── SKILL.md          # Entry point
│   └── steps/            # 7 pipeline steps
├── skills/               # 20 specialized skills
├── rules/                # Global rules (copy to ~/.claude/rules/)
├── CLAUDE.md             # Template with 18 reflexes (10 security + 8 structure)
├── CHANGELOG.md          # Version history
└── TUTORIAL.md           # Complete guide

Full Guide

See TUTORIAL.md for detailed documentation of every command, flag, and workflow.