No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-06 23:00:11 +02:00
.claude-plugin Dry run, forge channel, first prod user, SPL working copy (0.1.4) 2026-10-01 17:38:12 +03:00
skills Skills: splent_catalog and spl:migrate-catalog are gone 2026-10-06 23:00:11 +02:00
.gitignore feat: splent Claude Code plugin (skills + marketplace) 2026-06-27 19:51:05 +02:00
LICENSE feat: splent Claude Code plugin (skills + marketplace) 2026-06-27 19:51:05 +02:00
README.md Point the plugin at git.splent.io and drop splent_catalog (0.1.2) 2026-10-01 09:13:34 +03:00

splent — Claude Code plugin for the SPLENT product line

Work at SPLENT speed. This plugin teaches Claude Code how SPLENT is built — features, products, the SPL/UVL model, per-feature migrations, the feature contract — and gives it skills that drive the splent CLI for you.

The splent CLI already automates the mechanics (scaffolding, env merge, symlinks, migrations, derive, release). This plugin adds the judgment: writing idiomatic feature code and tests, knowing which command to run in which order, and recovering when something breaks.

Install

/plugin marketplace add https://git.splent.io/splent-io/splent_claude.git
/plugin install splent@diverso-lab

The plugin lives on SPLENT's own forge, git.splent.io (SSH on port 2223), so the marketplace is added by its full git URL — the owner/repo shorthand only resolves against GitHub.

That's it. No per-project config. Works in any SPLENT workspace (a folder containing splent_cli, splent_framework and your products; SPL models are working copies splent_spl_<name>/ or cached under .splent_cache/spls/).

To update later: /plugin marketplace update diverso-lab then reinstall.

What you get

Skill Invoke What it does
feature /splent:feature <description> Author a feature end-to-end: scaffold → write models/services/routes/templates/hooks + tests → add to the SPL → install into the product → migrate → verify.
product /splent:product <what you want> Create, configure, derive, seed and run a product — or onboard an existing one. Picks the right path from the current state.
doctor /splent:doctor [symptom] Diagnose and fix: failing derive, UVL unsatisfiable, broken migrations, missing features, symlink/cache/env/Docker issues.
conventions (automatic) Always-on SPLENT knowledge. Claude consults it whenever you work in a SPLENT codebase, so generated code follows the real patterns.

You don't have to use the slash commands — just describe what you want ("add a notes feature with title and body owned by the user") and Claude will pick up the right skill automatically.

How it runs the CLI

splent lives inside the splent_cli_container Docker container, with the workspace bind-mounted at /workspace. The skills detect this and call docker exec splent_cli_container splent … from the host (or splent … directly if you're already inside the container). Files are edited on the host; the same files are mounted in the container.

Design principles

  • The CLI is the source of truth. Skills drive splent commands and never hand-edit pyproject feature lists, the UVL model, or migration version tables.
  • Confirm before trusting. Skills check exact flags with --help at runtime, so they survive CLI version changes.
  • Simplicity first. Sensible defaults, minimal questions, "it just works."

Layout

splent_claude/
├── .claude-plugin/
│   ├── plugin.json          # plugin manifest
│   └── marketplace.json     # marketplace listing (diverso-lab)
└── skills/
    ├── conventions/         # always-on framework knowledge + deep reference/
    ├── feature/             # author a feature end-to-end
    ├── product/             # set up & run a product
    └── doctor/              # diagnose & fix

License

Creative Commons CC BY 4.0 — SPLENT — Diverso Lab.