site-architecture

Tổng quan về skill site-architecture

Skill site-architecture làm được gì

Skill site-architecture giúp bạn lên kế hoạch hoặc tái cấu trúc hệ thống phân cấp trang, điều hướng, cấu trúc URL và liên kết nội bộ của một website. Skill này được xây dựng cho bài toán information architecture, không phải để tạo XML sitemap kỹ thuật. Nếu câu hỏi thực sự của bạn là “website này nên có những trang nào, chúng nên liên kết với nhau ra sao, và người dùng sẽ di chuyển qua site như thế nào?”, thì đây là skill phù hợp.

Ai nên dùng site-architecture

Skill site-architecture phù hợp nhất với:

• marketer đang lên kế hoạch cho website mới hoặc đợt tái cấu trúc lớn
• founder xác định cấu trúc cho website marketing của một sản phẩm SaaS
• đội UI/UX làm việc với navigation và IA
• đội content có tư duy SEO đang quyết định hub, section và quan hệ giữa các trang
• agency cần một bản sitemap, URL map và nav spec đầu tiên thật nhanh

Nó đặc biệt hữu ích khi website đã phát triển tự phát trong thời gian dài và giờ trở nên khó duyệt, thiếu nhất quán hoặc có cấu trúc quá sâu.

Các bài toán phù hợp nhất với site-architecture

Hãy dùng site-architecture khi bạn cần:

• biến một danh sách trang còn thô thành site map hợp lý
• quyết định nên dùng cấu trúc phẳng hay cấu trúc sâu
• xác định header, footer và section navigation
• tạo quy ước URL cho các section như /features, /compare hoặc /integrations
• cải thiện internal linking giữa hub page và detail page
• xuất visual sitemap bằng ASCII hoặc Mermaid để review

Điều gì khiến site-architecture khác với một prompt chung chung

Một prompt thông thường có thể chỉ liệt kê trang. Skill site-architecture mạnh hơn vì nó đẩy đầu ra theo hướng đầy đủ hơn:

• bắt đầu từ bối cảnh business và audience
• thiết kế hierarchy rõ ràng
• đưa ra khuyến nghị về navigation
• xác lập pattern cho URL structure
• hướng dẫn internal linking
• tạo visual sitemap
• có sẵn template tái sử dụng cho các kiểu website phổ biến

Repo cũng có các tài liệu tham chiếu thực tế cho Mermaid diagram, navigation pattern và template theo loại site, nên kết quả nhất quán hơn nhiều so với việc bắt đầu từ con số 0.

Giới hạn phạm vi quan trọng của site-architecture

Skill này không chủ yếu bao gồm:

• file XML sitemap
• SEO audit toàn diện
• schema markup
• wireframe hoàn chỉnh hoặc mockup UI đã trau chuốt

Với site-architecture for UI/UX Design, skill này hữu ích nhất ở tầng cấu trúc: nhóm trang, wayfinding, các vùng điều hướng và khả năng khám phá nội dung trước khi bước vào thiết kế giao diện chi tiết.

Cách dùng skill site-architecture

Cách cài đặt và truy cập site-architecture

Cài skill từ repository bằng:

npx skills add https://github.com/coreyhaines31/marketingskills --skill site-architecture

Trong thực tế, người dùng kích hoạt site-architecture khi cần hỗ trợ về site map, navigation, page hierarchy hoặc planning cho URL. Nó phát huy tốt nhất trong môi trường agent tương thích với Skills, nơi model có thể đọc các file của skill và làm theo workflow.

Đọc các file này trước khi dùng site-architecture

Nếu muốn đánh giá nhanh skill, hãy bắt đầu với:

1. skills/site-architecture/SKILL.md
2. skills/site-architecture/references/site-type-templates.md
3. skills/site-architecture/references/navigation-patterns.md
4. skills/site-architecture/references/mermaid-templates.md
5. skills/site-architecture/evals/evals.json

Thứ tự này sẽ cho bạn thấy workflow, các loại output thường gặp, lựa chọn navigation cụ thể, format sơ đồ và tiêu chí thế nào được coi là “tốt” trong phần evaluation.

Input quan trọng nhất mà site-architecture cần

Skill site-architecture cho kết quả tốt hơn hẳn khi bạn cung cấp:

• công ty làm gì
• audience chính là ai
• mục tiêu quan trọng nhất của site, thường chỉ nên 2-3 mục tiêu
• đây là website mới hay đang tái cấu trúc
• danh sách trang hiện có, nếu có
• các điểm đang có vấn đề như trùng lặp, phân cấp quá sâu hoặc khó tìm nội dung
• loại website, ví dụ SaaS, ecommerce, services, marketplace hoặc site nặng về content

