Skip to content

CLAUDE.md

Latest commit

 

History

History
52 lines (36 loc) · 1.63 KB

CLAUDE.md

File metadata and controls

52 lines (36 loc) · 1.63 KB

CLAUDE.md -- create-helix

Project Overview

create-helix is a TUI-powered CLI scaffolder for HELiX enterprise web component projects. It supports 8 framework targets and 4 Drupal presets.

Tech Stack

  • TypeScript (strict mode)
  • Node.js >= 20 (ESM)
  • @clack/prompts (TUI)
  • Vitest (testing)
  • ESLint 9 (flat config) + Prettier

Quick Reference

npm run verify     # lint + format:check + type-check (MANDATORY before push)
npm run test       # Run all tests
npm run build      # Compile TypeScript
npm run preflight  # verify + test (full pre-push check)

Non-Negotiables

  1. TypeScript strict -- No any. No @ts-ignore.
  2. npm run verify before every push -- Zero CI cycles wasted.
  3. No secrets in code -- This is a PUBLIC repo. Zero tolerance.
  4. Tests for all scaffolding logic -- Every framework, every preset.

Git Rules

  • npm run verify must pass before push (enforced by Husky pre-push hook)
  • Never use --no-verify
  • Commit messages: concise, imperative ("Add Vue support", not "Added")
  • Branch strategy: feature/* -> dev -> staging -> main

REA Governance (managed — do not edit this block)

  • Policy: .rea/policy.yaml — profile bst-internal
  • Autonomy: L3 (ceiling L3)
  • Blocked paths: 8 entries — see the policy file
  • block_ai_attribution: true (enforced by commit-msg hook)

Protected-path changes (src/gateway/middleware/, hooks/, src/policy/, .github/workflows/) require a /codex-review audit entry before push.

Run rea doctor to verify the install. Run rea check to inspect state.