tjq001/hv-code-templates

The Developer's Memory Palace — A Zero-Dependency Workflow for Intent-Driven Development
**Version 2.0.0 | MIT License | 2026 Release**
---
🧠 Executive Overview: Why Your Commits Need a Skeleton Key
Every developer knows the feeling. You stare at a commit history that reads like a mystery novel written by amnesiacs. "fix stuff", "updated thing", "changes" — these are not commit messages. These are confessions of lost intent.
**hv-skills** is your development workflow's nervous system. It's a zero-dependency framework that transforms how Claude Code (or any AI coding assistant) remembers, plans, and executes work. Think of it as a **memory palace for your codebase** — a structured knowledge retention system that ensures no hard-won insight ever evaporates into the digital ether.
---
🗺️ Architecture Overview: The Four Pillars of Atomic Development
---
🔧 Core Concepts: The Anatomy of Intent
What Makes hv-skills Different?
Traditional development workflows treat commits as checkpoints. hv-skills treats them as **intent capsules** — preserved moments of understanding that can be recalled, replayed, and refined.
**Key Architectural Decisions:**
| Concept | Traditional Approach | hv-skills Approach |
|---------|---------------------|-------------------|
| **Commit Messages** | "fixed bug" | "fix: resolved race condition in websocket handler (HV-214)" |
| **Context Retention** | Relies on developer memory | Structured .skills/ directory with machine-readable intent |
| **Cross-Session Memory** | None | Persistent knowledge graph via CONTEXT.md |
| **Atomicity Enforcement** | Developer discipline | Automated workflow validation |
---
📋 Prerequisites: What You Need
| Requirement | Version | Notes |
|-------------|---------|-------|
| Node.js | 18.x+ | Runtime only, no dependencies |
| Git | 2.30+ | For atomic commit tracking |
| Claude Code | Latest | Primary AI integration target |
| OpenAI API Key | Any | Optional for hybrid AI workflows |
| Claude API Key | Any | Primary AI provider |
---
🚀 Installation & Setup
Quick Start (30 Seconds)
Verify Installation
---
⚙️ Example Profile Configuration
Every developer's workflow is unique. hv-skills supports **profile-based configuration** that adapts to your preferred development style.
---
💻 Example Console Invocation
Watch the magic unfold in real-time:
**Expected Console Output:**
---
🖥️ Emoji OS Compatibility Table
| Operating System | hv-skills v2.0 | Emoji Rendering | Features Supported | 24/7 Customer Support |
|-----------------|----------------|-----------------|-------------------|----------------------|
| 🐧 Linux (Ubuntu 22.04+) | ✅ Full | ✅ Native | All core features | ✅ |
| 🍎 macOS 14+ (Sonoma) | ✅ Full | ✅ Native | All core features | ✅ |
| 🏁 Windows 11+ | ✅ Full | ✅ Via terminal | WSL2 recommended | ✅ |
| 🐳 Docker (Alpine) | ✅ Full | ⚠️ Limited | Core features only | ✅ |
| 📱 Termux (Android) | ✅ Basic | ✅ Native | CLI only | ⚠️ Limited |
| 🖥️ FreeBSD 13+ | ✅ Full | ⚠️ Limited | Core features | ✅ |
---
🔑 Feature Matrix: What Makes hv-skills Indispensable
Core Features
- **Zero-Dependency Architecture** — No npm install, no pip, no gem. Pure shell + git.
- **Intent-Driven Commit Planning** — Declare *why* before *what*. Your commit history becomes a narrative.
- **Cross-Session Memory** — hv-skills remembers what *you* remember. Spaced repetition for developer context.