convez.ai
SkillDesenvolvimento WebIntermediário
BainaryTD

Bainary Skill

BainaryTD/bainary-skill

Skill que aprende seu projeto e gera código alinhado com seus padrões

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill foundacional para desenvolvimento web que aprende o contexto do seu projeto antes de gerar código. Captura padrões de estilo e mantém conhecimento entre sessões, funcionando com múltiplas CLIs de IA (Claude, Cursor, Codex, Grok). Implementa princípios de Karpathy como análise antes da codificação e mudanças cirúrgicas.

Instalação

$npx convez-ai BainaryTD/bainary-skill

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á 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Manter consistência de código entre múltiplas sessões de IA
  • Acelerar desenvolvimento web capturando padrões existentes
  • Documentar contexto do projeto para handoff entre diferentes CLIs de IA

Veredito

Skill bem-arquitetado para Windows/macOS/Linux que resolve o problema real de manter contexto entre sessões de IA. Implementação sólida com suporte multiplataforma, embora requeira familiaridade com CLI para máximo proveito.

README

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

bainary-skill

Web Development Base Skill with Project Learning & Multi-CLI Support

License: MIT Version


What is bainary-skill?

bainary-skill เป็น foundational skill สำหรับ web development ที่:

  • 🧠 เรียนรู้ project ของคุณ ก่อน generate code ทุกครั้ง
  • 🎨 จับ project style/code patterns จาก codebase จริงในแชทแรก
  • 🔄 รักษา knowledge ข้ามหลาย session
  • 🧾 บันทึก session handoff หลังคุยกับ AI เสร็จ เพื่อเปิดแชทใหม่แล้วต่อเนื่อง
  • 🤖 รองรับทุก AI CLI — Claude Code, Cursor, Codex, Grok, Aider

สร้างบน Karpathy's core principles:

Principleความหมาย
Think Before Codingวิเคราะห์และวางแผนก่อนเขียนโค้ด
Simplicity Firstเลือก solution ที่ง่ายและ maintain ได้
Surgical Changesแก้แค่ที่จำเป็น ไม่แตะโค้ดที่ไม่เกี่ยว
Goal-Driven Executionทุก change ต้องมี verifiable goal

Installation

🪟 Windows — ไม่ต้องใช้ WSL หรือ bash

CMD.exe

Project-local install (เฉพาะ project นั้น):

cd your-project
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.cmd -OutFile install.cmd; .\install.cmd --local"

ใช้งาน:

.\bin\bainary-skill.cmd learn
.\bin\bainary-skill.cmd update
.\bin\bainary-skill.cmd status

PowerShell

Global install (ใช้ได้ทุก project):

irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 | iex

Project-local install (เฉพาะ project นั้น):

cd your-project
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 -OutFile install.ps1
.\install.ps1 -Local

ใช้งาน (หลัง global install):

bainary-skill learn
bainary-skill update
bainary-skill status

ใช้งาน (project-local):

.\bin\bainary-skill.cmd learn
# หรือถ้ามี package.json:
npm run bainary -- learn

🐧 macOS / Linux (bash)

🌍 Global Install (แนะนำสำหรับใช้ข้าม project)

curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash

ใช้ได้ทุกที่ในเครื่อง:

bainary-skill learn
bainary-skill update
bainary-skill status

📁 Project-Local Install (เฉพาะ project นั้น)

cd your-project
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash -s -- --local

ติดตั้งที่ ./bin/bainary-skill และ auto-add npm script (ถ้ามี package.json):

./bin/bainary-skill learn

# หรือถ้ามี package.json:
npm run bainary -- learn

ทำไมต้อง project-local?

  • ไม่ต้องติดตั้ง global บนทุกเครื่อง
  • แต่ละ project ใช้ version ที่ตัวเองต้องการได้
  • ทำงานได้ใน CI/CD โดยไม่ต้อง pre-install

⚡ npx (ไม่ต้อง install เลย)

npx github:BainaryTD/bainary-skill learn

Quick Start

1. ติดตั้ง

Windows CMD.exe:

# Project-local
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.cmd -OutFile install.cmd; .\install.cmd --local"

Windows PowerShell:

# Global
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 | iex

# หรือ project-local
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 -OutFile install.ps1
.\install.ps1 -Local

macOS / Linux:

# Global
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash

# หรือ project-local
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash -s -- --local

2. Initialize project

cd your-web-project
bainary-skill learn        # หรือ ./bin/bainary-skill learn (project-local)

3. กรอก knowledge files / ให้ AI เรียนรู้ project style

