convez.ai
SkillAutomaçãoAvançado
chunpaiyang

Flywheel

chunpaiyang/flywheel

Workflow toolkit que fixa skills, não código, em ciclos autocompositivos

Ver no GitHub
InicialPluginScore · de 0 a 100

Kit de workflow auto-composto para Claude Code que trata skills como fonte de verdade, não código. Integra swarm (execução autônoma), lens (verificação adversarial), postmortem (diagnóstico de falhas em skills) e tend (manutenção da biblioteca de regras). Cada ciclo reforça o sistema: bugs são fixados na camada de skills para nunca mais reaparecerem.

Instalação

$npx convez-ai chunpaiyang/flywheel

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
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Diagnóstico e correção de falhas em camada de skills em vez de código
  • Execução autônoma de tarefas com garantia de contexto limpo via swarm
  • Verificação adversarial de raciocínio com sub-agentes especializados
  • Manutenção estrutural de bibliotecas de regras crescentes

Veredito

Ferramenta filosóffica e técnica para times que entendem que em workflows com LLM o gargalo é o skill layer, não a codificação. Exige mentalidade diferente, mas resolve a classe inteira de bugs iterativamente — ideal para sistemas que precisam evoluir sem degradação.

README

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

Flywheel

In the LLM era, you fix the skill, not the code. A self-compounding workflow toolkit for Claude Code.


The shift

Traditional development treats code as the source of truth. Bugs are fixed in code; quality is gated by human code review.

Flywheel treats skills and plugins as the source of truth. Code is a downstream artifact, regenerated whenever the skill set is correct enough. When something goes wrong, the fix lands at the skill layer — not the code layer — so the same class of bug never reappears.

Each rotation of the wheel adds mass: the plugins absorb every imperfection back into themselves and grow.

        ┌──────────── swarm ────────────┐
        │  autonomous task execution    │
        ▼                               │
   produce code                         │
        │                               │
        ▼                               │
   ┌─ lens ─────────────────────────────┤
   │  adversarial verification          │
   └─ ▼                                 │
   ┌─ postmortem ───────────────────────┤
   │  blame the skill, not the code     │
   └─ ▼                                 │
   ┌─ tend ─────────────────────────────┘
      keep the wheel clean as it grows

The faster it spins, the heavier it gets, the harder it is to stop.


The four plugins

PluginRole on the wheel
swarmPush — coarse-grained authorization for autonomous, end-to-end task execution. Sub-agents carry context-polluting work; main session reports only on completion.
lensCalibration — epistemic primitives (/confirm, /think, /know, …) that break the single-context reasoning ceiling with adversarial dispatched sub-agents.
postmortemDiagnosis — given a transcript + symptom, identifies which skill's declared contract was violated. Blame lives at the skill layer.
tendMaintenance — lints the rule library for structural drift (file size, broken links, orphans, missing sections). Lets the wheel grow without warping.

When to use which

bug spotted ────►  log it as a working job under your scratch dir
                            │
                            ▼
                    is the cause clear?
                  ┌─────yes─┴─no─┐
                  ▼              ▼
            /swarm:oneshot   is it UI/UX?
                              ┌─yes─┴─no─┐
                              ▼          ▼
                         /swarm:pitch  /lens:confirm
                              │          │
                              └────┬─────┘
                                   ▼
                          /swarm:oneshot

skill misbehaved during the run? ──► /postmortem:postmortem
plugin/skill library drifted?    ──► /tend:tend

Quickstart

/plugin marketplace add chunpaiyang/flywheel
/plugin install swarm@flywheel
/plugin install lens@flywheel
/plugin install tend@flywheel
/plugin install postmortem@flywheel

Then try:

/swarm:oneshot fix the failing test in src/foo.ts and commit when green

If anything misbehaves, run /postmortem:postmortem against the session transcript — the blame will land on a specific skill, not on the code. Fix the skill, push, and the next rotation runs cleaner.


Philosophy

  • Speed beats rigor at the moment — errors are caught by the next rotation, not by upfront review.
  • Skills are versioned; code is regenerated. Energy goes into improving the wheel, not babysitting individual outputs.
  • Knowledge compounds. Every imperfection found becomes mass on the wheel — the system is harder to derail tomorrow than it was today.

Layout

This repo is a meta-marketplace — it does not contain plugin source. Each plugin lives in its own repo and evolves independently. The four plugins are referenced by GitHub source in .claude-plugin/marketplace.json.

Ver o original no GitHub

Bom para

Relacionados