julian
17c08e6392
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# Template Substitution Rules
|
|
|
|
The SKILL-template provides a minimal skeleton: frontmatter, overview, and activation with config loading. Everything beyond that is crafted by the builder based on what was learned during discovery and requirements phases.
|
|
|
|
## Frontmatter
|
|
|
|
- `{module-code-or-empty}` → Module code prefix with hyphen (e.g., `bmb-`) or empty for standalone. The `bmad-` prefix is reserved for official BMad creations; user skills should not include it.
|
|
- `{skill-name}` → Skill functional name (kebab-case)
|
|
- `{skill-description}` → Two parts: [5-8 word summary]. [trigger phrases]
|
|
|
|
## Module Conditionals
|
|
|
|
### For Module-Based Skills
|
|
|
|
- `{if-module}` ... `{/if-module}` → Keep the content inside
|
|
- `{if-standalone}` ... `{/if-standalone}` → Remove the entire block including markers
|
|
- `{module-code}` → Module code without trailing hyphen (e.g., `bmb`)
|
|
- `{module-setup-skill}` → Name of the module's setup skill (e.g., `mymod-setup`)
|
|
|
|
### For Standalone Skills
|
|
|
|
- `{if-module}` ... `{/if-module}` → Remove the entire block including markers
|
|
- `{if-standalone}` ... `{/if-standalone}` → Keep the content inside
|
|
|
|
## Customization Conditionals
|
|
|
|
### When Customization Is Opted In
|
|
|
|
- `{if-customizable}` ... `{/if-customizable}` → Keep the content inside; emit `customize.toml` alongside SKILL.md.
|
|
- Lifted configurable scalars are referenced in SKILL.md body as `{workflow.<name>}` (e.g. `{workflow.brief_template}`). These are resolved at runtime by the resolver, not at build time — emit them verbatim.
|
|
|
|
### When Customization Is Not Opted In
|
|
|
|
- `{if-customizable}` ... `{/if-customizable}` → Remove the entire block including markers.
|
|
- Do NOT emit `customize.toml`. Use hardcoded paths and values in SKILL.md throughout.
|
|
|
|
## Beyond the Template
|
|
|
|
The builder determines the rest of the skill structure — body sections, phases, stages, scripts, external skills, headless mode, role guidance — based on the skill type classification and requirements gathered during the build process. The template intentionally does not prescribe these; the builder has the context to craft them.
|
|
|
|
## Path References
|
|
|
|
All generated skills use paths relative to skill root (cross-directory) or `./` (same-folder):
|
|
|
|
- `references/{reference}.md` — Reference documents loaded on demand
|
|
- `references/{stage}.md` — Stage prompts (complex workflows)
|
|
- `scripts/` — Python/shell scripts for deterministic operations
|