Handbook

General vs specific intelligence (system)

General resolves problem class → pack → ladder before domain logic runs. Specific implements per-domain deterministic decisions and legal LLM accelerators.

Updated 2026-07-26

Intent

General resolves problem class → pack → ladder before domain logic runs. Specific implements per-domain deterministic decisions and legal LLM accelerators.

Behavior

General

Catalog: packs/catalog.yaml → forge_intelligence.catalog.list_packs()
Records ladder in route_trace.json at session start
See GENERAL-INTELLIGENCE.md

Specific pack layout

packs/<domain>/
  policy.yaml       # intelligence policy instance
  README.md
  flows/            # .lmeta scripts (composition only)
  fixtures/         # golden route traces

Authoring rules

Compose LCDL/lmeta — do not fork FlowExecutor.
Closed allowed_actions in policy.yaml.
Bounded facts on break-in inputs.
Golden route_trace fixture per pack.
Register in packs/catalog.yaml.

FI-local I/O contracts: lcdl/contracts/intelligence_*_v1/. Promote tasks to forge-lcdl only when ≥2 domains need the same substrate.

Limits

Reference pack: packs/situation-arbitrate/. Domain wave rollout: domains/README.md.

Forge Intelligence