recipe-format-reference

Recipe Format Reference

Nested lingtai-recipe reference. Read this after the top-level router sends you here.

This is the authoring reference of the lingtai-recipe skill. For overview of all recipe-related flows, read ../../SKILL.md. For the recipe export flow, read ../export-recipe/SKILL.md.

A recipe bundle is a directory that ships two kinds of content, side-by-side:

1. A .recipe/ dotfolder containing the LingTai-facing behavioral layer (greet, comment, covenant, procedures) and the manifest (recipe.json).
2. An optional library folder (named by recipe.json#library_name) containing framework-agnostic skills — drop-in for any agent framework, not just LingTai.

The bundle is the shareable artifact. When the TUI applies a recipe, it copies the bundle into the project root; the project then becomes self-contained — every path reference in init.json resolves within the project directory.

Bundle Directory Structure

my-recipe-bundle/
├── .recipe/                             # required — LingTai behavioral layer
│   ├── recipe.json                      # required — manifest (id, name, description, library_name, …)
│   │                                    #   SINGLE CANONICAL FILE. NEVER localized.
│   │                                    #   Locale variants of recipe.json are FORBIDDEN —
│   │                                    #   they silently drop critical fields like library_name.
│   ├── greet/                           # optional — first-contact message
│   │   ├── greet.md                     #   default version
│   │   └── <lang>/greet.md              #   optional locale variants (en, zh, wen)
│   ├── comment/                         # optional — system-prompt constraints
│   │   ├── comment.md
│   │   └── <lang>/comment.md
│   ├── covenant/                        # optional — covenant override
│   │   ├── covenant.md
│   │   └── <lang>/covenant.md
│   └── procedures/                      # optional — procedures override
│       ├── procedures.md
│       └── <lang>/procedures.md
└── <library_name>/                      # optional — framework-agnostic skills
    ├── <skill-a>/
    │   └── SKILL.md
    └── <skill-b>/
        ├── SKILL.md
        ├── scripts/
        └── reference/