vidispinevidispine/hull/llms.txt

hull

llms.txt295 starsChanged 12 days agoApache-2.0View on GitHub

HULL (Helm Uniform Layer Library) is a Helm library chart. A HULL based chart defines all its Kubernetes objects as data in values.yaml under hull.objects.<type>.<key>, validated by a JSON schema, and needs no templates of its own. HULL derives names, labels and selectors, turns named arrays into dictionaries and offers transformations (_HT*, _HT!, ...) for computed values. Start with the guide for AI agents, it covers the rules, the workflow and the transformations on one page. The links point to…

We split this llms.txt into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Start with the guide for AI agents, it covers the rules, the workflow and the transformations on one page.
line 5

≈ “Common” is an estimate: at least 1 in 5 of the 3,225 llms.txt files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

llms.txt

# HULL

> HULL (Helm Uniform Layer Library) is a Helm library chart. A HULL based chart defines all its Kubernetes objects as data in values.yaml under hull.objects.<type>.<key>, validated by a JSON schema, and needs no templates of its own. HULL derives names, labels and selectors, turns named arrays into dictionaries and offers transformations (_HT*, _HT!, ...) for computed values.

Start with the guide for AI agents, it covers the rules, the workflow and the transformations on one page. The links point to the main branch, which holds the latest release; the documentation of each HULL release is on its release-1.<minor> branch.

## Docs

- [HULL for AI agents](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/agents.md): the rules that differ from Kubernetes YAML, the write-check-fix workflow, transformations, kind mapping and common mistakes
- [Cookbook](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/cookbook.md): tested recipes for common tasks, from a web application to hooks, RBAC and storage
- [Error codes](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/error_codes.md): every HULL rendering error code with its cause and fix
- [Importing charts](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/import.md): hull_import.py converts helm template output into HULL values and verifies the result
- [Tools for AI agents](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/agent_tools.md): the Claude Code plugin, the MCP server and hull_validate.py
- [Transformations](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/transformations.md): _HT*, _HT!, _HT?, _HT^, _HT&, _HT/ in detail
- [Chart design](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/chart_design.md): defaults, sources, conditionals and ordering of array elements
- [Objects API](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/API/hull_objects_.md): the object types and their HULL properties
- [Pods and containers](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/API/hull_objects_pod.md): pod templates, containers, images, env, volumes
- [ConfigMaps and Secrets](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/API/hull_objects_configmaps_secrets.md): inline and file based data
- [Global configuration](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/API/hull_config.md): hull.config.general settings

## Optional

- [README](https://raw.githubusercontent.com/vidispine/hull/main/README.md): introduction and examples
- [Setup](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/setup.md): adding HULL to a chart
- [Error checking](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/error_checking.md): switching error checks on and off
- [JSON schema validation](https://raw.githubusercontent.com/vidispine/hull/main/hull/files/doc/json_schema_validation.md): schema validation in IDEs
- [values.schema.json](https://raw.githubusercontent.com/vidispine/hull/main/hull/values.schema.json): the schema itself, large; query it with jq instead of reading it, see the agent guide

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free