convez.ai
Skill
SONGYEONGSIN

vibe-flow

SONGYEONGSIN/vibe-flow

Ver no GitHub
InicialPluginScore · de 0 a 100

Self-evolving Claude Code workflow kit — 44 skills, 22 agents, 29 hooks. /plugin install vibe-flow. Karpathy principles, TDD strict, audit cycle 3.0→4.53/5.

Instalação

$npx convez-ai SONGYEONGSIN/vibe-flow

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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 17 horas
Versão
v2.6.0
Issues abertas
1
Contribuidores
2

README

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

English | 한국어

vibe-flow

A vibe coder's workflow — from novice to senior, enforced mechanically

CI Skills Extensions Hooks Agents License

⚡ 30-second start

Option A — Claude Code plugin marketplace (recommended):

/plugin marketplace add https://github.com/SONGYEONGSIN/vibe-flow
/plugin install vibe-flow

Option B — Manual setup:

git clone https://github.com/SONGYEONGSIN/vibe-flow.git
cd /your/project
bash /path/to/vibe-flow/setup.sh

→ 44 skills + 22 agents + 29 hooks + 7 rules are activated immediately.

🎯 First cycle (5 minutes)

claude
> /brainstorm "add user authentication"  # explore intent (4 questions + 2 alternatives)
> /plan from-brainstorm <file>            # break into steps
# ...write code...
> /verify                                 # lint + tsc + test
> /commit                                 # Conventional commit
> /finish                                 # PR/merge decision tree

🎬 What it actually does

$ /brainstorm "add password reset flow"
  → 4 questions: 무엇/누가/왜 지금/성공 기준
  → 2 alternatives compared (e.g. magic link vs OTP)
  → spec saved to .claude/memory/brainstorms/20260606-...-password-reset.md

$ /plan from-brainstorm .claude/memory/brainstorms/...md
  → 6 steps decomposed (T1~T6) with HARD-GATE level
  → plan_created event → .claude/events.jsonl

$ /verify
  ✓ lint (eslint, prettier)
  ✓ typecheck (tsc --noEmit)
  ✓ test (vitest)
  ✓ no console.log / any / @ts-ignore (rules/donts.md)
  ✓ browser console clean (Playwright)

$ /commit
  → Conventional Commit auto-generated:
    "feat(auth): password reset via email OTP — TTL 10min"

$ /finish
  → decision tree: PR | direct merge | release | cleanup
  → branch state, test status, plan completion 모두 점검 후 안내

[session ends] →
  💡 학습 저장 권장 (활동 신호 감지):
    - /learn save pattern "<password reset pattern>"

Hooks 가 매 Write/Edit 후 자동 검증 — /verify 안 돌려도 prettier/eslint/typecheck/test/design-lint/security-lint 모두 실시간. TDD strict 모드 — 테스트 없이 코드 수정 차단.

Generate your own demo GIF:

# install asciinema (recommended) or terminalizer
brew install asciinema
asciinema rec demo.cast --command "claude"
# ...run a real cycle...
# upload to asciinema.org and link in your PR / docs

📦 Core skills — default install

CategorySkills
Cycle/brainstorm /plan /finish /release
Tasks/scaffold /test /worktree
Verify/verify /security /perf-audit
Git/commit /review-pr /receive-review
Meta/status /learn /onboard /menu /inbox /budget /telemetry

Full command reference → docs/REFERENCE.md

🔌 Extensions (7) — opt-in

bash setup.sh --list-extensions       # show available
bash setup.sh --extensions <name>     # add one
bash setup.sh --all                   # install all
ExtensionPurpose
meta-qualitymeasure skill quality + self-evolve (/eval, /evolve)
design-systemmatch reference designs to code quantitatively (/design-sync, /design-audit)
deep-collaborationBuilder/Validator pair, structured debate (/pair, /discuss)
learning-looplong-term metrics, retrospectives (/metrics, /retrospective)
code-feedbackgit-diff-based quality analysis (/feedback)
i18ndetect missing / unused translation keys (/i18n-audit)
k8sk8s manifest 5 anti-pattern audit (/k8s-audit)

Each extension → extensions/

🔧 CI templates (opt-in)

templates/.github/workflows/ provides 4 stack-agnostic GitHub Actions:

FileRole
verify.ymllint + typecheck + test (npm/yarn/pnpm auto-detected)
eval-regression.ymlregression check on your SKILL.md / agents.md / evals.json structure
security.ymlnpm audit + secret pattern grep + OWASP-style static grep (warn-only by default)
perf.ymlLighthouse perf check (workflow_dispatch or weekly schedule, warning on threshold miss)
# copy into your project (manual, opt-in)
mkdir -p .github/workflows
cp /path/to/vibe-flow/templates/.github/workflows/*.yml .github/workflows/

→ templates/.github/workflows/

🚀 Learning path

Day 1     → Core 6 (brainstorm, commit, verify, finish, status, learn)
Day 3     → + plan, test, security
Week 1    → + scaffold, worktree, review-pr, receive-review, release
Month 1   → enable extensions (meta-quality / learning-loop etc.)

Step-by-step guide → docs/ONBOARDING.md

📐 Architecture

brainstorm → plan → implement → verify → commit → finish → release
   │                            │                   │
   ↓                            ↓                   ↓
 memory ─────────────────  events.jsonl ─────  retrospective
                                  ↓
                        /eval → /evolve (extensions/meta-quality)

Data flow → docs/ARCHITECTURE.md

🤝 Agent delegation (22)

@developer, @qa, @security, @validator, @planner, @feedback, @moderator, @comparator, @designer, @retrospective, plus domain specialists (@api-architect, @frontend-design-specialist, @security-specialist, @performance-optimizer, @supabase-db-specialist, @devops-engineer, @product-strategist, @ux-researcher, @architecture-reviewer, @technical-writer, @test-writer, @project-planner)

  • extensions: @skill-reviewer, @grader

🛠 Automatic enforcement (29 hooks)

Runs without /verify:

  • every Write/Edit → prettier, eslint, typecheck, test, design-lint
  • TDD strict — code edits without a test are blocked
  • 27 dangerous-command patterns blocked (git push --force, rm -rf /, ...)
  • metrics auto-collected (events.jsonl + SQLite + JSON)

🆙 Upgrade

cd /path/to/vibe-flow && git pull
cd /your/project && bash /path/to/vibe-flow/setup.sh
# → user edits auto-backed up to .bak, extension state preserved

📚 Further reading

Credits

The core principles in this build mechanically enforce patterns from:

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados