Adopt Claude Project Kit for Hyperframes

[teamkareem]

Context

Source analysis: TowardsAI Claude Code playbook — https://pub.towardsai.net/becoming-a-top-1-claude-code-user-the-complete-playbook-no-one-else-is-sharing-96057be1468e

Adopt the useful Claude-native packaging layer while preserving Hyperframes-specific workflow rules.

Artifact

Reusable kit created locally at:

~/.hermes/templates/claude-project-kit/

Implementation plan:

~/.hermes/plans/2026-04-28-claude-project-kit-adoption.md

Scope

• Baseline audit current Hyperframes Claude Code scaffolding.
• Merge missing .claude/ kit pieces without overwriting existing repo-specific settings.
• Preserve bun, oxlint, oxfmt, and deterministic rendering constraints.
• Add native Claude Code agents/commands/session summary hooks.
• Keep MCP least-privilege and task-specific.

Acceptance Criteria

• python3 ~/.hermes/templates/claude-project-kit/scripts/audit-claude-project-kit.py <repo> reports 14/14 or documented intentional exceptions.
• Existing Hyperframes .claude/settings.json behavior is preserved/merged, not blindly replaced.
• Agents and commands are present for review, security, diagnosis, shipping, and planning.
• Build/lint/test gates use Hyperframes-native commands, not pnpm/npm workspace assumptions.
• PR body includes before/after audit, gates run, and remaining risks.

Roadmap Marker

This issue tracks Claude Project Kit adoption for Hyperframes as the second target.

[teamkareem]

Baseline audit recorded from local repo /Users/klaus/projects/hyperframes.

Claude Project Kit Audit: /Users/klaus/projects/hyperframes
✅ CLAUDE.md
✅ .claude/settings.json
❌ .claude/hooks/block-dangerous.sh
❌ .claude/hooks/pre-commit-gates.sh
❌ .claude/hooks/session-summary.sh
❌ .claude/agents/staff-code-reviewer.md
❌ .claude/agents/security-auditor.md
❌ .claude/agents/spec-compliance-reviewer.md
❌ .claude/agents/test-writer.md
❌ .claude/agents/ci-failure-diagnoser.md
❌ .claude/commands/ship.md
❌ .claude/commands/review-pr.md
❌ .claude/commands/diagnose.md
❌ .claude/commands/plan-feature.md
CLAUDE.md lines: 70
⚠️  settings.json does not appear to deny .env reads/edits.
Score: 2/14

Immediate implication: Hyperframes is already healthier than MomentumOS on root context size, but needs native Claude agents/commands/hooks and a settings merge that preserves bun/oxlint/oxfmt conventions.

[teamkareem]

Implementation PR opened: #553

Verification: Claude Project Kit audit is 14/14; JSON and shell hooks pass syntax checks. Branch pushed from fork because upstream push is not permitted for teamkareem.

[teamkareem]

Review/update complete on PR: #553

Latest head: 13a13fe

Final evidence: Claude Project Kit audit 14/14, JSON + hook syntax clean, review comment posted. Local bun gates could not be run in Hermes because bun is not installed on the active PATH. Merge remains blocked by GitHub review requirements requiring a non-author reviewer.