Skip to content

[NO-ISSUE] docs: webkit guardrails coverage guide#723

Closed
HerbertJulio wants to merge 1 commit into
devfrom
docs/webkit-guardrails-coverage
Closed

[NO-ISSUE] docs: webkit guardrails coverage guide#723
HerbertJulio wants to merge 1 commit into
devfrom
docs/webkit-guardrails-coverage

Conversation

@HerbertJulio

@HerbertJulio HerbertJulio commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds docs/webkit-guardrails.md — a single reference for what webkit enforces and where, split by the two frontiers it protects (build correctly / consume correctly).

It documents:

  • Lint coverage — internal (contributor: root ESLint/Stylelint + the validate-tokens authoring hook) and consumer (the eslint-plugin-webkit rules + stylelint-config-webkit, reading the version-locked catalog), incl. which rules autofix.
  • Spec coverage for new components — the .specs contract, the 10 rules, the 6 blocking hooks, and the /spec-create/component-create/component-verify pipeline.
  • Existing components — editing (hooks re-fire) and migrating legacy components off the whitelist.
  • Using webkit in other projects — the adoption toolkit: catalog.json → FORCE (lint) + GUIDE (MCP incl. list_tokens + Claude bundle) → webkit-cli init / doctor.

Docs-only; separate from the toolkit code PR (#717) per .claude/rules/git-workflow.md.

A single reference for what webkit enforces and where: the lint coverage (internal
contributor + consumer toolkit), the spec contract + rules + hooks + pipeline for creating
new components, editing/migrating existing ones, and using webkit in other projects via
the adoption toolkit (catalog + FORCE + GUIDE).
@HerbertJulio HerbertJulio requested a review from a team as a code owner July 6, 2026 17:21
@HerbertJulio

Copy link
Copy Markdown
Contributor Author

Fechando: a doc de cobertura não vai para o repositório — fica local. O toolkit está todo no #717 (PR único).

@HerbertJulio HerbertJulio deleted the docs/webkit-guardrails-coverage branch July 6, 2026 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant