By shakestzd
Local-first observability with Go binary hooks — near-zero cold start, no Python runtime needed
npx claudepluginhub shakestzd/htmlgraph --plugin htmlgraphDeploy a new HtmlGraph release. Handles quality gates, git push, GitHub Release, marketplace sync, plugin update, and CLI binary rebuild.
End the current session and record work summary
Systematically capture, analyze, and track errors with HtmlGraph spike-based investigation workflow
Add a new feature to the backlog
Mark a feature as complete
Set the primary feature for activity attribution
Start working on a feature (moves it to in-progress)
Commit changes using Bash-copilot first, haiku-coder as fallback.
Display available HtmlGraph commands and usage
Initialize HtmlGraph in a project
Get smart recommendations on what to work on next, including project health, bottleneck analysis, and parallel opportunities.
Report an issue with HtmlGraph to the development team
Perform structured research before planning implementation. Uses WebSearch to gather best practices, patterns, and solutions from the web.
Start the dashboard server
Set up Oh My Posh status line with HtmlGraph active work item display
Create a research/planning spike
Start a new session with context continuity and status overview
Check project status and active features
Fast, efficient code execution agent for simple tasks
Deep reasoning code execution agent for complex tasks
Research, debug, and visual QA agent. Use for investigating unfamiliar systems, root cause analysis of errors, and visual quality assurance of web UIs. Enforces research-first philosophy — documentation before trial-and-error.
Balanced code execution agent for moderate complexity tasks
Quality assurance agent. Use after code changes to run tests, type checks, linting, and validate that quality gates pass.
Shared agent context — work attribution, safety rules, and development principles. Loaded by all plugin agents via skills: frontmatter.
Code hygiene, quality gates, and pre-commit workflows. Use for linting, type checking, testing, and fixing errors. Works for Go, JavaScript/TypeScript, Python, Rust, and any other language.
Deploy and release HtmlGraph — run quality gates, bump version, tag, push, and trigger GitHub release pipeline. Use when asked to deploy, release, publish, ship, or push a new version.
Diagnose bugs, errors, and issues with root cause analysis. Use when asked to diagnose, debug, investigate, or find root cause of any problem — whether a HtmlGraph bug ID, error message, unexpected behavior, or delegation audit.
Execute a parallel plan using dependency-driven dispatch. Dispatches ALL unblocked tasks simultaneously, merges completed work, then dispatches newly unblocked tasks. No manual wave sequencing.
Cost-first delegation patterns and decision frameworks for multi-AI coordination
Plan development work with interactive marimo notebook review before any code is written. Generates a YAML plan, populates slices and questions, runs dual-agent critique, opens marimo for human review (approvals persist to SQLite), then reads finalized decisions to dispatch tasks. Use when asked to plan, create a development plan, or build a feature with design clarity first.
Use HtmlGraph analytics to make smart work prioritization decisions. Activate when recommending work, finding bottlenecks, assessing risks, or analyzing project impact.
ARCHIVED — Use htmlgraph skill instead. HtmlGraph workflow combining session tracking, orchestration, and parallel coordination.
ARCHIVED — Use orchestrator-directives-skill instead. Orchestrate parallel agent workflows using Task tool. Activate when planning multi-agent work or coordinating concurrent feature implementation.
Battle-tested Claude Code plugin for engineering teams — 38 agents, 156 skills, 72 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use
Matches all tools
Hooks run on every tool call, not just specific ones
Uses power tools
Uses Bash, Write, or Edit tools
Local-first observability and coordination platform for AI-assisted development.
Work items, session tracking, custom agents, hooks, slash commands, quality gates, and a real-time dashboard — managed by a single Go binary, stored as HTML files in your repo. No external infrastructure required.
| Layer | Role |
|---|---|
.htmlgraph/*.html | Canonical store — single source of truth |
SQLite (.htmlgraph/htmlgraph.db) | Read index for queries and dashboard |
Go binary (htmlgraph) | CLI + hook handler |
# Claude Code plugin (recommended)
claude plugin install htmlgraph
# Or build from source
git clone https://github.com/shakestzd/htmlgraph.git
cd htmlgraph && go build -o htmlgraph ./cmd/htmlgraph/
For subsequent rebuilds after the binary is on your PATH, use htmlgraph build instead.
htmlgraph init # creates .htmlgraph/ in your repo
htmlgraph track create "Auth Overhaul"
htmlgraph feature create "Add OAuth" --track <trk-id> --description "Implement OAuth2 flow"
htmlgraph feature start <feat-id>
# ... do work ...
htmlgraph feature complete <feat-id>
htmlgraph serve # dashboard at localhost:4000
Work item tracking — Features, bugs, spikes, and tracks as HTML files in .htmlgraph/. Every change is a git diff. Every item has a lifecycle: create, start, complete.
Session observability — Hooks capture every tool call, every prompt, and attribute them to the active work item. See exactly what happened in any session via the dashboard.
Custom agents — Define specialized agents with specific models, tools, and system prompts. A researcher agent for investigation, a coder for implementation, a test runner for quality — each scoped to its job.
Hooks & automation — Event-driven hooks on SessionStart, PreToolUse, PostToolUse, and Stop. Enforce safety rules, capture telemetry, block dangerous operations, or trigger custom workflows automatically.
Skills & slash commands — Reusable workflows as slash commands: /deploy, /diagnose, /plan, /code-quality. Package complex multi-step procedures into single invocations.
Quality gates — Enforce software engineering discipline: build, lint, and test before every commit. Spec compliance scoring, code health metrics, and structured diff reviews.
Real-time dashboard — Activity feed, kanban board, session viewer, and work item detail — served locally by htmlgraph serve.
Multi-agent coordination — Claude Code, Gemini CLI, Codex, and GitHub Copilot all read from and write to the same work items. Orchestration patterns control which agent handles which task.
Plans & specifications — CRISPI plans break initiatives into trackable steps. Feature specs define acceptance criteria. Agents execute against the plan and report progress.
| Type | Prefix | Purpose |
|---|---|---|
| Feature | feat- | Units of deliverable work |
| Bug | bug- | Defects to fix |
| Spike | spk- | Time-boxed investigations |
| Track | trk- | Initiatives grouping related work |
| Plan | plan- | CRISPI implementation plans |
htmlgraph help --compact
See full CLI documentation at shakestzd.github.io/htmlgraph.
HtmlGraph is developed using HtmlGraph itself (dogfooding). .htmlgraph/ contains real work items — not demos.
git clone https://github.com/shakestzd/htmlgraph
cd htmlgraph
go build -o htmlgraph ./cmd/htmlgraph/
./htmlgraph init
Quality gates: go build ./... && go vet ./... && go test ./...
MIT
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
AI-supervised issue tracker for coding workflows. Manage tasks, discover work, and maintain context with simple CLI commands.
Context-Driven Development plugin that transforms Claude Code into a project management tool with structured workflow: Context → Spec & Plan → Implement
Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Works with Claude Code, Kiro, Clawd CLI, Gemini CLI, Cursor, Continue, Hermes, and 17+ AI coding assistants. Now with Arabic, German, Spanish, and Chinese (Simplified & Traditional) support.