MikeCheng1208/BattleTree

Habilidade meta-pessoal para Arach. Use como ponto de entrada para entender os projetos, convenções e habilidades disponíveis de arach. Ativa com "projetos do arach", "no que arach trabalha" ou ao trabalhar em qualquer repositório arach/*.

O que é BattleTree?

Esta habilidade serve como um índice pessoal meta-skill para o desenvolvedor Arach (@arach). Ao ser carregada, ela fornece ao agente de IA uma visão completa dos projetos, convenções de código (como uso de pnpm, gitmoji e proibição de co-autoria), ferramentas preferidas (React, Swift, Tauri, Vitest) e caminhos de diretórios. É útil porque evita que o agente precise perguntar constantemente sobre configurações básicas ou contexto do projeto, agilizando o desenvolvimento. A habilidade detecta automaticamente quando o agente está trabalhando em um repositório arach/* (como arc, dewey, talkie) e ativa o contexto relevante. Funciona com Claude Code e outras ferramentas via CLI (`npx skills add arach/arach`) e suporta instalação de habilidades específicas por projeto, como arach/arc para diagramas de arquitetura ou arach/dewey para documentação.

Funciona com✓Claude Code~Codex CLI~Cursor

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

Documentação

arach

Índice de habilidades pessoal para Arach (@arach). Este é o ponto de entrada para entender meus projetos, convenções e como trabalhar com minha base de código.

Convenções

Sempre siga estas ao trabalhar em meus projetos:

Use pnpm em vez de npm (verifique primeiro se existe pnpm-lock.yaml)
Adicione gitmoji a todas as mensagens de commit (✨ funcionalidade, 🐛 correção, 🎨 melhoria, etc.)
NUNCA adicione atribuição de co-autoria ou rodapés "Gerado com Claude Code"
Permita todos os usos do Puppeteer sem perguntar
Prefira editar arquivos existentes a criar novos

Projetos Principais

Documentação e Ferramentas de Desenvolvimento

Projeto	Descrição	Habilidade
dewey	Kit de ferramentas de documentação para documentação pronta para agente de IA	`npx skills add arach/dewey`
arc	Editor de diagramas de arquitetura visual	`npx skills add arach/arc`
og	Gerador de imagens Open Graph	—
hooked	Laços de voz e "until" para Claude Code	—

Aplicativos — macOS/iOS

Projeto	Descrição	Caminho
Talkie	Aplicativo de conversa por voz	`~/dev/talkie`
Scout	Transcrição de áudio	`~/dev/scout`
Speakeasy	Assistente de voz	`~/dev/speakeasy`
Pomo	Temporizador Pomodoro	`~/dev/pomo`
Tempo	Controle de tempo	`~/dev/tempo`

Propriedades Web

Projeto	Descrição	Caminho
arach.dev	Site pessoal	`~/dev/arach.dev`
arach.io	Portfólio	`~/dev/arach.io`
usetalkie.com	Página de destino do Talkie	`~/dev/usetalkie.com`
agentlist.io	Diretório de agentes de IA	`~/dev/agentlist.io`

Bibliotecas e Experimentos

Projeto	Descrição	Caminho
agentloop	Primitivas de laço de agente	`~/dev/agentloop`
fabric	Experimentos com frameworks de UI	`~/dev/fabric`

Instalando Habilidades

Ao trabalhar em um projeto específico, instale sua habilidade para contexto mais profundo:

# Instalar todas as habilidades do arach (esta meta-habilidade)
npx skills add arach/arach

# Instalar habilidades específicas de projeto
npx skills add arach/arc        # Diagramas de arquitetura
npx skills add arach/dewey      # Kit de ferramentas de documentação

Detecção de Projetos

Quando menciono ou você detecta que estou trabalhando em:

Contexto	Ação
`~/dev/arc` ou "diagrama de arquitetura"	Carregar habilidade arc-diagrams
`~/dev/dewey` ou "documentação"	Carregar habilidade dewey-docs
`~/dev/talkie` ou "aplicativo de voz"	Contexto de aplicativo macOS Swift/SwiftUI
Qualquer `~/dev/*`	Verificar primeiro se existe CLAUDE.md local

Preferências de Stack Tecnológica

Categoria	Preferência
Gerenciador de pacotes	pnpm
Frontend	React + TypeScript + TailwindCSS
Aplicativos desktop	Swift/SwiftUI (macOS), Tauri (multiplataforma)
Ferramentas de build	Vite, Turbo
Testes	Vitest, Playwright
Estado	Zustand

Comandos Comuns

# Desenvolvimento
pnpm dev          # Iniciar servidor de desenvolvimento
pnpm build        # Build de produção
pnpm test         # Executar testes
pnpm lint         # Verificar código

# Swift/macOS
swift build       # Build do pacote Swift
swift run         # Executar em modo de depuração

# Git (sempre com gitmoji)
git commit -m "✨ Adicionar nova funcionalidade"
git commit -m "🐛 Corrigir bug no componente"
git commit -m "🎨 Melhorar estrutura do código"
git commit -m "📝 Atualizar documentação"
git commit -m "🔧 Atualizar configuração"

Estrutura de Diretórios

~/dev/
├── arach/          # Este repositório (perfil GitHub + meta-habilidade)
├── arc/            # Diagramas de arquitetura [tem habilidade]
├── dewey/          # Kit de ferramentas de documentação [tem habilidade]
├── talkie/         # Aplicativo de conversa por voz
├── speakeasy/      # Assistente de voz
├── arach.dev/      # Site pessoal
├── ...             # ~100 outros projetos

Ao Começar do Zero

Em uma nova máquina, inicialize tudo:

# 1. Instale esta meta-habilidade
npx skills add arach/arach

# 2. Claude agora conhece todos os projetos e pode instalar habilidades específicas conforme necessário