Platforms · Claude Code

Runtime Claude Code native với hooks, agents, skills.

Installer ghi `.claude/` runtime đầy đủ kèm `CLAUDE.md` ở project root. Hooks enforce privacy, spec state, docs sync, session context.

Layout sau khi cài#

.claude/
├── skills/         # Workflow + domain skill packs (question, brainstorm, specs, ...)
├── agents/         # Subagent prompts (brainstormer, code-auditor, ...)
├── hooks/          # Event-driven CommonJS scripts
├── rules/          # Workflow, dev, docs, hook, state-sync rules
├── scripts/        # Helper scripts (catalog generator, ...)
├── references/     # Static lookup material
├── runtime.json    # Locale, paths, docs.maxLoc, gemini model
├── settings.json   # Hook bindings và permissions
└── status.cjs      # Statusline renderer
CLAUDE.md           # Operating instructions ở project root
.mcp.json           # Optional MCP server config

Hooks#

Claude Code có hooks event-driven trong .claude/hooks/:

HookEventPurpose
privacy-block.cjsPreToolUseChặn read path nhạy cảm cho đến khi user approve
inspect-block.cjsPreToolUseGate inspection scan diện rộng
spec-state.cjsPostToolUseTừ chối task done khi chưa có verification receipt
docs-sync.cjsSessionStartFlag missing docs, sync hash drift
session.cjsSessionStartInject session banner + context
usage.cjsUserPromptSubmitTrack token/usage hints
rules.cjsUserPromptSubmitInject dynamic per-prompt rules block

Xem Runtime bundle để biết chi tiết hook contract.

Commands#

Claude Code dùng namespace hapo::

/hapo:question    /hapo:brainstorm    /hapo:specs       /hapo:develop
/hapo:test        /hapo:code-review   /hapo:sync        /hapo:debug
/hapo:hotfix      /hapo:docs          /hapo:inspect     /hapo:git

Cộng tất cả domain skill dưới dạng /hapo:<skill>.

Detection#

Installer detect Claude Code khi có:

  • Thư mục .claude/
  • CLAUDE.md ở project root
  • .mcp.json ở project root

Chạy lại installer là idempotent — file đã có sẽ được merge nơi nào an toàn, không ghi đè mù.