Nếu bỏ qua các thông tin này, model vẫn có thể phác thảo cấu trúc, nhưng kết quả sẽ khá chung chung và có thể chọn sai navigation pattern.

Kiểm tra bối cảnh product marketing trước

Một hành vi hữu ích rất đặc trưng của repo này: skill nói rõ với agent rằng hãy kiểm tra .agents/product-marketing-context.md hoặc file cũ hơn là .claude/product-marketing-context.md trước khi đặt câu hỏi. Điều này quan trọng vì nhiều quyết định về architecture phụ thuộc trực tiếp vào positioning, audience và cấu trúc offer.

Nếu bạn đã có sẵn product marketing context được ghi lại, hãy trỏ model tới đó. Cách này giúp giảm các lượt hỏi đáp lặp lại và cải thiện chất lượng quyết định về nhóm trang.

Biến một mục tiêu thô thành prompt site-architecture mạnh hơn

Prompt yếu:

Help me make a sitemap.

Prompt tốt hơn:

Use the site-architecture skill to plan a SaaS marketing site for an analytics product aimed at ecommerce teams. Our goals are demo requests, SEO traffic, and partner integrations. We need a homepage, pricing, feature pages, docs, blog, integrations, and competitor comparison pages. Keep top nav to 5-6 primary items. Propose page hierarchy, URL structure, header/footer nav, and internal linking model.

Vì sao prompt này hiệu quả:

• xác định audience và loại hình business
• nêu rõ mục tiêu chuyển đổi và mục tiêu content
• liệt kê các loại nội dung bắt buộc phải có
• thêm ràng buộc cho navigation
• yêu cầu các deliverable cụ thể đúng với những gì skill được thiết kế để tạo ra

Dấu hiệu của việc dùng site-architecture đúng cách

Hãy yêu cầu output theo thứ tự này:

1. assumptions và các input còn thiếu
2. hierarchy đề xuất
3. URL map
4. navigation spec
5. khuyến nghị về internal linking
6. sơ đồ ASCII tree hoặc Mermaid
7. tradeoff hoặc câu hỏi còn bỏ ngỏ

Thứ tự này phản ánh đúng điểm mạnh thực tế của skill. Nó giúp bạn review cấu trúc trước khi tranh luận về label hoặc chi tiết thiết kế.

Dùng template tham chiếu thay vì bắt đầu từ trang trắng

Lối tắt lớn nhất để áp dụng skill là bộ tài liệu tham chiếu:

• site-type-templates.md cung cấp sẵn các pattern hierarchy theo từng loại site
• navigation-patterns.md giúp chọn giữa simple header, mega menu hay các mô hình navigation khác
• mermaid-templates.md giúp tạo visual sitemap nhanh hơn

Với nhiều team, workflow tốt nhất là: chọn template site gần nhất, điều chỉnh lại các section, rồi tinh chỉnh nav và URL. Cách này nhanh hơn và thường cho kết quả tốt hơn so với prompt tự do hoàn toàn.

Workflow site-architecture khuyến nghị cho website mới

Với một website xây mới:

1. xác định mục tiêu business và audience
2. chọn template loại site gần nhất
3. điều chỉnh các section chính
4. đặt quy ước URL
5. giới hạn header navigation ở các mục ưu tiên
6. đưa các trang hỗ trợ xuống footer hoặc section nav
7. thêm internal linking theo mô hình hub-and-spoke khi phù hợp
8. xuất ASCII tree hoặc Mermaid diagram để stakeholder review

Cách này đặc biệt hiệu quả với SaaS, nơi các section như /features, /customers, /resources, /integrations và /compare thường cần được tách bạch rõ ràng.

Workflow site-architecture khuyến nghị cho tái cấu trúc

Với một website hiện có nhưng lộn xộn, hãy cung cấp cho model:

• nav hiện tại
• số lượng trang hoặc page inventory
• các section bị trùng lặp
• những trang có traffic kém hoặc ownership không rõ ràng
• phản hồi của người dùng như “không tìm thấy docs” hoặc “dropdown quá nhiều”

Sau đó yêu cầu model:

• gộp các section
• loại bỏ các entry point trùng nhau
• làm phẳng những tầng sâu không cần thiết
• tách primary nav khỏi các mục utility/footer
• giữ lại các legacy URL có giá trị cao nếu có thể

Đây chính là lúc skill site-architecture hữu ích hơn một prompt brainstorming thông thường, vì nó định hình bài toán như một công việc tái tổ chức, chứ không chỉ là liệt kê trang.

