convez.ai
Skill
pappar

hitl-claude-plugin

pappar/hitl-claude-plugin

Ver no GitHub
InicialPluginScore · de 0 a 100

HITL AI-Driven Development — Claude Code plugin. 29 skills, 6 agents, enforcement hooks, and templates for the full 31-step delivery workflow.

Instalação

$npx convez-ai pappar/hitl-claude-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 2 dias
Versão
hitl--v2.18.0
Issues abertas
12
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

HITL Dev Platform — Claude Code Plugin

A Claude Code plugin for the HITL AI-Driven Development process — a document-driven delivery model for teams using AI heavily in non-trivial software work.

Prerequisites

DependencyRequiredUsed by
bashHardAll hooks
python3HardAll hooks (JSON/YAML parsing)
PyYAML (pip install pyyaml)Hardcheck-domain-boundary.sh, write-session-summary.sh — hooks silently no-op if missing
git (inside a git repo)Hardwrite-session-summary.sh, overall workflow
gh (GitHub CLI)RecommendedStep → issue comment sync; skipped silently if absent
graphify (pip install graphifyy)OptionalKnowledge graph; skipped silently if absent

Install

claude plugin marketplace add pappar/hitl-claude-plugin
claude plugin install hitl@hitl

Restart Claude Code after installing. If plugin install fails with a host-key error, see Troubleshooting.

Update

Once installed, update from inside Claude Code:

/hitl:dev-update

Do not re-run the install commands to update.

What you get

ComponentContents
Skills/hitl:dev-start-from-prd, /hitl:dev-start-brownfield, /hitl:dev-start-migration, /hitl:dev-practices (32-step workflow), /hitl:dev-tdd, /hitl:dev-generate-docs, /hitl:dev-apply-change, /hitl:ta-approve, and role namespaces /hitl:architect-*, /hitl:pm-*, /hitl:qa-*, /hitl:ops-*
AgentsArchitect reviewer, developer implementer, QA reviewer, PM reviewer, ops release reviewer, spec conformance reviewer
Commands/hitl:dev-check-implementation, /hitl:architect-review-design, /hitl:architect-verify-traceability, /hitl:ops-review-release, /hitl:ops-monitor-canary
HooksWelcome banner, HITL context check, domain boundary enforcement, session summary, step→issue sync

Step 0 of each start skill wires up hooks automatically. Restart Claude Code after Step 0 completes.

Optional: Graphify (knowledge graph)

pip install graphifyy

Billing note for Claude subscription users: The initial build runs LLM extraction. Pass --backend claude-cli to use your subscription instead of API credits:

graphify . --directed --no-viz --backend claude-cli

Do not put ANTHROPIC_API_KEY in .env if you are on a subscription. The background rebuild hook never calls an LLM and is always free.

Troubleshooting

claude plugin install fails with "Host key verification failed"

✘ Failed to install plugin "hitl@hitl": No ED25519 host key is known for github.com

The repo is public — the error is SSH configuration, not permissions. Fix:

ssh-keyscan github.com >> ~/.ssh/known_hosts
git config --global --add url."https://github.com/".insteadOf "git@github.com:"
git config --global --add url."https://github.com/".insteadOf "ssh://git@github.com/"
claude plugin install hitl@hitl

Use --add on both git config calls so the second does not overwrite the first.

Clean reinstall

If your setup is broken (stale clone paths, missing hooks):

bash <(curl -fsSL https://raw.githubusercontent.com/pappar/hitl-claude-plugin/main/scripts/reinstall.sh)

Documentation

Full documentation, playbooks, role guides, and adoption ladder live in the source repo:

github.com/Prasad-Apparaju/hitl-dev-platform

Quick start

Once installed, open Claude Code in your project and run the command that matches your situation:

SituationCommand
New project — greenfield from a PRD/hitl:dev-start-from-prd
Existing codebase — adopt the process/hitl:dev-start-brownfield
Migrating a system/hitl:dev-start-migration
Already set up — start a change/hitl:dev-practices

Contributing / Building from source

Skills, commands, agents, and templates are authored in the source repo:

github.com/Prasad-Apparaju/hitl-dev-platform — edit files under ai/claude/ there.

After updating the source, rebuild this plugin:

# Clone both repos as siblings
git clone https://github.com/Prasad-Apparaju/hitl-dev-platform
git clone https://github.com/pappar/hitl-claude-plugin

# Rebuild
cd hitl-claude-plugin
./scripts/build.sh
# If 'claude' on your PATH is a broken wrapper, override the binary:
# CLAUDE_BIN=/path/to/claude ./scripts/build.sh

# Review, commit, push
git diff --stat
git add -A && git commit -m "chore: rebuild from hitl-dev-platform"
git push

The same source can be used to build plugins for other AI platforms (e.g. Codex) by following the same build pattern with a platform-specific manifest and hooks.

License

MIT

Ver o original no GitHub

Bom para

Relacionados