Improve website artifact templates skill

Skeletons this metaskill creates in the user's docs/ folder.

by wondelai·MIT license·★ 2,235 Stars on the repo·GitHub ↗

Use now

Files of Improve website artifact templates

wondelai/main1 file
artifact-templates.md
Show the full text113 lines
improve-website-artifact-templates/artifact-templates.md113 lines · 3.2 KB

improve-website artifact templates

Skeletons this metaskill creates in the user's docs/ folder. Extend-only artifacts (POSITIONING.md, METRICS.md) are governed by the section headings named in each phase — read the file before writing, add or update your sections, and preserve everyone else's. The three skeletons below are the files this journey most often creates from scratch; copy them verbatim only when the file is missing.

Tracker: docs/IMPROVE-WEBSITE-PLAN.md

Created on the first run (Intake). Never shared with another journey.

# Improve Website Plan

## Context
Intake answers, date started, project specifics.

## Phase Status
| Phase | Skill | Status | Artifact | Date |
|---|---|---|---|---|
| 1 | cro-methodology | pending | METRICS.md, WEBSITE.md, EXPERIMENTS.md | |
| 2 | ux-heuristics | pending | DESIGN.md, EXPERIMENTS.md | |
| 3 | refactoring-ui | pending | DESIGN.md, EXPERIMENTS.md | |
| 4 | web-typography | pending | DESIGN.md, EXPERIMENTS.md | |
| 5 | storybrand-messaging | pending | POSITIONING.md, EXPERIMENTS.md | |
| 6 | high-perf-browser | pending | METRICS.md, WEBSITE.md, EXPERIMENTS.md | |
| 7 | made-to-stick | pending | POSITIONING.md, EXPERIMENTS.md | |
| 8 | design-everyday-things | pending | DESIGN.md, EXPERIMENTS.md | |
Statuses: pending · in-progress · awaiting-evidence · done · deferred: <reason> · skipped: <reason>

## Key Decisions
| Date | Phase | Decision | Rationale |
|---|---|---|---|

## Next Actions
- [ ] action (owner, due)

docs/WEBSITE.md

Site structure and page briefs. Creates: create-website. Extends: improve-website, grow-website.

# Website

## Sitemap

## Page Briefs
### / (home)
- Purpose & primary conversion action:
- Message (from POSITIONING.md):
- CTA (direct + transitional):
- Copy blocks:

## Conversion Elements
| Objection (Big 5) | Counter | Placement | Status |
|---|---|---|---|

## Audit Findings
| Issue | Severity (0-4) | Fix | Status |
|---|---|---|---|

## Lead Capture
Scorecard/quiz funnel design.

docs/DESIGN.md

Visual and interaction system. Creates: create-website, create-app. Extends: improve-website, improve-app.

# Design System

## Design Direction
Signature moment, personality, references.

## Typography
Typefaces, scale, measure, line height, loading strategy.

## Tokens
Spacing scale · color palette (shades, tinted grays) · shadows.

## Components
| Component | Decision | Status |
|---|---|---|

## UX Audit Findings
| Issue | Heuristic | Severity (0-4) | Fix | Status |
|---|---|---|---|---|

## Microinteraction Inventory
| Interaction | Trigger/Rules/Feedback/Loops | Fix | Status |
|---|---|---|---|

docs/EXPERIMENTS.md

Every test we run, with pre-committed criteria. Creates: create-business, create-app. Extends: improve-website, grow-website, grow-app, grow-business.

# Experiments

## Experiment Cards
### EXP-001 — [name]
- Hypothesis: We believe [outcome] if [who] [does what] because [reason]
- Type: sprint / smoke test / concierge / painted door / A-B
- Primary metric & threshold (pre-committed):
- Guardrail metric:
- Decision rule (pivot / persevere / iterate):
- Result & verdict:

## Experiment Backlog
| Idea | ICE (impact/confidence/ease) | Status |
|---|---|---|
1# improve-website artifact templates
2 
3Skeletons this metaskill creates in the user's docs/ folder. Extend-only artifacts (POSITIONING.md, METRICS.md) are governed by the section headings named in each phase — read the file before writing, add or update your sections, and preserve everyone else's. The three skeletons below are the files this journey most often creates from scratch; copy them verbatim only when the file is missing.
4 
5## Tracker: docs/IMPROVE-WEBSITE-PLAN.md
6 
7Created on the first run (Intake). Never shared with another journey.
8 
9```markdown
10# Improve Website Plan
11 
12## Context
13Intake answers, date started, project specifics.
14 
15## Phase Status
16| Phase | Skill | Status | Artifact | Date |
17|---|---|---|---|---|
18| 1 | cro-methodology | pending | METRICS.md, WEBSITE.md, EXPERIMENTS.md | |
19| 2 | ux-heuristics | pending | DESIGN.md, EXPERIMENTS.md | |
20| 3 | refactoring-ui | pending | DESIGN.md, EXPERIMENTS.md | |
21| 4 | web-typography | pending | DESIGN.md, EXPERIMENTS.md | |
22| 5 | storybrand-messaging | pending | POSITIONING.md, EXPERIMENTS.md | |
23| 6 | high-perf-browser | pending | METRICS.md, WEBSITE.md, EXPERIMENTS.md | |
24| 7 | made-to-stick | pending | POSITIONING.md, EXPERIMENTS.md | |
25| 8 | design-everyday-things | pending | DESIGN.md, EXPERIMENTS.md | |
26Statuses: pending · in-progress · awaiting-evidence · done · deferred: <reason> · skipped: <reason>
27 
28## Key Decisions
29| Date | Phase | Decision | Rationale |
30|---|---|---|---|
31 
32## Next Actions
33- [ ] action (owner, due)
34```
35 
36## docs/WEBSITE.md
37 
38Site structure and page briefs. Creates: create-website. Extends: improve-website, grow-website.
39 
40```markdown
41# Website
42 
43## Sitemap
44 
45## Page Briefs
46### / (home)
47- Purpose & primary conversion action:
48- Message (from POSITIONING.md):
49- CTA (direct + transitional):
50- Copy blocks:
51 
52## Conversion Elements
53| Objection (Big 5) | Counter | Placement | Status |
54|---|---|---|---|
55 
56## Audit Findings
57| Issue | Severity (0-4) | Fix | Status |
58|---|---|---|---|
59 
60## Lead Capture
61Scorecard/quiz funnel design.
62```
63 
64## docs/DESIGN.md
65 
66Visual and interaction system. Creates: create-website, create-app. Extends: improve-website, improve-app.
67 
68```markdown
69# Design System
70 
71## Design Direction
72Signature moment, personality, references.
73 
74## Typography
75Typefaces, scale, measure, line height, loading strategy.
76 
77## Tokens
78Spacing scale · color palette (shades, tinted grays) · shadows.
79 
80## Components
81| Component | Decision | Status |
82|---|---|---|
83 
84## UX Audit Findings
85| Issue | Heuristic | Severity (0-4) | Fix | Status |
86|---|---|---|---|---|
87 
88## Microinteraction Inventory
89| Interaction | Trigger/Rules/Feedback/Loops | Fix | Status |
90|---|---|---|---|
91```
92 
93## docs/EXPERIMENTS.md
94 
95Every test we run, with pre-committed criteria. Creates: create-business, create-app. Extends: improve-website, grow-website, grow-app, grow-business.
96 
97```markdown
98# Experiments
99 
100## Experiment Cards
101### EXP-001 — [name]
102- Hypothesis: We believe [outcome] if [who] [does what] because [reason]
103- Type: sprint / smoke test / concierge / painted door / A-B
104- Primary metric & threshold (pre-committed):
105- Guardrail metric:
106- Decision rule (pivot / persevere / iterate):
107- Result & verdict:
108 
109## Experiment Backlog
110| Idea | ICE (impact/confidence/ease) | Status |
111|---|---|---|
112```
113 

Discussion