site-architecture cho đội UI/UX Design

Với UI/UX Design, hãy dùng skill này trước giai đoạn wireframe khi bạn cần làm rõ:

• mục nào nên nằm trong global nav
• section nào cần landing page riêng
• breadcrumb nên phản ánh hierarchy thế nào
• trang nào xứng đáng được truy cập trực tiếp, trang nào nên đi theo đường dẫn gián tiếp
• khi nào mega menu là hợp lý

Nó không thay thế interaction design, nhưng cho đội UI/UX một baseline IA thuyết phục hơn trước khi bắt tay vào thiết kế component.

Các format output thực tế nên yêu cầu

Skill này mạnh nhất khi bạn yêu cầu một hoặc nhiều định dạng sau:

• ASCII tree để review nhanh
• Mermaid sitemap để đưa vào tài liệu
• bảng URL map có mức độ ưu tiên
• header/footer nav spec
• mô hình internal linking theo từng section

Tất cả các format này đều có bằng chứng hỗ trợ ngay trong repo, nên bạn đang căn đúng yêu cầu của mình với những gì skill vốn đã xử lý tốt.

Câu hỏi thường gặp về skill site-architecture

site-architecture có phù hợp với người mới bắt đầu không?

Có, miễn là bạn đã biết mục tiêu của website và các loại nội dung chính. Skill này giúp tạo cấu trúc nhanh hơn nhiều so với việc tự nghĩ IA từ đầu. Người mới thường gặp khó không phải vì skill quá nâng cao, mà vì họ cung cấp quá ít bối cảnh.

Khi nào nên dùng site-architecture thay vì prompt thông thường?

Hãy dùng skill site-architecture khi output cần mang tính vận hành: hierarchy, nav, quy tắc URL và chiến lược linking. Prompt bình thường có thể giúp brainstorm trang, nhưng skill này tốt hơn khi bạn cần một architecture artifact có thể đem đi review.

site-architecture có tạo XML sitemap không?

Không. Skill này dành cho information architecture và lập kế hoạch navigation. Đây không phải công cụ phù hợp để tạo XML sitemap hoặc chẩn đoán crawl kỹ thuật.

site-architecture có hữu ích cho website hiện có, hay chỉ cho website mới?

Có. Nó rất phù hợp cho các đợt tái cấu trúc, đặc biệt khi website có quá nhiều trang, nhóm nội dung thiếu nhất quán hoặc navigation gây rối. Hãy cung cấp hiện trạng và pain point, chứ đừng chỉ đưa ra trạng thái tương lai bạn mong muốn.

So với làm IA thủ công thì site-architecture thế nào?

Làm IA thủ công vẫn rất có giá trị, nhưng skill này giúp tăng tốc vòng đầu và cung cấp template tái sử dụng. Nó hữu ích nhất khi bạn cần phác thảo nhiều phương án, làm lộ rõ tradeoff và tạo ra artifact để team cùng review. Tuy vậy, bạn vẫn cần đánh giá của con người cho các yếu tố như chính trị nội bộ, ownership và ràng buộc triển khai.

site-architecture có phù hợp cho site-architecture for UI/UX Design không?

Có, nếu dùng như một công cụ planning ở thượng nguồn. Nó giúp đội UI/UX Design xác định quan hệ giữa các trang, độ sâu của navigation và logic wayfinding trước khi đi vào layout chi tiết. Nó kém phù hợp hơn với các quyết định thiết kế ở cấp component.

Khi nào site-architecture là sai công cụ?

Đừng dùng nếu nhu cầu thực sự của bạn là:

• technical SEO audit
• lập kế hoạch schema
• viết content
• wireframe page layout độ hoàn thiện cao
• app information architecture vượt xa các pattern của marketing site

Nó cũng là lựa chọn không tốt nếu bạn không thể cung cấp bối cảnh business tối thiểu.

Cách cải thiện skill site-architecture

Đưa ra ràng buộc business sắc nét hơn

Cách nhanh nhất để cải thiện output của site-architecture là nêu rõ các ràng buộc:

• hành động chuyển đổi chính
• các nhóm audience ưu tiên nhất
• số lượng tối đa mục trong header nav
• các section bắt buộc phải có
• các section không nên xuất hiện trong main nav
• SEO landing page có phải ưu tiên hay không

Nếu không có ràng buộc, model thường sẽ đưa quá nhiều trang vào và không ưu tiên navigation đủ rõ.

Cung cấp page inventory khi tái cấu trúc

