archetype-selection

Select a production archetype from a site brief using config/archetypes.json rules.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/calebaero/website-factory --skill archetype-selection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archetype-selection
Source: https://github.com/calebaero/website-factory/tree/main/skills/archetype-selection
Command: npx skills add https://github.com/calebaero/website-factory --skill archetype-selection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reference rules for picking one of the three website-factory production archetypes — brochure, editable_brochure, or app_lite — from a site-brief. Auto-load this skill whenever the task involves choosing a stack, picking a starter kit, deciding whether a project needs a CMS/database/auth/payments, or translating a site-brief into a site-plan. Encodes the selection tree, refusal rules, and upgrade/downgrade triggers. Source of truth is config/archetypes.json. Not a user-invocable command.

Core Features & Use Cases

  • Encodes the decision tree and refusal rules used to choose between brochure, editable_brochure, and app_lite.
  • References the canonical configuration in config/archetypes.json to ensure consistent decisions.
  • Supports planning tasks such as stack selection, starter kit choice, CMS/data requirements, and translation of briefs into site plans.

Quick Start

Provide a site brief and run the archetype planner to determine the recommended archetype and starter kit.

Frequently Asked Questions about archetype-selection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right website archetype from a site brief?

The best way to determine your production archetype is applying a decision tree to the site brief, choosing between brochure, editable_brochure, or app_lite. This evaluates requirements to select a starter kit and outputs a structured site plan highlighting open questions and risks.

When do I need an editable brochure or app_lite archetype instead of a basic brochure?

You need an editable_brochure or app_lite archetype when the site brief specifies dynamic requirements like a CMS, database, authentication, or payments. A basic brochure archetype applies when the project lacks these dynamic data or interactive user features.

How does the decision tree translate a site brief into a production site plan?

The decision tree translates a site brief into a site plan by applying selection rules and upgrade triggers from canonical configuration. It processes brief requirements to return structured fields like site-plan.archetype, site-plan.chosenStarter, and related openQuestions and risks.

Can I use a starter kit if my site brief requires database and authentication features?

Yes, you can use a starter kit if your brief requires database and authentication features by selecting the app_lite archetype. The decision rules map these dynamic requirements to a compatible starter kit, ensuring the chosen stack supports necessary data and auth functionality.

What are the limitations when selecting archetypes for complex site briefs?

Limitations include strict refusal rules that may reject unsupported feature combinations. The process surfaces open questions and risks for auditable planning, but complex briefs requiring custom integrations outside the brochure, editable_brochure, or app_lite scope may not map cleanly to a predefined starter.