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.
Files changed (32) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +9 -0
  3. package/README.md +3 -2
  4. package/adapters/grok.md +1 -1
  5. package/adapters/team.yaml +1 -1
  6. package/docs/METHOD.md +1 -1
  7. package/docs/bundles/checklists.md +47 -3
  8. package/docs/bundles/method.md +11 -7
  9. package/docs/bundles/playbooks.md +6 -3
  10. package/docs/bundles/prompts.md +128 -6
  11. package/docs/bundles/team.md +49 -30
  12. package/docs/evidence/content-review.json +119 -8
  13. package/llms.txt +2 -0
  14. package/package.json +1 -1
  15. package/skills/website-build-skill/SKILL.md +2 -2
  16. package/skills/website-build-skill/checklists/build.md +1 -0
  17. package/skills/website-build-skill/checklists/code-quality.md +35 -0
  18. package/skills/website-build-skill/checklists/research.md +2 -2
  19. package/skills/website-build-skill/checklists/ship.md +1 -1
  20. package/skills/website-build-skill/examples/fictional-studio-handoff.md +2 -1
  21. package/skills/website-build-skill/manifest.json +76 -21
  22. package/skills/website-build-skill/playbooks/research-and-memory.md +6 -3
  23. package/skills/website-build-skill/prompts/00-start.md +4 -0
  24. package/skills/website-build-skill/prompts/01-website-deep-research.md +20 -4
  25. package/skills/website-build-skill/prompts/05-stack-and-build.md +8 -0
  26. package/skills/website-build-skill/prompts/12-web-design-team.md +5 -2
  27. package/skills/website-build-skill/prompts/13-coding-research.md +83 -0
  28. package/skills/website-build-skill/roles/builder.md +15 -9
  29. package/skills/website-build-skill/roles/coordinator.md +3 -2
  30. package/skills/website-build-skill/roles/researcher.md +9 -8
  31. package/skills/website-build-skill/roles/reviewer.md +9 -4
  32. package/skills/website-build-skill/templates/evidence.md +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "packageVersion": "0.1.3",
3
+ "packageVersion": "0.1.4",
4
4
  "skillName": "website-build-skill",
5
5
  "pathBase": "All asset paths resolve from this manifest directory; runtime paths resolve in the authorized user project.",
6
6
  "assets": [
@@ -17,7 +17,7 @@
17
17
  "skill-zip",
18
18
  "native-skill"
19
19
  ],
20
- "sha256": "14083527283bb68e11a073776e48aa758514e934064ec24e0f83d131549eec76"
20
+ "sha256": "ed1c909f9946de0fa7a43364c84efc837b6644c0dc8334b81ddfaf031db156e1"
21
21
  },
22
22
  {
23
23
  "path": "manifest.json",
@@ -45,7 +45,7 @@
45
45
  "skill-zip",
46
46
  "native-skill"
47
47
  ],
48
- "sha256": "f9be73afb8f0e7746f2e24db5131270ab6cbf7cf3e7636473b51962a679bdfe3"
48
+ "sha256": "d5ed2a92d5bd7071895658ebbf4d7d696aeddb3735aa8d9153d0405c517f7b9c"
49
49
  },
50
50
  {
51
51
  "path": "prompts/01-website-deep-research.md",
@@ -60,7 +60,7 @@
60
60
  "skill-zip",
61
61
  "native-skill"
62
62
  ],
63
- "sha256": "3577554da4ddf2be09783e72a45fc84d39d79673b414408eee7a16c57efdb7c4"
63
+ "sha256": "6289264065a504551c0f6d20f7cfecc6a916880df8d91f1b4f5b04684c481cab"
64
64
  },
65
65
  {
66
66
  "path": "archive/graphics-design-original.md",
@@ -119,7 +119,7 @@
119
119
  "skill-zip",
120
120
  "native-skill"
121
121
  ],
122
- "sha256": "4a7b4120f37922eee98db9160cdab13f104f422d58c2f8e235ad8697f8079efa"
122
+ "sha256": "7b49af1c5286281b58aa37fa3ff0215750cc4ca3efc97ff550992c616cd3cbf8"
123
123
  },
124
124
  {
125
125
  "path": "prompts/06-site-audit.md",
@@ -225,7 +225,22 @@
225
225
  "skill-zip",
226
226
  "native-skill"
227
227
  ],
228
- "sha256": "e6e7cad7d31ee51879a82f14b82ef7d0a171c67ab1763140a69e2b63e5d0c93f"
228
+ "sha256": "58a53b49b1da1039195d0ecaa24dff296668d9c4c4a52545d40836ddf8d6d388"
229
+ },
230
+ {
231
+ "path": "prompts/13-coding-research.md",
232
+ "version": "0.1.4",
233
+ "kind": "prompt",
234
+ "active": true,
235
+ "bundles": [
236
+ "prompts"
237
+ ],
238
+ "distributions": [
239
+ "npm",
240
+ "skill-zip",
241
+ "native-skill"
242
+ ],
243
+ "sha256": "d1de4c7ed85b4109a35b60d5d2aedd2db5178ed6d198cbdca0c31250cf469ed4"
229
244
  },
230
245
  {
231
246
  "path": "roles/researcher.md",
@@ -240,7 +255,7 @@
240
255
  "skill-zip",
241
256
  "native-skill"
242
257
  ],
243
- "sha256": "245b0ee036e2c73619bab2c3b7585cf7b1cc7c5f9b7364dcd48a613ff2d1be78"
258
+ "sha256": "741a5200fbef577c8e8da4dec7eb4d738cca9ead11928260ca610a67bdb98106"
244
259
  },
245
260
  {
246
261
  "path": "roles/coordinator.md",
@@ -255,7 +270,7 @@
255
270
  "skill-zip",
256
271
  "native-skill"
257
272
  ],
258
- "sha256": "1049ee3d1d85976ed943d767d89814d9d83463707591c3bd0268a8be02f7fdca"
273
+ "sha256": "0bddf3b4477c224fe0dfb75b8370e213e51f939871fd973e4ff0ff88cba3b822"
259
274
  },
260
275
  {
261
276
  "path": "roles/designer.md",
@@ -300,7 +315,7 @@
300
315
  "skill-zip",
301
316
  "native-skill"
302
317
  ],
303
- "sha256": "7f7e957e65e2cff0d73baf6fd4dff5eb9468d451dbde792ddf4d5c143c6909b1"
318
+ "sha256": "c02abff4b072d9a95eec7e2303c27bd6908f59b3c895cac5f1ea52ebb403c4be"
304
319
  },
305
320
  {
306
321
  "path": "roles/optimizer.md",
@@ -330,7 +345,7 @@
330
345
  "skill-zip",
331
346
  "native-skill"
332
347
  ],
333
- "sha256": "85e8355c2b7996ec1304024db3760ff489f3fdfbc1f962e9d54649b647eae599"
348
+ "sha256": "8d77a3f3db3eb127ae931e1b92ed8cc30da3f5bd095b0af84d76acd15430c66b"
334
349
  },
335
350
  {
336
351
  "path": "playbooks/choose-stack.md",
@@ -482,7 +497,7 @@
482
497
  "skill-zip",
483
498
  "native-skill"
484
499
  ],
485
- "sha256": "9ff5f322e6f80b8bf9d1daa39e9416933fa7c6b911c27a0b1a134e2714ba434b"
500
+ "sha256": "dbac7440d87a85d1f8970b10938d91baa7203b5a596f1f902dfe347b5baecaad"
486
501
  },
487
502
  {
488
503
  "path": "playbooks/deploy-and-operate.md",
@@ -512,7 +527,7 @@
512
527
  "skill-zip",
513
528
  "native-skill"
514
529
  ],
515
- "sha256": "2bfc2be84723071e21dbcaa0eb607d5f08ef944b0eecc712f1ea16f95118c2a8"
530
+ "sha256": "ce3ea09b3aea6c1e1ad046bfc32c11c5502f3a206349f149b51925ae7ff4bde1"
516
531
  },
517
532
  {
518
533
  "path": "checklists/brand-and-mockups.md",
@@ -542,7 +557,22 @@
542
557
  "skill-zip",
543
558
  "native-skill"
544
559
  ],
545
- "sha256": "bf41f87f56761f15a3528a27ba56052ddfcc50a68a45766d84b61fddbba8e0d1"
560
+ "sha256": "4492d1576d276f73dcab9be83e525acf690984bb058f2139c1c703967fe1eccf"
561
+ },
562
+ {
563
+ "path": "checklists/code-quality.md",
564
+ "version": "0.1.4",
565
+ "kind": "checklist",
566
+ "active": true,
567
+ "bundles": [
568
+ "checklists"
569
+ ],
570
+ "distributions": [
571
+ "npm",
572
+ "skill-zip",
573
+ "native-skill"
574
+ ],
575
+ "sha256": "6a0346ef6678b0ed3c64ff04df93e466ae5acd8c26e34c802b78505091ae62c3"
546
576
  },
547
577
  {
548
578
  "path": "checklists/accessibility.md",
@@ -602,7 +632,7 @@
602
632
  "skill-zip",
603
633
  "native-skill"
604
634
  ],
605
- "sha256": "16e71886e51957db9e4c18758fcb5de7ba1d85ab930a199ce77e3ce9b6a08902"
635
+ "sha256": "24e633228248eccb69fb4aa5c6a4afd6481ddcbe72f3ac095cc10d53e4367dba"
606
636
  },
607
637
  {
608
638
  "path": "references/stacks/static-html.md",
@@ -722,7 +752,7 @@
722
752
  "skill-zip",
723
753
  "native-skill"
724
754
  ],
725
- "sha256": "9bb043eb71a2f9f1c8b293efa91bb1b5b844db91456571cab01e6e2f6bd60f9f"
755
+ "sha256": "2b3476d038ee0b067ea38006bcad6819ab219b5751de92f911820abe53ab501f"
726
756
  },
727
757
  {
728
758
  "path": "templates/handoff.yaml",
@@ -813,7 +843,7 @@
813
843
  "skill-zip",
814
844
  "native-skill"
815
845
  ],
816
- "sha256": "d1caaa1ecb36de1fa19439d30f18dd68f29ca512e3c9c7252804367ad128c8d3"
846
+ "sha256": "190e80ee0e8447923e71120ebb24e656168db1311f72da5049a27ac7a4229963"
817
847
  },
818
848
  {
819
849
  "path": "examples/audit-cases.md",
@@ -1004,6 +1034,7 @@
1004
1034
  "assets": [
1005
1035
  "roles/builder.md",
1006
1036
  "prompts/05-stack-and-build.md",
1037
+ "prompts/13-coding-research.md",
1007
1038
  "playbooks/choose-stack.md",
1008
1039
  "playbooks/data-and-templates.md",
1009
1040
  "playbooks/image-pipeline.md",
@@ -1012,7 +1043,8 @@
1012
1043
  "references/stacks/static-html.md",
1013
1044
  "references/stacks/scripted-static.md",
1014
1045
  "references/stacks/framework.md",
1015
- "checklists/build.md"
1046
+ "checklists/build.md",
1047
+ "checklists/code-quality.md"
1016
1048
  ],
1017
1049
  "requires": [
1018
1050
  "research",
@@ -1029,10 +1061,18 @@
1029
1061
  "B07",
1030
1062
  "B08",
1031
1063
  "B09",
1032
- "B10"
1064
+ "B10",
1065
+ "B11",
1066
+ "CQ01",
1067
+ "CQ02",
1068
+ "CQ03",
1069
+ "CQ04",
1070
+ "CQ05",
1071
+ "CQ06"
1033
1072
  ],
1034
1073
  "runtimeOutputs": [
1035
1074
  "site-work/stack.md",
1075
+ "site-work/coding-standards.md",
1036
1076
  "site-work/build/",
1037
1077
  "site-work/qa/build/",
1038
1078
  "authorized implementation_root"
@@ -1135,7 +1175,8 @@
1135
1175
  "prompts/10-adversarial-pre-ship.md",
1136
1176
  "templates/audit-brief.md",
1137
1177
  "checklists/research.md",
1138
- "checklists/ship.md"
1178
+ "checklists/ship.md",
1179
+ "checklists/code-quality.md"
1139
1180
  ],
1140
1181
  "requires": [
1141
1182
  "experience",
@@ -1147,7 +1188,13 @@
1147
1188
  "AD09",
1148
1189
  "SH01",
1149
1190
  "SH02",
1150
- "SH03"
1191
+ "SH03",
1192
+ "CQ01",
1193
+ "CQ02",
1194
+ "CQ03",
1195
+ "CQ04",
1196
+ "CQ05",
1197
+ "CQ06"
1151
1198
  ],
1152
1199
  "runtimeOutputs": [
1153
1200
  "Returned read-only findings/research/handoff; Coordinator captures site-work/review/"
@@ -1215,7 +1262,8 @@
1215
1262
  "prompts/09-security-headers.md",
1216
1263
  "prompts/10-adversarial-pre-ship.md",
1217
1264
  "prompts/11-ship-and-verify.md",
1218
- "prompts/12-web-design-team.md"
1265
+ "prompts/12-web-design-team.md",
1266
+ "prompts/13-coding-research.md"
1219
1267
  ],
1220
1268
  "playbooks": [
1221
1269
  "playbooks/choose-stack.md",
@@ -1237,6 +1285,7 @@
1237
1285
  "checklists/research.md",
1238
1286
  "checklists/brand-and-mockups.md",
1239
1287
  "checklists/build.md",
1288
+ "checklists/code-quality.md",
1240
1289
  "checklists/accessibility.md",
1241
1290
  "checklists/performance-seo.md",
1242
1291
  "checklists/security.md",
@@ -1274,6 +1323,7 @@
1274
1323
  "prompts/10-adversarial-pre-ship.md",
1275
1324
  "prompts/11-ship-and-verify.md",
1276
1325
  "prompts/12-web-design-team.md",
1326
+ "prompts/13-coding-research.md",
1277
1327
  "roles/researcher.md",
1278
1328
  "roles/coordinator.md",
1279
1329
  "roles/designer.md",
@@ -1295,6 +1345,7 @@
1295
1345
  "checklists/research.md",
1296
1346
  "checklists/brand-and-mockups.md",
1297
1347
  "checklists/build.md",
1348
+ "checklists/code-quality.md",
1298
1349
  "checklists/accessibility.md",
1299
1350
  "checklists/performance-seo.md",
1300
1351
  "checklists/security.md",
@@ -1335,6 +1386,7 @@
1335
1386
  "prompts/10-adversarial-pre-ship.md",
1336
1387
  "prompts/11-ship-and-verify.md",
1337
1388
  "prompts/12-web-design-team.md",
1389
+ "prompts/13-coding-research.md",
1338
1390
  "roles/researcher.md",
1339
1391
  "roles/coordinator.md",
1340
1392
  "roles/designer.md",
@@ -1356,6 +1408,7 @@
1356
1408
  "checklists/research.md",
1357
1409
  "checklists/brand-and-mockups.md",
1358
1410
  "checklists/build.md",
1411
+ "checklists/code-quality.md",
1359
1412
  "checklists/accessibility.md",
1360
1413
  "checklists/performance-seo.md",
1361
1414
  "checklists/security.md",
@@ -1396,6 +1449,7 @@
1396
1449
  "prompts/10-adversarial-pre-ship.md",
1397
1450
  "prompts/11-ship-and-verify.md",
1398
1451
  "prompts/12-web-design-team.md",
1452
+ "prompts/13-coding-research.md",
1399
1453
  "roles/researcher.md",
1400
1454
  "roles/coordinator.md",
1401
1455
  "roles/designer.md",
@@ -1417,6 +1471,7 @@
1417
1471
  "checklists/research.md",
1418
1472
  "checklists/brand-and-mockups.md",
1419
1473
  "checklists/build.md",
1474
+ "checklists/code-quality.md",
1420
1475
  "checklists/accessibility.md",
1421
1476
  "checklists/performance-seo.md",
1422
1477
  "checklists/security.md",
@@ -97,6 +97,7 @@ same-calendar-day currency. A decision explicitly requiring that proof stays BLO
97
97
  | 11. Hosting, deploy and DNS | Same-day check for platform capabilities, plan prices/restrictions, header syntax and deploy configuration; 90 days for DNS fundamentals. | Commercial limits and deployment contracts change quickly; name-resolution principles change slowly. Recheck the actual target before release. |
98
98
  | 12. Measurement | 30 days for setup and interpretation guidance; same-day check for selected event APIs, consent settings and receiving-property behavior. | Statistical caveats persist; vendor interfaces and active configuration do not. Changed instrumentation or property triggers verification. |
99
99
  | 13. Legal, kept light | Same-day check for exact font/stock/AI tool licenses and intended-use rights; 30 days for background guidance. | Rights attach to a particular asset, version and tier; a previously allowed use is not evidence for a new use. Changed terms or jurisdiction triggers review. |
100
+ | 14. Languages and coding practice | Same-day check for selected language, runtime and framework versions, Baseline status of features in use, and security advisories; 30 days for testing, linting and tooling guidance; 365 days for fundamentals such as semantic HTML and structural escaping. | Language support, framework idioms and advisories can change during a build; stable semantics and escaping principles need less repetition. A selected-version, browser-target or security change triggers an earlier recheck. |
100
101
 
101
102
  - Versioned standards: identify the authoritative current release as of ASK DATE and at each scheduled refresh; record release/version, target level, source and applicability. An old but still-current standard is not stale merely because its publication is old. A new relevant release triggers review before reuse even inside a nominal window.
102
103
  - Staleness artifact: generate this full table into `staleness.md`, add all applicable claims, original accesses, last revalidations, window/expiry, trigger, reason, owner and dependent receipts. Name the earliest-expiring applicable domain (all ties), its window, and concrete recheck date with the ASK DATE-relative expression. Same-day domains are due before use that day. Do not average domain windows or let a slow domain hide a fast subclaim.
@@ -251,7 +252,7 @@ site-work/
251
252
  library/ Researcher-owned canonical library.
252
253
  README.md Dated index, headline findings, role reading map.
253
254
  scope.md ASK DATE, ladder rung/raw evidence, workspace root, request, tools, applicability.
254
- coverage.md Thirteen domains, files, checklist and source coverage.
255
+ coverage.md Fourteen domains, files, checklist and source coverage.
255
256
  01-codebases-and-stacks.md Domains 1 and 2; code reads and current stacks.
256
257
  02-design-and-experience.md Domains 3 and 5; design and UI/UX.
257
258
  03-graphics-and-rights.md Domains 4 and 13; graphics and light legal.
@@ -259,6 +260,7 @@ site-work/
259
260
  05-search-and-answers.md Domains 8 and 9; SEO and AEO.
260
261
  06-security-and-delivery.md Domains 10 and 11; threats, hosts, deploy, DNS.
261
262
  07-measurement-and-operations.md Domain 12; analytics and operational follow-through.
263
+ 08-languages-and-code.md Domain 14; language support, coding practice and verification.
262
264
  sources.md Claim IDs, opened URLs, source/access dates, scope.
263
265
  receipts/
264
266
  <CLAIM-ID>.md Per-claim page fetch fields and verbatim supporting excerpt.
@@ -268,7 +270,7 @@ site-work/
268
270
  how-to-read-a-brand-kit.md Evidence into checkable design decisions.
269
271
  website-qa-checklist.md Cross-domain blocker-first index of applied checks.
270
272
  surprises.md Short findings and implications for the user.
271
- staleness.md Thirteen freshness windows relative to ASK DATE, earliest expiry, reuse decisions.
273
+ staleness.md Fourteen freshness windows relative to ASK DATE, earliest expiry, reuse decisions.
272
274
  learning.md Opened evidence, learned rules, applied checklist IDs.
273
275
  recipes.md Commands that actually ran, with tool version and what they produced.
274
276
  memory-proposal.md Durable rules and location, not a completed save.
@@ -287,6 +289,7 @@ site-work/
287
289
  11-hosting.md Preview, DNS, HTTPS, rollback, plan restrictions.
288
290
  12-measurement.md Receiving-property proof and interpretation limits.
289
291
  13-legal.md Font, stock, AI imagery, trademark evidence.
292
+ 14-code.md Supported features, tests, tooling, dependencies and secure code.
290
293
  coordinator/ Coordinator top-ups, flags, learning and QA receipts.
291
294
  designer/ Designer top-ups, flags, learning and QA receipts.
292
295
  graphics/ Graphics top-ups, flags, learning and QA receipts.
@@ -299,7 +302,7 @@ site-work/
299
302
  MEMORY.md Coordinator's consolidated durable-memory proposal.
300
303
  ```
301
304
 
302
- - Coverage: map all thirteen domains to grouped files, source claims, checks, and downstream owners.
305
+ - Coverage: map all fourteen domains to grouped files, source claims, checks, and downstream owners.
303
306
  - Exclusions: survey every domain; justify any project-specific NOT APPLICABLE check.
304
307
  - Checklists: each domain check names criterion, method, expected evidence, claim IDs, owner, status, and exclusion reason.
305
308
  - Blockers: website-qa-checklist.md collects unresolved critical checks before quality scoring.
@@ -94,6 +94,10 @@ NEXT
94
94
  - Without web search, say so, write the query plan and unresolved-claim ledger, and
95
95
  stop at the research gate; do not present unresearched output as researched.
96
96
  - Then extract the brand and show three visual mockups before writing website code.
97
+ - Builder follows prompts/05-stack-and-build.md and runs
98
+ [prompts/13-coding-research.md](13-coding-research.md) after Choose, before Build.
99
+ Learn site-work/coding-standards.md before coding and apply
100
+ [checklists/code-quality.md](../checklists/code-quality.md) during Build and Challenge.
97
101
  - Finish with the current stage, its evidence, and the next concrete action.
98
102
 
99
103
  EVIDENCE
@@ -29,7 +29,7 @@ STANDARDS
29
29
  - Research outputs are Markdown. All paths below are relative to
30
30
  site-work/research/library/ in the user's agreed project, never this skill package.
31
31
 
32
- RESEARCH THESE 13 AREAS
32
+ RESEARCH THESE 14 AREAS
33
33
  1. Reference codebases and real implementations.
34
34
  Questions: open real repositories and read the entrypoints, routes, templates,
35
35
  data models, build scripts, tests, and deploy configuration. Which patterns recur
@@ -147,10 +147,26 @@ RESEARCH THESE 13 AREAS
147
147
  determinations to the owner or qualified adviser. Do not claim legal clearance.
148
148
  Artifact: 03-graphics-and-rights.md, domain 13 rights ledger requirements and
149
149
  unresolved questions; checklists/13-legal.md with evidence and escalation paths.
150
+ 14. Languages and coding practice.
151
+ Questions: as of the ASK DATE, which current HTML semantics and elements fit
152
+ this project? Which CSS layout features, container queries, cascade layers, and
153
+ nesting patterns fit its browser targets, and what is each feature's Baseline
154
+ status? Which JavaScript and TypeScript language features, module format, and
155
+ build or bundling defaults suit the selected versions? What idioms, deprecated
156
+ APIs, and upgrade notes apply to the chosen framework version? Research unit,
157
+ integration, and end-to-end testing; linting, formatting, and type-checking;
158
+ lockfiles, version pinning, dependency audits, and minimal dependencies; secure
159
+ template and script escaping, URL validation, and keeping inline secrets out
160
+ of code; and code organization and review. Use primary sources: MDN, web.dev
161
+ Baseline status, WHATWG and W3C specifications, TC39 finished proposals,
162
+ TypeScript release notes, and official runtime, tooling, and selected-framework
163
+ documentation and changelogs. Verify support separately from proposal status.
164
+ Artifact: 08-languages-and-code.md, domain 14 dated language/support matrix and
165
+ coding guidance; checklists/14-code.md with version, quality, and secure-code checks.
150
166
 
151
167
  SAVE THE RESULTS - two places, both required:
152
168
  A. Markdown files in site-work/research/library/:
153
- - Write the seven grouped domain files named above, with all thirteen sections.
169
+ - Write the eight grouped domain files named above, with all fourteen sections.
154
170
  Survey every domain; mark genuinely inapplicable project checks with reasons.
155
171
  Extend these domains for databases, auth, payments, content workflows,
156
172
  internationalization, testing, privacy, or operations when the brief needs them.
@@ -171,7 +187,7 @@ A. Markdown files in site-work/research/library/:
171
187
  evidence needed to settle it, and current disposition. Never average claims.
172
188
  - query-plan.md and unresolved-claims.md: searches, unanswered questions, missing
173
189
  sources/tools, affected decisions, and a named next verification action.
174
- - checklists/01-codebases.md through checklists/13-legal.md: exact filenames
190
+ - checklists/01-codebases.md through checklists/14-code.md: exact filenames
175
191
  named above. One checklist per domain, with criterion, method, expected evidence,
176
192
  source claim IDs, assigned downstream owner, PASS/FAIL/BLOCKED/NOT APPLICABLE,
177
193
  and a reason for exclusions. These are applied checks, not remembered prose.
@@ -180,7 +196,7 @@ A. Markdown files in site-work/research/library/:
180
196
  concrete type, color, spacing, imagery, and motion decisions out.
181
197
  - surprises.md: a short user-facing summary of the most surprising findings,
182
198
  each linked to a claim ID and its practical consequence for this site.
183
- - staleness.md: the canonical thirteen-domain freshness table from
199
+ - staleness.md: the canonical fourteen-domain freshness table from
184
200
  playbooks/research-and-memory.md, then claim/domain, ASK DATE, window, original
185
201
  access, last revalidation, next-check date, reason, owner and dependent receipts.
186
202
  Identify the earliest-expiring domain, its window, and its ASK DATE-relative due date.
@@ -16,6 +16,12 @@ CHOOSE
16
16
  - Record alternatives, dependencies, host constraints, and the next-page editing path
17
17
  in site-work/stack.md. Verify current APIs before writing against them.
18
18
 
19
+ LEARN CODING PRACTICE
20
+ - Run [prompts/13-coding-research.md](13-coding-research.md) for the exact selected
21
+ stack and versions after CHOOSE and before IMPLEMENT.
22
+ - Read back site-work/coding-standards.md and record the rules learned before writing
23
+ code. Current sourced standards are required; unresolved research blocks coding.
24
+
19
25
  IMPLEMENT
20
26
  - Keep content, shared rendering, assets, and generated output separate.
21
27
  - Make the next page a data change wherever pages share a structure.
@@ -35,6 +41,8 @@ VERIFY
35
41
  - Exercise empty IDs, quotes, ampersands, script-terminator text, long copy,
36
42
  missing optional assets, and date boundaries using synthetic records.
37
43
  - Check the selected design at mobile and desktop sizes and preserve the evidence.
44
+ - Apply [checklists/code-quality.md](../checklists/code-quality.md) against
45
+ site-work/coding-standards.md and record command output and code-review evidence.
38
46
  - Do not deploy. Continue through experience, discovery, headers, and audit gates.
39
47
 
40
48
  HANDOFF
@@ -36,7 +36,7 @@ SET UP
36
36
  RESEARCHER
37
37
  - Own site-work/research/library/ and handoffs/researcher/; own both research resources.
38
38
  - Run prompts/01-website-deep-research.md, with the inactive graphics original as
39
- provenance. Complete all thirteen domains and their checklists current as of the ASK DATE.
39
+ provenance. Complete all fourteen domains and their checklists current as of the ASK DATE.
40
40
  - Save the library before any other role works. Gate: the library exists on disk,
41
41
  every domain this project touches has a substantive file and checklist, and every
42
42
  acted-on claim has an opened source URL, a publication/update date or explicit unknown, and an access date on or after the ASK DATE. UNVERIFIED cannot pass a claim.
@@ -67,7 +67,9 @@ GRAPHICS
67
67
 
68
68
  BUILDER
69
69
  - After mockup selection, learn codebase/stack, accessibility/performance and
70
- security/delivery research; top up chosen APIs, headers, and measurement rules.
70
+ security/delivery and language/coding research; top up chosen APIs, headers, and measurement rules.
71
+ - After Choose and before Build, run prompts/13-coding-research.md and read
72
+ site-work/coding-standards.md; apply checklists/code-quality.md to the implementation.
71
73
  - Own stack choice, implementation, performance, headers, build evidence and release.
72
74
  - Integrate Graphics and Optimizer outputs without editing their original sources.
73
75
  - Prepare the immutable candidate/audit brief; reproduce findings and test fixes.
@@ -83,6 +85,7 @@ REVIEWER
83
85
  - Last before ship, use a different model family or return INTERNAL, gate BLOCKED.
84
86
  - Learn the relevant library and top up current attack, accessibility and scanner facts.
85
87
  - Review the fixed candidate read-only; return findings and research without edits.
88
+ - Check code against site-work/coding-standards.md and checklists/code-quality.md.
86
89
  - Return reproducible evidence or an explicit scoped no-findings result.
87
90
  - Apply checklists/ship.md ASK DATE checks to library and top-ups; reject undated,
88
91
  stale-access and stamped-but-unrevalidated claims as findings.
@@ -0,0 +1,83 @@
1
+ ASK DATE prerequisite: follow playbooks/research-and-memory.md#ask-date-rule.
2
+ Researcher establishes it before intake or research; later roles read scope.md.
3
+ Never ask the user for the date or infer it from model knowledge. Apply the
4
+ same source, two-date, freshness, reuse, and blocked-gate rules to this stage.
5
+
6
+ Research how to code this project's selected stack before writing website code.
7
+ Run as Builder after CHOOSE in [prompts/05-stack-and-build.md](05-stack-and-build.md)
8
+ and before IMPLEMENT. Require accepted research, a named mockup selection, and
9
+ site-work/stack.md with the selected stack and exact versions.
10
+
11
+ LEARN
12
+ - Read site-work/research/library/README.md, scope.md, coverage.md, sources.md,
13
+ staleness.md, 08-languages-and-code.md, and checklists/14-code.md.
14
+ - Read the approved brief, browser targets, host constraints, and stack.md.
15
+ Top up the chosen path and its unresolved questions against the saved library.
16
+ - Return stale or wrong library claims to Researcher with claim IDs and evidence;
17
+ resume affected decisions after a corrected library receipt.
18
+
19
+ RESEARCH
20
+ - Open primary sources as of the ASK DATE: MDN, web.dev Baseline status, WHATWG
21
+ and W3C specifications, TC39 finished proposals, TypeScript release notes, and
22
+ the selected runtime, framework, package manager, and tools' official docs,
23
+ changelogs, upgrade guides, and security advisories.
24
+ - Verify the exact selected language targets, runtime and framework versions,
25
+ supported combinations, module format, and build or bundling defaults. For
26
+ living standards, record the dated specification and browser targets; for an
27
+ absent runtime, compiler, or framework, record NOT APPLICABLE with a reason.
28
+ - Research current HTML semantics and elements; CSS layout, container queries,
29
+ cascade layers, and nesting; and JavaScript/TypeScript features for this stack.
30
+ Record each proposed feature's Baseline or target browser/runtime support and
31
+ the fallback or exclusion when support misses the project's targets. For
32
+ compiler-only features, mark Baseline NOT APPLICABLE and cite compiler support.
33
+ Verify implementation support separately from a proposal being finished.
34
+ - Identify the selected framework version's idioms, deprecated APIs, replacement
35
+ patterns, and upgrade notes. Map organization rules to this project's routes,
36
+ components, data, rendering, tests, and generated output.
37
+ - Select unit, integration, and end-to-end checks for the actual failure modes.
38
+ Verify lint, format, and type-check tools and commands for the pinned versions.
39
+ Give any inapplicable test level or tool a project-specific reason.
40
+ - Define dependency hygiene: justify each dependency, pin direct versions and
41
+ toolchain versions, preserve the lockfile, use reproducible install commands,
42
+ audit advisories, and record findings, owners, and update/recheck decisions.
43
+ - Research secure template and script handling for the actual stack: structural
44
+ escaping by output context, script-safe serialization, URL scheme validation,
45
+ input validation, and secrets supplied through the server-side environment.
46
+ Keep secrets out of inline scripts, client bundles, source, and recorded output.
47
+ - For every dated claim, save the opened URL, publication/update date or unknown,
48
+ actual access date, and supporting evidence under site-work/research/builder/.
49
+ Record fetched-page receipts when opening sources using templates/evidence.md.
50
+ Keep disagreements and unresolved claims explicit. Apply the canonical freshness
51
+ windows and later-day rechecks before using a claim.
52
+
53
+ SAVE AND INGEST
54
+ Write site-work/coding-standards.md, opening with "Research as of <ASK DATE>".
55
+ Include these sections:
56
+ 1. Pinned language, runtime, framework, and tooling versions or dated targets,
57
+ with source URLs, source dates, access dates, and relevant claim IDs.
58
+ 2. Features to use, each with Baseline or target support status and any fallback.
59
+ 3. Deprecated APIs and patterns to avoid, with their supported replacements.
60
+ 4. Project commands for unit, integration, and end-to-end tests, linting,
61
+ formatting, and type-checking, including working directory and prerequisites.
62
+ Label commands PLANNED until executed; link actual command output after Build.
63
+ 5. Dependency policy, lockfile and pinning rules, install/audit commands, advisory
64
+ handling, and the reason each dependency is needed.
65
+ 6. Secure-coding rules for this stack, with concrete adverse cases to verify.
66
+ 7. Code organization rules and a short code-review checklist tied to these choices.
67
+
68
+ Reopen the standards file and record its revision, learned rules, and applied
69
+ claim/check IDs in site-work/research/builder/learning.md before implementation.
70
+ Use [checklists/code-quality.md](../checklists/code-quality.md) during Build and
71
+ include its receipts and the standards file in the Reviewer packet. Revalidate
72
+ affected standards when selected versions, requirements, or source freshness change.
73
+
74
+ BLOCKED RESEARCH
75
+ If search or source access is unavailable, follow playbooks/research-and-memory.md:
76
+ return a query plan and unresolved-claim ledger for the selected stack, keep research
77
+ BLOCKED, and stop before implementation. Training memory or a previous library
78
+ does not pass current research. If file writing is unavailable, return named file
79
+ bodies for saving and read-back before the standards gate can pass.
80
+
81
+ EVIDENCE
82
+ Never report a measured, saved, installed, or deployed result without evidence.
83
+ Apply the stage route and named checks in manifest.json before handing off.
@@ -4,7 +4,7 @@ You are Website Builder, accountable for implementation, performance, headers, a
4
4
 
5
5
  ## WHAT YOU OWN
6
6
 
7
- Write site-work/stack.md, build/, qa/build/, qa/site-audit.md,
7
+ Write site-work/stack.md, coding-standards.md, build/, qa/build/, qa/site-audit.md,
8
8
  qa/accessibility.md, qa/contrast.md, qa/security-headers.md, audit/, release/,
9
9
  research/builder/, and handoffs/builder/. Own the authorized implementation_root
10
10
  recorded in site-work/ownership.yaml and its SITE_OPERATIONS.md. Only you materialize
@@ -31,18 +31,22 @@ disagreements.md, unresolved-claims.md, and staleness.md in that same directory.
31
31
  Verify the research gate and current revision before doing your job. Then read
32
32
  site-work/research/library/01-codebases-and-stacks.md,
33
33
  04-accessibility-and-performance.md, 06-security-and-delivery.md,
34
- 07-measurement-and-operations.md, and 05-search-and-answers.md for integration.
34
+ 07-measurement-and-operations.md, 08-languages-and-code.md, and
35
+ 05-search-and-answers.md for integration.
35
36
  Apply library checklists/01-codebases.md, 02-stacks.md, 05-ui-ux.md,
36
- 06-accessibility.md, 07-performance.md, 10-security.md, and 11-hosting.md.
37
+ 06-accessibility.md, 07-performance.md, 10-security.md, 11-hosting.md, and 14-code.md.
37
38
  Learn the smallest-stack decision from playbooks/choose-stack.md and
38
39
  references/stacks/static-html.md, scripted-static.md, and framework.md.
39
40
  Read site-work/research/library/recipes.md for build and asset commands already proven here,
40
41
  and append the ones you get working.
41
42
  Read playbooks/data-and-templates.md, image-pipeline.md, self-hosted-fonts.md,
42
43
  embed-facades.md, security-headers.md, performance-budgets.md, accessibility.md,
43
- and deploy-and-operate.md. Read checklists/build.md, accessibility.md, security.md,
44
- ship.md; prompts/05-stack-and-build.md, 09-security-headers.md,
45
- 10-adversarial-pre-ship.md, 11-ship-and-verify.md; templates/audit-brief.md.
44
+ and deploy-and-operate.md. Read checklists/build.md, code-quality.md,
45
+ accessibility.md, security.md, ship.md; prompts/05-stack-and-build.md, 09-security-headers.md,
46
+ 10-adversarial-pre-ship.md, 11-ship-and-verify.md, 13-coding-research.md;
47
+ templates/audit-brief.md. After choosing the stack, run prompts/13-coding-research.md,
48
+ then read and ingest site-work/coding-standards.md before writing code. Record the
49
+ standards revision and learned rules in research/builder/learning.md.
46
50
  Record the checklist IDs and research decisions used before coding.
47
51
 
48
52
  ## WHAT YOU MUST RESEARCH
@@ -95,7 +99,8 @@ For release, require release-to-builder with authority and final gate receipts.
95
99
 
96
100
  ## YOUR OUTPUTS
97
101
 
98
- Produce stack.md with alternatives and requirement mapping; source and generated
102
+ Produce stack.md with alternatives and requirement mapping; coding-standards.md
103
+ with current selected-stack rules and source evidence; source and generated
99
104
  artifact at implementation_root; reproducible build/tests, QA evidence, response
100
105
  headers, audit/AUDIT_BRIEF.md with ROUND 1 dispositions, release receipt/rollback
101
106
  identity, and SITE_OPERATIONS.md. Name what watches the site, including nothing.
@@ -106,8 +111,9 @@ learned rules, source IDs, and applied checks. A proposal is not a completed sav
106
111
 
107
112
  ## YOUR GATE
108
113
 
109
- Before coding, require selected mockup plus current sourced research. Validate
110
- fallible data, context-specific escaping, script terminators, URL schemes, empty IDs,
114
+ Before coding, require selected mockup, current sourced research, and saved/read-back
115
+ coding-standards.md. Apply checklists/code-quality.md to the candidate before handoff.
116
+ Validate fallible data, context-specific escaping, script terminators, URL schemes, empty IDs,
111
117
  and shared state. Prove the next repeated page is a data change. Run relevant
112
118
  accessibility, performance, discovery and header checks on rendered output.
113
119
  Use the current library's standards and the declared package defaults separately.
@@ -33,12 +33,13 @@ 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
  02-design-and-experience.md, 03-graphics-and-rights.md,
35
35
  04-accessibility-and-performance.md, 05-search-and-answers.md,
36
- 06-security-and-delivery.md, and 07-measurement-and-operations.md in that directory.
36
+ 06-security-and-delivery.md, 07-measurement-and-operations.md, and
37
+ 08-languages-and-code.md in that directory.
37
38
  Learn stage acceptance from SKILL.md, prompts/00-start.md,
38
39
  prompts/12-web-design-team.md, playbooks/research-and-memory.md,
39
40
  playbooks/deploy-and-operate.md, checklists/research.md, checklists/ship.md,
40
41
  templates/brief.md, templates/status.md, and templates/handoff.yaml.
41
- Open all thirteen library checklists and assign an accountable downstream owner.
42
+ Open all fourteen library checklists and assign an accountable downstream owner.
42
43
  Record learned rules and applied checklist evidence in your learning receipts.
43
44
 
44
45
  ## WHAT YOU MUST RESEARCH