website-build-skill 0.1.3 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +9 -0
- package/README.md +3 -2
- package/adapters/grok.md +1 -1
- package/adapters/team.yaml +1 -1
- package/docs/METHOD.md +1 -1
- package/docs/bundles/checklists.md +47 -3
- package/docs/bundles/method.md +11 -7
- package/docs/bundles/playbooks.md +6 -3
- package/docs/bundles/prompts.md +128 -6
- package/docs/bundles/team.md +49 -30
- package/docs/evidence/content-review.json +119 -8
- package/llms.txt +2 -0
- package/package.json +1 -1
- package/skills/website-build-skill/SKILL.md +2 -2
- package/skills/website-build-skill/checklists/build.md +1 -0
- package/skills/website-build-skill/checklists/code-quality.md +35 -0
- package/skills/website-build-skill/checklists/research.md +2 -2
- package/skills/website-build-skill/checklists/ship.md +1 -1
- package/skills/website-build-skill/examples/fictional-studio-handoff.md +2 -1
- package/skills/website-build-skill/manifest.json +76 -21
- package/skills/website-build-skill/playbooks/research-and-memory.md +6 -3
- package/skills/website-build-skill/prompts/00-start.md +4 -0
- package/skills/website-build-skill/prompts/01-website-deep-research.md +20 -4
- package/skills/website-build-skill/prompts/05-stack-and-build.md +8 -0
- package/skills/website-build-skill/prompts/12-web-design-team.md +5 -2
- package/skills/website-build-skill/prompts/13-coding-research.md +83 -0
- package/skills/website-build-skill/roles/builder.md +15 -9
- package/skills/website-build-skill/roles/coordinator.md +3 -2
- package/skills/website-build-skill/roles/researcher.md +9 -8
- package/skills/website-build-skill/roles/reviewer.md +9 -4
- package/skills/website-build-skill/templates/evidence.md +1 -1
|
@@ -97,12 +97,12 @@ Use Markdown for research outputs; record actual access dates and source dates
|
|
|
97
97
|
separately. Unknown publication dates stay unknown, never invented.
|
|
98
98
|
|
|
99
99
|
Use [the research prompt](../prompts/01-website-deep-research.md) as the single
|
|
100
|
-
source for the
|
|
100
|
+
source for the fourteen-domain questions, output filenames and applicability rules.
|
|
101
101
|
Read it before starting; survey each domain and preserve explicit exclusions with reasons.
|
|
102
102
|
Expand relevant questions for the actual brief rather than treating the list as a ceiling.
|
|
103
103
|
|
|
104
104
|
Use [the canonical freshness rule](../playbooks/research-and-memory.md#ask-date-rule)
|
|
105
|
-
for the
|
|
105
|
+
for the fourteen-domain table, date arithmetic, current-version triggers, same-day checks
|
|
106
106
|
and prior-library pass. Copy that table into the project's staleness.md, with claim-level
|
|
107
107
|
revalidation and the earliest-expiring domain. Never maintain a separate policy table here.
|
|
108
108
|
|
|
@@ -128,20 +128,21 @@ resolve the canonical record; never silently erase an earlier disagreement.
|
|
|
128
128
|
|
|
129
129
|
## YOUR OUTPUTS
|
|
130
130
|
|
|
131
|
-
Write
|
|
131
|
+
Write eight grouped Markdown files: 01-codebases-and-stacks.md,
|
|
132
132
|
02-design-and-experience.md, 03-graphics-and-rights.md,
|
|
133
133
|
04-accessibility-and-performance.md, 05-search-and-answers.md,
|
|
134
|
-
06-security-and-delivery.md,
|
|
134
|
+
06-security-and-delivery.md, 07-measurement-and-operations.md, and
|
|
135
|
+
08-languages-and-code.md under your library.
|
|
135
136
|
Write README.md with headline findings and each role's reading order; scope.md and
|
|
136
|
-
coverage.md mapping all
|
|
137
|
+
coverage.md mapping all fourteen domains to files, checklists, applicability, and
|
|
137
138
|
blockers; sources.md with stable claim IDs, URLs, source/access dates, and scope;
|
|
138
139
|
disagreements.md, query-plan.md, and unresolved-claims.md with next verification steps.
|
|
139
|
-
Write all
|
|
140
|
+
Write all fourteen checklists named in the domains, using criterion, method,
|
|
140
141
|
expected evidence, source IDs, owner, status, and exclusion reason per check.
|
|
141
142
|
Write website-qa-checklist.md and how-to-read-a-brand-kit.md so research is executable.
|
|
142
143
|
Write surprises.md as a short sourced summary for the user, and learning.md as your
|
|
143
144
|
record of learned rules. Every research output is Markdown with the dated opener.
|
|
144
|
-
Write staleness.md with the canonical playbook's
|
|
145
|
+
Write staleness.md with the canonical playbook's fourteen-domain table, claim/domain, ASK DATE,
|
|
145
146
|
window, original access, last revalidation, next-check date, trigger, reason, owner,
|
|
146
147
|
affected receipts, and the earliest-expiring domain and its ASK DATE-relative due date. Recheck volatile pricing,
|
|
147
148
|
rights, APIs, host rules, and crawler/search claims on the day they will be used.
|
|
@@ -172,7 +173,7 @@ your self-check must cover the same evidence without claiming independent review
|
|
|
172
173
|
backed by actual current source access. Do not restamp unrevalidated content.
|
|
173
174
|
- No search means BLOCKED with query-plan.md and unresolved-claims.md, including
|
|
174
175
|
for an existing library. Never ask the user for the date to clear a failed rung.
|
|
175
|
-
All
|
|
176
|
+
All fourteen domains have an explicit disposition; a blank section is not coverage.
|
|
176
177
|
Every relied-on disagreement is resolved by evidence or blocks the dependent choice.
|
|
177
178
|
UNVERIFIED claims remain visible but cannot authorize work. Missing sources, dates,
|
|
178
179
|
coverage, expired relied-on facts, or unsaved files mean BLOCKED, not qualified PASS.
|
|
@@ -32,12 +32,14 @@ disagreements.md, unresolved-claims.md, and staleness.md in that same directory.
|
|
|
32
32
|
Verify the research gate and current revision before doing your job. Then read
|
|
33
33
|
site-work/research/library/01-codebases-and-stacks.md,
|
|
34
34
|
04-accessibility-and-performance.md, 05-search-and-answers.md,
|
|
35
|
-
06-security-and-delivery.md,
|
|
35
|
+
06-security-and-delivery.md, 08-languages-and-code.md, and
|
|
36
|
+
03-graphics-and-rights.md for rights checks. Read site-work/coding-standards.md.
|
|
36
37
|
Read all applicable library checklists, especially 06-accessibility.md,
|
|
37
|
-
10-security.md
|
|
38
|
+
10-security.md, 13-legal.md, and 14-code.md. Read prompts/10-adversarial-pre-ship.md,
|
|
38
39
|
playbooks/data-and-templates.md, playbooks/security-headers.md,
|
|
39
|
-
playbooks/accessibility.md, checklists/build.md, checklists/
|
|
40
|
-
checklists/
|
|
40
|
+
playbooks/accessibility.md, checklists/build.md, checklists/code-quality.md,
|
|
41
|
+
checklists/accessibility.md, checklists/security.md, checklists/ship.md,
|
|
42
|
+
and templates/audit-brief.md.
|
|
41
43
|
Return your learning receipt with opened files, assumptions challenged, and checks.
|
|
42
44
|
|
|
43
45
|
## WHAT YOU MUST RESEARCH
|
|
@@ -108,6 +110,9 @@ Old dates may appear only as explicit history alongside current validated access
|
|
|
108
110
|
Treat a confident undated claim as a finding, not a detail. Verify source dates,
|
|
109
111
|
ladder provenance, due domains and later-day rechecks; return violations read-only.
|
|
110
112
|
Check actual different-family evidence and the precise artifact reviewed. Challenge
|
|
113
|
+
the code against checklists/code-quality.md and site-work/coding-standards.md,
|
|
114
|
+
including pinned versions, deprecated APIs, support, commands, dependencies, secure
|
|
115
|
+
coding, organization, and Builder's code-review evidence. Challenge
|
|
111
116
|
input/URL/script escaping, empty IDs, shared state, auth and secrets where applicable,
|
|
112
117
|
headers, rendered discovery, accessibility journeys, and assumptions in the brief.
|
|
113
118
|
Return enough evidence for Builder to reproduce each asserted defect; otherwise
|
|
@@ -16,7 +16,7 @@ Record the scope link, library revision, engagement identifier, producer role an
|
|
|
16
16
|
| Field | Required value and evidence |
|
|
17
17
|
| --- | --- |
|
|
18
18
|
| claim_id | Stable identifier referenced by decisions, checks and findings. |
|
|
19
|
-
| domain | One of the
|
|
19
|
+
| domain | One of the fourteen research domains, with additional scoped concerns as needed. |
|
|
20
20
|
| statement | Exact bounded claim, including relevant version, tier, consumer or use. |
|
|
21
21
|
| kind | Evidence, inference, proposed default, measurement, or UNVERIFIED. |
|
|
22
22
|
| source_url | Opened authoritative URL; a search snippet does not satisfy this field. |
|