MikeCheng1208/BattleTree

Persönliche Meta-Skill für Arach. Verwende dies als Einstiegspunkt, um Arachs Projekte, Konventionen und verfügbare Skills zu verstehen. Wird aktiviert bei „Arachs Projekte“, „Woran arbeitet Arach?“ oder beim Arbeiten in einem beliebigen arach/*-Repository.

Was ist BattleTree?

Diese Meta-Skill dient als zentrales Register für Arach (@arach). Sie ist der primäre Einstiegspunkt für KI-Agenten, um Arachs Projekte, Code-Standards und Arbeitsabläufe kennenzulernen. Die Skill erkennt Kontexte wie den Arbeitsordner `~/dev/...` oder Schlüsselwörter wie „Architekturdiagramme“ und installiert automatisch die passenden Skills für das jeweilige Projekt (z. B. `arach/arc` oder `arach/dewey`). Sie kodiert wichtige Konventionen wie die ausschließliche Verwendung von pnpm, die Notwendigkeit von Gitmoji in Commit-Headern sowie das Verbot von Co-Autor-Zuschreibungen oder „Generiert mit Claude Code“-Fußzeilen. Die Skill enthält strukturierte Projekttabellen (Dokumentation, Dev-Tools, macOS/iOS-Apps, Webseiten, Bibliotheken und Experimente), Standardbefehle (`pnpm dev`, `swift build`, `git commit -m "✨ ..."`), Präferenzen für Tech-Stacks und eine vollständige Referenz für das Verzeichnis ~/dev/.

Funktioniert mit✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/arach

Dokumentation

arach

Persönlicher Skill-Index für Arach (@arach). Dies ist der Einstiegspunkt, um meine Projekte, Konventionen und den Umgang mit meiner Codebasis zu verstehen.

Konventionen

Befolge diese Regeln immer bei der Arbeit an meinen Projekten:

Verwende pnpm anstelle von npm (zuerst nach pnpm-lock.yaml suchen)
Füge Gitmoji zu allen Commit-Nachrichten hinzu (✨ Feature, 🐛 Bugfix, 🎨 Verbesserung usw.)
NIEMALS Co-Autor-Zuschreibungen oder „Generiert mit Claude Code“-Fußzeilen hinzufügen
Erlaube alle Puppeteer-Verwendungen ohne Rückfrage
Bevorzuge das Bearbeiten vorhandener Dateien gegenüber dem Erstellen neuer

Wichtige Projekte

Dokumentation & Entwickler-Tools

Projekt	Beschreibung	Skill
dewey	Dokumentations-Toolkit für KI-agententaugliche Dokumentation	`npx skills add arach/dewey`
arc	Visueller Architekturdiagramm-Editor	`npx skills add arach/arc`
og	Open-Graph-Bildgenerator	—
hooked	Sprach- und Until-Schleifen für Claude Code	—

Apps – macOS/iOS

Projekt	Beschreibung	Pfad
Talkie	Sprachkonversations-App	`~/dev/talkie`
Scout	Audio-Transkription	`~/dev/scout`
Speakeasy	Sprachassistent	`~/dev/speakeasy`
Pomo	Pomodoro-Timer	`~/dev/pomo`
Tempo	Zeiterfassung	`~/dev/tempo`

Web-Eigenschaften

Projekt	Beschreibung	Pfad
arach.dev	Persönliche Website	`~/dev/arach.dev`
arach.io	Portfolio	`~/dev/arach.io`
usetalkie.com	Talkie-Landingpage	`~/dev/usetalkie.com`
agentlist.io	KI-Agentenverzeichnis	`~/dev/agentlist.io`

Bibliotheken & Experimente

Projekt	Beschreibung	Pfad
agentloop	Agent-Loop-Primitive	`~/dev/agentloop`
fabric	UI-Framework-Experimente	`~/dev/fabric`

Skills installieren

Wenn du an einem bestimmten Projekt arbeitest, installiere dessen Skill für tiefergehenden Kontext:

# Alle Arach-Skills installieren (diese Meta-Skill)
npx skills add arach/arach

# Projektspezifische Skills installieren
npx skills add arach/arc        # Architekturdiagramme
npx skills add arach/dewey      # Dokumentations-Toolkit

Projekterkennung

Wenn ich erwähne oder du erkennst, dass ich in folgendem Kontext arbeite:

Kontext	Aktion
`~/dev/arc` oder „Architekturdiagramm“	arc-diagrams-Skill laden
`~/dev/dewey` oder „Dokumentation“	dewey-docs-Skill laden
`~/dev/talkie` oder „Sprach-App“	Swift/SwiftUI macOS-App-Kontext laden
Beliebiges `~/dev/*`-Projekt	Zuerst nach lokaler CLAUDE.md suchen

Tech-Stack-Präferenzen

Kategorie	Präferenz
Paketmanager	pnpm
Frontend	React + TypeScript + TailwindCSS
Desktop-Apps	Swift/SwiftUI (macOS), Tauri (plattformübergreifend)
Build-Tools	Vite, Turbo
Testen	Vitest, Playwright
Zustandsverwaltung	Zustand

Häufig verwendete Befehle

# Entwicklung
pnpm dev          # Dev-Server starten
pnpm build        # Produktions-Build
pnpm test         # Tests ausführen
pnpm lint         # Code linten

# Swift/macOS
swift build       # Swift-Paket bauen
swift run         # Im Debug-Modus ausführen

# Git (immer mit Gitmoji)
git commit -m "✨ Neue Funktion hinzugefügt"
git commit -m "🐛 Bug in Komponente behoben"
git commit -m "🎨 Code-Struktur verbessert"
git commit -m "📝 Dokumentation aktualisiert"
git commit -m "🔧 Konfiguration aktualisiert"

Verzeichnisstruktur

~/dev/
├── arach/          # Dieses Repository (GitHub-Profil + Meta-Skill)
├── arc/            # Architekturdiagramme [hat Skill]
├── dewey/          # Dokumentations-Toolkit [hat Skill]
├── talkie/         # Sprachkonversations-App
├── speakeasy/      # Sprachassistent
├── arach.dev/      # Persönliche Website
├── ...             # ~100 weitere Projekte

Bei einem Neustart

Auf einer neuen Maschine alles bootstrappen:

# 1. Diese Meta-Skill installieren
npx skills add arach/arach

# 2. Claude kennt jetzt alle Projekte und kann bei Bedarf spezifische Skills installieren