convez.ai
SkillAutomaçãoIntermediário
babiskon

kickoff

babiskon/kickoff

Gate de definition-of-done e geração automática de CLAUDE.md para projetos

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill do Claude Code que enforça uma porta de definição de done antes de começar qualquer projeto, realiza intake estruturado e gera CLAUDE.md pronto para contexto completo. Funciona para projetos novos e para documentar codebases existentes.

Instalação

$npx convez-ai babiskon/kickoff

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

  • Iniciar novos projetos com escopo claro e decisões abertas rastreadas
  • Documentar projetos existentes com arquivo CLAUDE.md contextual
  • Alinhar objetivos de sessão antes de escrever código
  • Configurar ambientes (venv, package.json) com intake estruturado

Veredito

Ferramenta sólida que resolve um problema real: projetos de IA que começam sem definição de done clara. O intake estruturado com deferimento de decisões abertas é diferencial. Útil para times que querem metodologia repeatable em sessões com Claude.

README

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

kickoff — Claude Code skill for project scaffolding & CLAUDE.md generation

Lock in your definition of done before a single line of code is written.

kickoff is a Claude Code plugin that runs a structured project intake, asks 7 high-impact questions, and generates a ready-to-go CLAUDE.md so Claude has full context from session one. Works for new projects and for documenting existing codebases.


Why kickoff?

Most AI coding sessions drift because the goal was never clearly defined. kickoff enforces a definition-of-done gate: Claude cannot proceed until you've answered what "done" looks like, concretely and verifiably. The output is a CLAUDE.md that travels with your project and makes every future Claude session faster and more accurate.

It also introduces an Open Decisions pattern: anything you're not sure about gets deferred into a checklist rather than silently guessed. Claude resurfaces those decisions at the start of every session until they're resolved.


What it does

  • Asks 7 focused intake questions — definition of done first, always
  • Defers unknowns into an Open Decisions checklist so ambiguity is tracked, not hidden
  • Proposes a scoped Session 1 goal before writing any code
  • For existing projects: scans the codebase first and pre-fills what it can; shows diffs before overwriting
  • Generates a CLAUDE.md with type-specific sections for: data analysis, ML, web app/dashboard, automation, MCP server, API/backend, CLI, GAS/Sheets
  • Optionally sets up Python venv or Node package.json
  • Optional: initializes OpenWolf memory if installed
  • Optional: creates an Obsidian project index if the Obsidian MCP is available

Install

# Step 1 — add the kickoff marketplace
/plugin marketplace add babiskon/kickoff

# Step 2 — install the kickoff plugin
/plugin install kickoff@kickoff

Usage

Just describe what you're building — kickoff activates automatically:

"let's start a new project from scratch"
"I need to build a data pipeline"
"kick off a new Python script"
"spin up a Streamlit dashboard"
"add CLAUDE.md to this existing repo"
"document this project for Claude"
"set it up properly from the start"

You'll be walked through 7 questions, then Claude writes the CLAUDE.md and optionally sets up your environment.


Example session

You: let's start a new project from scratch

Claude: What does "done" look like for this project?
        Be specific: what output exists, where does it go, and how do we know it works?

You: a Python script that reads a CSV, runs some analysis, and writes a summary to Google Sheets

Claude: Got it. Now a few more questions:
        2. Project name?
        3. Type: (a) data analysis...
        ...

[after answers]

Claude: Here's what I suggest we accomplish today: a working script that reads the
        CSV and prints a summary to stdout — no Sheets integration yet.
        Does that sound right?

You: yes

Claude: [creates ~/projects/my_analysis/, writes CLAUDE.md, sets up venv]
        Done. CLAUDE.md written. Open Decisions: 0.
        Suggest: open the folder in your IDE and point the interpreter at venv/.

Requirements

  • Claude Code (any version)
  • No external services required for core functionality
  • Python venv setup requires Python 3.x
  • Node.js setup requires Node.js
  • OpenWolf integration requires the openwolf CLI (optional)
  • Obsidian integration requires the Obsidian MCP server (optional)

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados