Đóng góp

Bestie còn sớm. PR tốt nhất là PR nhỏ, rõ mục tiêu, có test và dễ review.

Trước khi làm

1. Đọc README và docs scope hiện tại.
2. Đọc Security/Privacy nếu đụng secrets, logs, memory, Telegram, MCP hoặc tool execution.
3. Check issue/discussion để tránh trùng việc.
4. Change lớn nên mở issue/discussion trước.

Local setup

npm ci
npm run build
npm test

PR tốt nên có

• Giải quyết một vấn đề rõ.
• Có test cho behavior thay đổi.
• Update docs nếu đổi config hoặc user-facing behavior.
• Không leak secrets trong code, logs, screenshots, fixtures.
• Không format churn lan man.
• Ghi rõ validation đã chạy.

Architecture guidelines

• CLI command files nên mỏng; logic reusable nằm trong runtime services.
• Character behavior nên data-driven qua character/prompt files.
• Provider OpenAI-compatible cấu hình bằng baseUrl, model, apiKeyEnv.
• External content luôn untrusted.
• Không mở broad write/destructive/public actions nếu thiếu permission checks và tests.