Xây dựng và quản trị hệ thống thương hiệu với ak:brand

Dùng ak:brand để định nghĩa hoặc cập nhật voice, messaging, visual identity và quy tắc asset của thương hiệu. Skill có thể hướng dẫn công việc thương hiệu; route update được ghi nhận có thể đồng bộ giá trị guideline đã duyệt vào tệp design token cục bộ.

Chọn Skill này cho artifact thương hiệu có quản trị

Dùng ak:brand khi

• Bạn cần bản nháp voice chart, message hierarchy, positioning statement, quy tắc hình ảnh hoặc brand guideline.
• Bạn muốn review asset theo tiêu chí đã duyệt về tên, định dạng, kích thước, palette, accessibility, license và messaging.
• Bạn có input màu sắc cùng mood đã duyệt và muốn cập nhật đồng thời authority thương hiệu cục bộ cùng token dẫn xuất.

Chọn workflow khác khi

• Claim về audience, market hoặc competitor chưa rõ. Bắt đầu với ak:marketing-research, ak:competitor hoặc ak:persona, rồi tách bằng chứng khỏi giả định.
• Bạn cần campaign plan thay vì brand system. Dùng ak:marketing-planning.
• Bạn chỉ muốn publish, tạo media hoặc đổi design system đang chạy. Đó là hành động riêng với approval và ảnh hưởng provider riêng.

Chuẩn bị input và authority

Cung cấp fact về business cùng product, bằng chứng target audience, asset hiện có, thuật ngữ đã duyệt, constraint pháp lý và người có quyền duyệt thay đổi thương hiệu. Theo mặc định, helper đi kèm coi docs/brand-guidelines.md là source of truth cục bộ. Xác nhận đây là authority đúng của project trước khi cho phép ghi.

Tách fact được cung cấp khỏi lựa chọn đề xuất. Màu, voice trait, proof point hay differentiator do workflow tạo ra vẫn là bản nháp cho tới khi owner duyệt và mọi claim thực tế có bằng chứng.

Gọi route update đã được ghi nhận

/ak:brand update "Update the draft theme to the approved Ocean Blue, Golden Amber, and Emerald values. Keep unverified messaging as assumptions and show every file before final approval"

/ak:brand update "Update the draft theme to the approved Ocean Blue, Golden Amber, and Emerald values. Keep unverified messaging as assumptions and show every file before final approval"

$ak:brand update "Update the draft theme to the approved Ocean Blue, Golden Amber, and Emerald values. Keep unverified messaging as assumptions and show every file before final approval"

Argument hint cũng nêu review và create, nhưng package này chỉ có route chuyên biệt cho update. Hãy mô tả công việc review hoặc creation bằng outcome ngôn ngữ tự nhiên trừ khi package đã cài cung cấp route bổ sung.

Hiểu các giai đoạn

1. Xác lập authority. Xác nhận brand guideline hiện tại, bằng chứng audience cùng product, owner phê duyệt và scope tệp được phép.
2. Soạn hệ thống. Phát triển voice, tone, message architecture, visual identity, cách tổ chức asset và tiêu chí approval khi cần.
3. Cập nhật guideline. Route update thu thập theme, primary, secondary, accent cùng mood rồi sửa docs/brand-guidelines.md.
4. Đồng bộ token. Helper cập nhật assets/design-tokens.json và thử tạo lại assets/design-tokens.css. Helper có dry-run, nhưng routed workflow mô tả đường ghi tệp.
5. Xác minh kết quả. Trích xuất context, kiểm tra diff, test contrast cùng cách dùng asset và lấy human approval trước khi sử dụng hay publish.

Helper tùy chọn có thể trích xuất brand context, kiểm tra tên, định dạng, kích thước cùng đăng ký manifest của asset hoặc chuẩn bị bước so sánh màu. Trích màu từ ảnh có thể cần ImageMagick hay dịch vụ multimodal bên ngoài; quyền truy cập đó tách biệt với chỉnh sửa brand cục bộ.

Giữ approval và side effect rõ ràng

Workflow update sửa tệp cục bộ. Review cả ba path dự kiến và giữ nguyên thay đổi không liên quan. Đừng coi việc tạo token là quyền publish, deploy, thay asset production, gọi image provider hay phát sinh chi phí. Hãy cấp riêng các quyền đó.

Xác minh output và bằng chứng

Một lần chạy hoàn tất nên cung cấp:

• Diff brand guideline và input đã duyệt đứng sau từng giá trị thay đổi.
• Diff token JSON cùng CSS dẫn xuất, gồm mọi cảnh báo tạo CSS.
• Quy tắc voice, messaging cùng visual với proof point liên kết nguồn hoặc được gắn nhãn giả định.
• Phát hiện asset-check được tách thành error, warning và suggestion.
• Quyết định còn lại về accessibility, pháp lý, license, stakeholder và publication.

Xử lý sự cố và biết giới hạn

Template đi kèm chứa màu, font, ratio cùng wording minh họa; chúng không phải fact về thương hiệu của bạn. Helper parsing phụ thuộc section Markdown mong đợi, còn khoảng cách RGB gần đúng không phải bài test brand hay accessibility đầy đủ. Tiếp tục với Tổng quan Marketing Kit hoặc Vòng đời Marketing Kit để hiểu ownership cùng recovery.