convez.ai
SkillAutomaçãoAvançado
dikshant-goforsys

Mixture — Framework de Skills e Agents para Claude Code

dikshant-goforsys/mixture

Framework layered para skills + agents no Claude Code, despojado por design

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework minimalista e intencional para construir skills reutilizáveis e agents coordenados no Claude Code. Implementa 4 camadas de abstração (substrato, kernel comportamental, catálogo de skills, plano de governança) com foco em composabilidade, clareza e rejeição deliberada de bloat. Vem com ~30 skills máximo e ferramenta CLI para instalação.

Instalação

$npx convez-ai dikshant-goforsys/mixture

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Estruturar agent systems que escalam sem se perder em complexidade
  • Criar skills reutilizáveis validadas com evals de primeira classe
  • Coordenar múltiplos agents em tarefas complexas com ledger de transações e locks
  • Instalar e gerenciar skills via profiles de ambiente sem overhead de configuração

Veredito

Mixture é arquitetura séria para quem leva agent systems a sério — rejeita a tentação do crescimento ilimitado e força disciplina em cada camada. Excelente para times que querem infraestrutura de agents sem reinventar a roda ou herdar bloat de outros projetos.

README

A tradução para o português deste README ainda está na fila.

Mixture

A deliberately-small, layered skills + agents framework for Claude Code. Synthesized from the best ideas of four prior systems — and disciplined by the worst lessons of each.

Mixture is not another sprawling catalog. Its defining feature is what it refuses to become. It takes the highest-value ideas from four projects and stacks them as four altitudes of one system:

LayerConcernSourced fromThe lesson taken
L0 SubstrateThe SKILL.md spec itselfanthropics/skillsDon't reinvent the format. Build on it.
L1 Behavioral kernelHow one agent writes codeandrej-karpathy-skillsSteal the mechanisms, not the prose bulk.
L2 Skill catalog + authoring standardReusable units of know-howmattpocock/skillsSmall on purpose. Curation is the product.
L3 Governance planeInstall profiles, hooks, memoryaffaan-m/ECCBorrow patterns, reject the bloat.
L4 Coordination planeMany agents over timepaperclipai/paperclipHeartbeat, locks, DAGs, budgets — deferred until earned.

The governing constraint

Matt Pocock's curation philosophy governs every layer: small, composable, model-agnostic, hackable, and anti-framework (it never takes control away from you). Every other idea is admitted only if it survives that constraint. The cap is intentional: ~30 shipped skills, ever. Volume is the disease.

Status & sequencing

This repo builds bottom-up. L4 is specified, not implemented — building orchestration before you have a real fleet of agents to coordinate is the #1 documented failure mode (see docs/premortem.md).

  • ✅ Phase 1 (now): L0–L2 — the kernel skill, the write-a-skill quality gate, exemplar skills, validation.
  • ✅ Phase 2: L3 — profiles, env-governed hooks (resolve-hooks), memory lifecycle, CI gate, ECC-derived references.
  • ✅ Phase 3 (built ahead of gate — ADR-0003): L4 — tested ledger substrate (28 invariant tests) + coordination-protocol skill, validated live by the 2-agent dispatch demo and the 20-process / 4-agent high-contention test (no double-work, CONFLICT/no-retry honored). See coordination/README.md + coordination/DEMO.md. Future (only when you run a real fleet): cross-session heartbeat persistence + a sustained soak.

Layout

bin/mixture.mjs                   # the `npx mixture` installer CLI
.claude-plugin/plugin.json        # manifest (L0)
skills/
  kernel/coding-behavior/         # L1 — the ONE behavioral skill
  meta/write-a-skill/             # L2 — the authoring quality gate
  engineering/{grill-me,diagnose} # L2 — exemplars that set the standard
  in-progress/ deprecated/        # hidden buckets (not shipped)
manifests/install-profiles.json   # L3
hooks/                            # L3 — minimal + CI-validated
coordination/                     # L4 — tested ledger + invariants + CLI + heartbeat runtime
evals/                            # FIRST-CLASS. No skill ships without one.
scripts/validate-frontmatter.mjs  # enforce-in-code what prose can't guarantee
docs/{architecture,premortem,roadmap,coordination-plane.spec}.md
docs/adr/                         # we dogfood our own discipline
CONTEXT.md                        # domain glossary (dogfood)

Quick start

Use it in another project (installer CLI — see how-to-use.md):

npx mixture-skills install --profile dev                              # skills into .claude/skills
npx mixture-skills install --profile full --with-memory --memory-backend sqlite
npx mixture-skills install --profile mobile --with-agents             # RN device QA + project subagents
npx mixture-skills list | doctor                                      # profiles / what's installed
# (or pin from source: `npx github:dikshant-goforsys/mixture install …`)

Upgrade an existing install — re-run your install command with @latest + --force (replaces skills and .mixture/framework/* runtimes; your memory store and task ledger are untouched):

npx mixture-skills@latest install --profile full --with-memory --memory-backend sqlite --with-coordination --force
npx mixture-skills@latest doctor    # verify, then restart Claude Code (or /reload-skills)

Develop the framework itself:

npm run ci                              # full gate: routing contracts + catalog drift + hooks + L4 tests
node scripts/resolve-hooks.mjs --explain   # see which hooks are active for your MIXTURE_HOOK_PROFILE

See docs/architecture.md for the full design and exactly what was taken from each source repo.

Ver o original no GitHub

Bom para

Relacionados