.bainary/
├── project-knowledge.md   ← อธิบาย project ของคุณ
├── session-handoff.md     ← สรุปแชทล่าสุด + next steps เพื่อเปิดแชทใหม่ต่อเนื่อง
├── architecture.md        ← key design decisions
├── patterns.md            ← code patterns ที่ใช้
└── conventions.md         ← naming & folder rules

ในแชทแรกของ AI ให้ใช้ prompt นี้ก่อนสั่งเขียนโค้ด:

Read .bainary/project-knowledge.md, .bainary/session-handoff.md,
.bainary/architecture.md, .bainary/patterns.md, and .bainary/conventions.md.
Then inspect the existing source code to learn this project's coding style,
folder structure, naming conventions, component/API patterns, testing style,
and dependencies. Update .bainary/patterns.md, .bainary/conventions.md,
and .bainary/project-knowledge.md with missing findings before coding.

ก่อนจบแชทกับ AI ให้ใช้ prompt นี้:

Before finishing, update .bainary/session-handoff.md with the current focus,
what changed, decisions made, files touched, risks, and next steps. Move any
stable new style/convention/pattern knowledge into .bainary/patterns.md,
.bainary/conventions.md, or .bainary/architecture.md so the next AI chat can continue.

4. เปิด AI CLI แล้วเริ่มโค้ดได้เลย

claude        # Claude Code
codex         # Codex
cursor .      # Cursor IDE
aider         # Aider

CLI Commands

CommandDescription
bainary-skill learnสร้าง .bainary/ + session-handoff.md + ติดตั้ง CLI instruction files
bainary-skill updateRefresh CLI files จาก latest skill version
bainary-skill statusแสดงสถานะ knowledge files และ CLI files
bainary-skill installติดตั้งใหม่ (project-local)
bainary-skill install --globalติดตั้งใหม่แบบ global

Supported AI CLIs

CLIFile ที่ติดตั้งStatus
Claude CodeCLAUDE.md✅
Cursor.cursorrules + CURSOR.md✅
CodexAGENTS.md✅
GrokAGENTS.md✅
AiderCONVENTIONS.md✅

Project Knowledge System

หลังจาก bainary-skill learn project จะมี .bainary/ directory:

.bainary/
├── project-knowledge.md   # Overview, tech stack, entry points
├── session-handoff.md     # Last chat summary, decisions, risks, next steps
├── architecture.md        # Architecture decisions + data flow
├── patterns.md            # Code patterns (fetching, state, forms ฯลฯ)
└── conventions.md         # Naming, folder structure, commit style

AI CLI ทุกตัวจะอ่านไฟล์เหล่านี้ก่อนเขียนโค้ด — ทำให้ AI เข้าใจ project context ของคุณ

Continuity Loop

  1. เริ่มโปรเจกต์ / เปิดแชทใหม่: ให้ AI อ่าน .bainary/ ทั้งหมดก่อน
  2. ถ้า style ยังว่าง: ให้ AI inspect codebase แล้วเติม patterns.md + conventions.md
  3. ระหว่างทำงาน: ถ้ามี decision หรือ pattern ใหม่ ให้บันทึกใน .bainary/
  4. ก่อนจบแชท: ให้ AI update session-handoff.md เพื่อให้แชทถัดไปต่อได้ทันที

Repository Structure

bainary-skill/
├── SKILL.md                        # Hermes skill definition
├── README.md                       # This file
├── CHANGELOG.md                    # Version history
├── package.json                    # npm/npx support
├── install.sh                      # Installer (macOS/Linux/WSL)
├── install.ps1                     # Installer (Windows PowerShell)
├── install.cmd                     # Installer wrapper (Windows CMD.exe)
│
├── scripts/
│   ├── bainary-skill               # CLI script (bash)
│   └── bainary-skill.ps1           # CLI script (PowerShell / Windows)
│
├── adapters/                       # Per-CLI instruction files
│   ├── claude/CLAUDE.md
│   ├── cursor/.cursorrules
│   ├── cursor/CURSOR.md
│   ├── codex/AGENTS.md
│   ├── grok/AGENTS.md
│   ├── aider/CONVENTIONS.md
│   └── web-project/README.md
│
└── templates/
    ├── .bainary/                   # Project knowledge templates
    │   ├── project-knowledge.md
    │   ├── session-handoff.md
    │   ├── architecture.md
    │   ├── patterns.md
    │   └── conventions.md
    └── web-project/               # Web project starter files
        ├── package.json
        └── .gitignore

License

MIT © Bainary

Ver o original no GitHub

Bom para

Relacionados