alef-workflow

How to work with Alef-generated binding files and the task commands that regenerate, build, format, and verify them. Load when editing bindings, running task alef:*, or regenerating generated packages/e2e suites.

Jump to install

Repository: xberg-io/agent-conventions
Last source activity: July 22, 2026 at 15:14
Detected SKILL.md language: English
Stars: 7
Forks: 2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/xberg-io/agent-conventions --skill alef-workflow

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

xberg-brand-and-docs

Canonical xberg.io brand, product catalog, docs-site (Astro Starlight + @xberg-io/docs-theme), alef badge, docs task commands, prose style, Google Analytics IDs, brand assets, and README-template policy. Load when writing READMEs or docs, editing docs-site config, adding the ecosystem block or alef badge, or touching brand/analytics wiring.

2026-07-31

feature-flag-conventions

The shared Cargo feature-flag naming and semantics contract across xberg-io Rust libraries — the same flag names mean the same thing everywhere (otel, mcp/mcp-http, mimalloc/jemalloc, acceleration). Load when adding, renaming, or reviewing a crate's [features], or reconciling a library's flags with the rest of the stack.

2026-07-30

tracing-conventions

The canonical contract for tracing as a first-class product observability surface across xberg-io Rust libraries and services — level semantics, span/field naming, instrumentation patterns, and how xberg-enterprise consumes library spans over OTLP. Load when adding or reviewing tracing instrumentation, designing spans/events, wiring a subscriber, or reconciling observability features.

2026-07-30

View all from this repository

name	alef-workflow
description	How to work with Alef-generated binding files and the task commands that regenerate, build, format, and verify them. Load when editing bindings, running task alef:*, or regenerating generated packages/e2e suites.

Alef Workflow

Treat Alef-managed binding files as generated output. Change Rust source, README templates, fixtures, or alef.toml instead of hand-editing generated packages.
Use task alef:generate for fast regeneration. It must run alef all --clean.
Do not compile bindings or run verification from task alef:generate.
Use task alef:build or task build:bindings when binding compilation is needed; use task build:all for core plus bindings.
Use task format or poly fmt --fix . for repository formatting; formatting is handled solely by poly (there is no separate Alef formatting task).
Generated e2e suites use canonical tasks: task e2e:generate, task e2e:build, task e2e:test, and task e2e:all. Do not add legacy aliases.
Commit generator inputs and regenerated output together.

alef-workflow

Source facts

Install options

Review the source files

More from this repository

More from this repository

Alef Workflow

Alef Workflow