Hile AI Development Skill

@hile/*

Required Workflow

1. Read

   references/package-map.md

   to choose the package card and recipe for the user request.
2. Read

   references/conventions.md

   before editing code.
3. Start from the closest complete example in

   references/packages/*.md

   or

   references/recipes/*.md

   .
4. Read

   references/anti-patterns.md

   before finalizing.
5. If docs conflict with source code or tests in a Hile repository, trust source/tests and update the docs.

High-Risk Rules

• Do not call

  loadService()

  at module top level; call it inside boot services, controllers, models, message handlers, queue workers, or functions.
• Load

  @hile/http

  controllers before

  http.listen()

  in new code.

• @hile/http

  Zod validation validates only; parse again when the handler needs coerced data.

• MessageModem._send()

  and

  Application.call()

  return promises. Await them directly.
• Redis lock, idempotency, rate limit, cache, and queue helpers are not exactly-once guarantees.
• Queue handlers and retryable HTTP/RPC handlers with side effects need idempotency or a stronger business uniqueness wall.

Reference Router

• references/package-map.md

  : choose what package solves the task.

• references/conventions.md

  : lifecycle, ESM, file layout, and response conventions.

• references/anti-patterns.md

  : failure modes to avoid before finalizing.

• references/anti-patterns.md

• references/conventions.md

• references/index.md

• references/package-map.md

• references/packages/core-lifecycle.md

• references/packages/create-hile.md

• references/packages/http-next.md

• references/packages/http.md

• references/packages/infrastructure.md

• references/packages/mcp.md

• references/packages/messaging-micro.md

• references/packages/model-context.md

• references/packages/reactivity.md

• references/packages/redis-reliability.md

• references/packages/reloader.md

• references/packages/rsc.md

• references/recipes/http-api-model-typeorm.md

• references/recipes/http-next-fullstack.md

• references/recipes/mcp-distributed-gateway.md

• references/recipes/micro-registry-read-apis.md

• references/recipes/micro-rpc-message-loader.md

• references/recipes/new-project-scaffold.md

• references/recipes/queue-worker-idempotency.md

• references/recipes/redis-cache-singleflight.md

• references/recipes/rsc-plugin-host.md

• references/recipes/runtime-config.md

• references/recipes/stable-runtime-reload.md

Verification

pnpm run build
pnpm run test

AI.md