Với site đang hoạt động, hãy dán một page inventory sơ bộ hoặc nav hiện tại. Chỉ cần một danh sách còn lộn xộn cũng đủ. Điều này giúp skill site-architecture phát hiện cơ hội gộp nhóm, cấu trúc trùng lặp và các section bị mồ côi mà nếu không có thì rất dễ bị bỏ sót.

Yêu cầu tradeoff, đừng chỉ xin một đáp án duy nhất

Một pattern cải thiện rất hiệu quả là:

Give me a recommended architecture plus one simpler option and one SEO-expansion option.

Cách này làm lộ ra những quyết định thực sự như:

• nav đơn giản vs nav dễ mở rộng
• ít section cấp cao hơn vs các hub landing page chuyên biệt
• hierarchy phẳng hơn vs phân loại rõ ràng hơn

Nhờ đó, skill sẽ hữu ích hơn nhiều cho việc chốt phương án với stakeholder.

Ép output rõ ràng hơn bằng deliverable cụ thể

Nếu output vòng đầu còn mơ hồ, hãy yêu cầu:

• một ASCII tree đầy đủ
• exact URL pattern
• nhãn nav kèm số lượng item
• ví dụ breadcrumb
• internal link ở cấp section

Các format cụ thể này giúp giảm kiểu tư vấn chung chung và khiến hướng dẫn site-architecture sẵn sàng hơn cho triển khai.

Các lỗi thường gặp cần để ý trong bản nháp đầu của site-architecture

Hãy theo dõi các vấn đề sau trong bản đầu:

• quá nhiều mục ở top-level nav
• tên category chồng lấn nhau
• trộn lẫn content hub với conversion page mà không có ưu tiên rõ ràng
• phân cấp quá sâu nhưng không mang lại nhiều lợi ích cho người dùng
• blog/resources/docs bị nhóm thiếu nhất quán
• thêm SEO landing page nhưng không có kế hoạch linking

Đây là những lỗi IA rất phổ biến mà skill có thể tạo ra nếu prompt của bạn quá rộng hoặc mơ hồ.

Cải thiện khuyến nghị internal linking

Đừng chấp nhận kiểu gợi ý “add internal links” là đủ. Hãy yêu cầu model nêu rõ:

• hub page nào sẽ link tới detail page nào
• detail page nào cần link ngược về hub
• nơi nào nên có cross-link, ví dụ từ features sang integrations hoặc từ comparisons sang pricing
• trang nào nên tránh cross-link quá nhiều

Làm vậy sẽ biến việc dùng site-architecture từ mức ý tưởng sang mức có thể hành động.

Dùng tài liệu tham chiếu trong repo để siết chặt các bản nháp yếu

Nếu output vẫn còn chung chung, hãy yêu cầu model áp dụng:

• references/navigation-patterns.md cho quyết định về nav
• references/site-type-templates.md cho độ bao phủ section
• references/mermaid-templates.md cho sơ đồ rõ ràng hơn

Đây là một trong những cách dễ nhất để cải thiện skill site-architecture mà không cần thay đổi chính skill.

Lặp lại sau vòng kiến trúc đầu tiên

Best practice là dùng một prompt vòng hai như:

Revise this site architecture to reduce header nav to 5 items, move low-priority pages to footer, preserve our existing /blog structure, and create a clearer hub model for integrations and comparison pages.

Chính kiểu chỉnh sửa có mục tiêu như vậy thường là lúc skill bắt đầu trở nên thực sự hữu ích cho môi trường production.

Kiểm tra cấu trúc theo hành trình người dùng thực tế

Trước khi áp dụng output, hãy kiểm tra xem các hành trình quan trọng có mượt không:

• người dùng lần đầu đi từ nhận biết đến hiểu sản phẩm
• người đang so sánh giải pháp đi tới trang ra quyết định
• khách truy cập từ bài SEO đi từ bài viết tới ý định tìm hiểu sản phẩm
• khách hàng hiện tại đi tới docs hoặc support
• đối tác tiềm năng đi tới chi tiết integrations

Nếu các hành trình này còn gượng gạo, site-architecture vẫn cần thêm một vòng lặp nữa dù sitemap nhìn có vẻ gọn.

Cải thiện site-architecture bằng cách thu hẹp audience

Audience quá rộng sẽ tạo ra architecture thiếu trọng tâm. Nếu output đầu tiên cố phục vụ tất cả mọi người, hãy tách ưu tiên rõ hơn:

• buyer vs user
• SMB vs enterprise
• prospect vs customer
• nội dung giáo dục vs nội dung chuyển đổi

Skill site-architecture cải thiện đáng kể khi mức độ ưu tiên audience rõ ràng, vì khi đó navigation và cách nhóm trang sẽ dễ bảo vệ hơn nhiều.