diff --git a/skills/agentforce-architecture-analyze/README.md b/skills/agentforce-architecture-analyze/README.md index 72a2a45..f0e44c7 100644 --- a/skills/agentforce-architecture-analyze/README.md +++ b/skills/agentforce-architecture-analyze/README.md @@ -73,12 +73,11 @@ agentforce-architecture-analyze/ │ ├── finalize.py Merge waves → metadata_tree.json │ ├── render_architecture.py architecture.md + Mermaid graph │ ├── resolve_invocation_target.py ID-prefix router for NGA InvocationTargets +│ ├── emit_env.py Env-var emit helper (Phase 0.5) +│ ├── emit_result.py Final RESULT block renderer +│ ├── sanitize.py Stdin → safe-string filter +│ ├── write_emit_ctx.py Per-phase ctx writer │ └── tests/ Unit + integration tests (unittest) -└── tools/ - ├── emit_env.py Env-var emit helper (Phase 0.5) - ├── emit_result.py Final RESULT block renderer - ├── sanitize.py Stdin → safe-string filter - └── write_emit_ctx.py Per-phase ctx writer ``` --- diff --git a/skills/agentforce-architecture-analyze/SKILL.md b/skills/agentforce-architecture-analyze/SKILL.md index 1f52efe..4b36bba 100644 --- a/skills/agentforce-architecture-analyze/SKILL.md +++ b/skills/agentforce-architecture-analyze/SKILL.md @@ -135,7 +135,7 @@ set -e # Final RESULT block is emit_result.py's stdout — MUST be the last thing # stdout sees. emit_result exits 0 on render success; the bash harness # propagates main.py's rc for the agent's exit status. -WORK_DIR="$WORK_DIR" python3 "$SKILL_ROOT/tools/emit_result.py" +WORK_DIR="$WORK_DIR" python3 "$SKILL_ROOT/scripts/emit_result.py" exit "$_rc" ``` diff --git a/skills/agentforce-architecture-analyze/tools/emit_env.py b/skills/agentforce-architecture-analyze/scripts/emit_env.py similarity index 100% rename from skills/agentforce-architecture-analyze/tools/emit_env.py rename to skills/agentforce-architecture-analyze/scripts/emit_env.py diff --git a/skills/agentforce-architecture-analyze/tools/emit_result.py b/skills/agentforce-architecture-analyze/scripts/emit_result.py similarity index 100% rename from skills/agentforce-architecture-analyze/tools/emit_result.py rename to skills/agentforce-architecture-analyze/scripts/emit_result.py diff --git a/skills/agentforce-architecture-analyze/tools/sanitize.py b/skills/agentforce-architecture-analyze/scripts/sanitize.py similarity index 93% rename from skills/agentforce-architecture-analyze/tools/sanitize.py rename to skills/agentforce-architecture-analyze/scripts/sanitize.py index 6c3864f..a0c0f5c 100755 --- a/skills/agentforce-architecture-analyze/tools/sanitize.py +++ b/skills/agentforce-architecture-analyze/scripts/sanitize.py @@ -10,7 +10,7 @@ or malformed input could inject fake KEY=VALUE pairs that downstream consumers would treat as authoritative. Usage: - _safe=$(python3 "$SKILL/tools/sanitize.py" "$raw_value") + _safe=$(python3 "$SKILL/scripts/sanitize.py" "$raw_value") Arguments: argv[1] raw string (may be empty) diff --git a/skills/agentforce-architecture-analyze/scripts/tests/_bootstrap.py b/skills/agentforce-architecture-analyze/scripts/tests/_bootstrap.py index 8486742..88e1e79 100644 --- a/skills/agentforce-architecture-analyze/scripts/tests/_bootstrap.py +++ b/skills/agentforce-architecture-analyze/scripts/tests/_bootstrap.py @@ -6,7 +6,7 @@ does `from config import ...`. Tests mirror that by inserting scripts/ onto sys.path. fs_guard is now sourced via ``from config import fs_guard`` (config.py -re-exports it from the plugin _shared/ package). No tools/ entry on +re-exports it from the plugin _shared/ package). No separate entry on sys.path is required — config.py's dev-fallback walks up to the repo's ``plugins/investigating-agentforce-architecture/shared/`` when ``scripts/_shared/`` hasn't yet been mirrored by install.sh / the build script. diff --git a/skills/agentforce-architecture-analyze/scripts/tests/test_end_to_end_fixture.py b/skills/agentforce-architecture-analyze/scripts/tests/test_end_to_end_fixture.py index a03dcb4..beb6b74 100644 --- a/skills/agentforce-architecture-analyze/scripts/tests/test_end_to_end_fixture.py +++ b/skills/agentforce-architecture-analyze/scripts/tests/test_end_to_end_fixture.py @@ -44,10 +44,10 @@ from tests.fixtures import genai_payloads as fx # type: ignore _REPO_SOQL_DIR = Path(__file__).resolve().parent.parent.parent / "assets" / "soql" soql_loader.SOQL_DIR = _REPO_SOQL_DIR -# emit_result.py lives under tools/; tests invoke it via subprocess so the +# emit_result.py lives under scripts/; tests invoke it via subprocess so the # tool's RESULT-formatting logic is exercised under the same contract the # SKILL.md Bash wrapper uses. -_TOOLS_DIR = Path(__file__).resolve().parent.parent.parent / "tools" +_TOOLS_DIR = Path(__file__).resolve().parent.parent # --------------------------------------------------------------------------- diff --git a/skills/agentforce-architecture-analyze/scripts/tests/test_write_emit_ctx.py b/skills/agentforce-architecture-analyze/scripts/tests/test_write_emit_ctx.py index 4db3d24..c15f078 100644 --- a/skills/agentforce-architecture-analyze/scripts/tests/test_write_emit_ctx.py +++ b/skills/agentforce-architecture-analyze/scripts/tests/test_write_emit_ctx.py @@ -32,9 +32,9 @@ from . import _bootstrap # noqa: F401 def _tools_dir() -> pathlib.Path: - """Absolute path to the skill's tools/ dir — where the scripts live.""" + """Absolute path to the skill's scripts/ dir — where the emit helpers live.""" here = pathlib.Path(__file__).resolve() - return here.parent.parent.parent / "tools" + return here.parent.parent def _run_script(script_name: str, env: dict) -> subprocess.CompletedProcess: @@ -439,7 +439,7 @@ class EmitResultPositionalSafetyTests(unittest.TestCase): def test_build_block_happy_path_auto_promotes_without_asserting(self): """Sanity: the assertion does NOT fire under normal operation.""" - # Force import of emit_result from the tools/ dir. + # Force import of emit_result from the scripts/ dir. import importlib.util spec = importlib.util.spec_from_file_location( "emit_result_mod", _tools_dir() / "emit_result.py", diff --git a/skills/agentforce-architecture-analyze/tools/write_emit_ctx.py b/skills/agentforce-architecture-analyze/scripts/write_emit_ctx.py similarity index 99% rename from skills/agentforce-architecture-analyze/tools/write_emit_ctx.py rename to skills/agentforce-architecture-analyze/scripts/write_emit_ctx.py index 756d90a..55d7a26 100755 --- a/skills/agentforce-architecture-analyze/tools/write_emit_ctx.py +++ b/skills/agentforce-architecture-analyze/scripts/write_emit_ctx.py @@ -83,7 +83,7 @@ import sys # local, dependency-free token scrub mirroring the patterns in # `scripts/rest_client.redact_text`. Keeping the redactor inline preserves -# the tools/ <-> scripts/ decoupling (tools/ is stdlib-only by policy) and +# the scripts/ emit helpers (stdlib-only by policy) and # avoids adding a sys.path hop on every write_emit_ctx invocation. The two # implementations must stay in sync; the shared regex shapes are: # * Authorization: Bearer diff --git a/skills/agentforce-observe/apex/AgentforceOptimizeService.cls b/skills/agentforce-observe/assets/apex/AgentforceOptimizeService.cls similarity index 100% rename from skills/agentforce-observe/apex/AgentforceOptimizeService.cls rename to skills/agentforce-observe/assets/apex/AgentforceOptimizeService.cls diff --git a/skills/agentforce-observe/apex/AgentforceOptimizeService.cls-meta.xml b/skills/agentforce-observe/assets/apex/AgentforceOptimizeService.cls-meta.xml similarity index 100% rename from skills/agentforce-observe/apex/AgentforceOptimizeService.cls-meta.xml rename to skills/agentforce-observe/assets/apex/AgentforceOptimizeService.cls-meta.xml diff --git a/skills/agentforce-observe/references/stdm-queries.md b/skills/agentforce-observe/references/stdm-queries.md index 1e0851d..b214031 100644 --- a/skills/agentforce-observe/references/stdm-queries.md +++ b/skills/agentforce-observe/references/stdm-queries.md @@ -24,9 +24,9 @@ Methods: mkdir -p /force-app/main/default/classes # Copy from the skill's apex directory -cp ../apex/AgentforceOptimizeService.cls \ +cp ../assets/apex/AgentforceOptimizeService.cls \ /force-app/main/default/classes/ -cp ../apex/AgentforceOptimizeService.cls-meta.xml \ +cp ../assets/apex/AgentforceOptimizeService.cls-meta.xml \ /force-app/main/default/classes/ ``` diff --git a/skills/automation-flow-generate/SKILL.md b/skills/automation-flow-generate/SKILL.md index c26a161..4fe780e 100644 --- a/skills/automation-flow-generate/SKILL.md +++ b/skills/automation-flow-generate/SKILL.md @@ -189,7 +189,7 @@ When no custom objects needed: - `referenceTo`: (Lookup only) The target object API name - Include only objects and fields that are relevant to the flow being generated -## 🎯 Mandatory Enhancement Rules +## Mandatory Enhancement Rules - **userPrompt**: REQUIRED. - If the user requests a **single flow**: use the user's prompt as-is. - If the user requests **multiple flows**: you MUST **split** the request and write a **separate, focused `userPrompt` for each individual flow**. Each `userPrompt` must describe only ONE flow. Do NOT pass the entire multi-flow request as a single `userPrompt`. See the multiple flows section below for examples. diff --git a/skills/design-systems-slds-apply/SKILL.md b/skills/design-systems-slds-apply/SKILL.md index f1df972..8a979b3 100644 --- a/skills/design-systems-slds-apply/SKILL.md +++ b/skills/design-systems-slds-apply/SKILL.md @@ -85,7 +85,7 @@ If no LBC exists (or not using LWC), select an SLDS Blueprint. See [references/c ## Hook Naming Traps -SLDS hook families do NOT all follow the same naming pattern. Agents frequently invent hooks that don't exist by assuming `{prefix}-{number}` works universally. **Always verify a hook exists** via the bundled `search-hooks.cjs` script or `metadata/hooks-index.json` before using it. +SLDS hook families do NOT all follow the same naming pattern. Agents frequently invent hooks that don't exist by assuming `{prefix}-{number}` works universally. **Always verify a hook exists** via the bundled `search-hooks.cjs` script or `assets/hooks-index.json` before using it. ### Trap 1: Font size hooks are NOT numbered @@ -130,10 +130,10 @@ Run the appropriate search command **before** emitting any SLDS artifact: | Artifact | Verification command | Source of truth | |----------|---------------------|-----------------| -| Styling hook (`--slds-g-*`) | `node scripts/search-hooks.cjs --prefix ""` | `metadata/hooks-index.json` | -| Utility class (`slds-*`) | `node scripts/search-utilities.cjs --search ""` | `metadata/utilities-index.json` | -| Blueprint / CSS class | `node scripts/search-blueprints.cjs --search ""` then read the YAML | `metadata/blueprints/components/*.yaml` | -| Icon | `node scripts/search-icons.cjs --query ""` | `metadata/icon-metadata.json` | +| Styling hook (`--slds-g-*`) | `node scripts/search-hooks.cjs --prefix ""` | `assets/hooks-index.json` | +| Utility class (`slds-*`) | `node scripts/search-utilities.cjs --search ""` | `assets/utilities-index.json` | +| Blueprint / CSS class | `node scripts/search-blueprints.cjs --search ""` then read the YAML | `assets/blueprints/components/*.yaml` | +| Icon | `node scripts/search-icons.cjs --query ""` | `assets/icon-metadata.json` | If the search returns no match: **do not use the artifact.** Find an alternative from the search results or build custom with verified hooks. @@ -187,10 +187,10 @@ This skill bundles comprehensive SLDS knowledge. Read files as needed -- don't r | Folder | Content | Index | |--------|---------|-------| -| `guidance/overviews/` | Foundational concepts (color, spacing, typography, etc.) | [guidance/README.md](guidance/README.md) | -| `guidance/styling-hooks/` | Hook categories with detailed usage | [guidance/README.md](guidance/README.md) | -| `guidance/utilities/` | 27 utility class categories | [guidance/README.md](guidance/README.md) | -| `guidance/slds-development-guide.md` | Full SLDS development guide | -- | +| `references/overviews/` | Foundational concepts (color, spacing, typography, etc.) | [references/README.md](references/README.md) | +| `references/styling-hooks/` | Hook categories with detailed usage | [references/README.md](references/README.md) | +| `references/utilities/` | 27 utility class categories | [references/README.md](references/README.md) | +| `references/slds-development-guide.md` | Full SLDS development guide | -- | ### Raw Metadata (structured data for lookup) @@ -198,10 +198,10 @@ This skill bundles comprehensive SLDS knowledge. Read files as needed -- don't r | File | Content | Lines | |------|---------|-------| -| `metadata/blueprints/components/*.yaml` | 85 blueprint specs (classes, variants, a11y, HTML) | ~50-200 each | -| `metadata/hooks-index.json` | 523 hooks with values and CSS properties | ~6,300 | -| `metadata/icon-metadata.json` | 1,732 icons with synonyms for search | ~38,500 | -| `metadata/utilities-index.json` | 1,147 utility classes with CSS rules | ~6,900 | +| `assets/blueprints/components/*.yaml` | 85 blueprint specs (classes, variants, a11y, HTML) | ~50-200 each | +| `assets/hooks-index.json` | 523 hooks with values and CSS properties | ~6,300 | +| `assets/icon-metadata.json` | 1,732 icons with synonyms for search | ~38,500 | +| `assets/utilities-index.json` | 1,147 utility classes with CSS rules | ~6,900 | --- @@ -219,7 +219,7 @@ Identify: 1. **If LWC**: Check the [Lightning Component Library](https://developer.salesforce.com/docs/component-library/overview/components) for an LBC 2. **Search blueprints**: `node scripts/search-blueprints.cjs --search ""` -3. **Read the blueprint YAML**: `metadata/blueprints/components/.yaml` for exact classes, modifiers, states, and accessibility requirements +3. **Read the blueprint YAML**: `assets/blueprints/components/.yaml` for exact classes, modifiers, states, and accessibility requirements 4. **No match?** Build custom with hooks (see Phase 3) Details: [references/component-selection.md](references/component-selection.md) @@ -249,7 +249,7 @@ npx @salesforce-ux/slds-linter@latest lint The linter catches hardcoded values, class overrides, and deprecated tokens. **Fix all violations before proceeding.** Do not rationalize violations as acceptable. -**Step 2: Verify no invented hooks.** Confirm every `--slds-g-*` hook in the output exists in `metadata/hooks-index.json`. Cross-reference against the T051 check in [checklists.md](checklists.md). +**Step 2: Verify no invented hooks.** Confirm every `--slds-g-*` hook in the output exists in `assets/hooks-index.json`. Cross-reference against the T051 check in [checklists.md](checklists.md). **Step 3: Run through [checklists.md](checklists.md)** for the checks the linter cannot automate: - All `var(--slds-g-*)` have fallback values (T002) diff --git a/skills/design-systems-slds-apply/metadata/README.md b/skills/design-systems-slds-apply/assets/README.md similarity index 100% rename from skills/design-systems-slds-apply/metadata/README.md rename to skills/design-systems-slds-apply/assets/README.md diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/accordion.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/accordion.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/accordion.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/accordion.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/activity-timeline.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/activity-timeline.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/activity-timeline.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/activity-timeline.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/alert.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/alert.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/alert.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/alert.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/app-launcher.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/app-launcher.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/app-launcher.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/app-launcher.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/avatar-group.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/avatar-group.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/avatar-group.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/avatar-group.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/avatar.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/avatar.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/avatar.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/avatar.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/badges.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/badges.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/badges.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/badges.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/brand-band.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/brand-band.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/brand-band.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/brand-band.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/breadcrumbs.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/breadcrumbs.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/breadcrumbs.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/breadcrumbs.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/builder-header.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/builder-header.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/builder-header.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/builder-header.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/button-groups.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/button-groups.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/button-groups.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/button-groups.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/button-icons.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/button-icons.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/button-icons.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/button-icons.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/buttons.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/buttons.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/buttons.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/buttons.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/cards.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/cards.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/cards.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/cards.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/carousel.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/carousel.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/carousel.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/carousel.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/chat.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/chat.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/chat.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/chat.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/checkbox-button-group.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/checkbox-button-group.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/checkbox-button-group.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/checkbox-button-group.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/checkbox-button.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/checkbox-button.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/checkbox-button.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/checkbox-button.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/checkbox-toggle.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/checkbox-toggle.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/checkbox-toggle.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/checkbox-toggle.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/checkbox.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/checkbox.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/checkbox.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/checkbox.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/color-picker.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/color-picker.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/color-picker.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/color-picker.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/combobox.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/combobox.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/combobox.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/combobox.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/counter.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/counter.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/counter.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/counter.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/data-tables.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/data-tables.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/data-tables.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/data-tables.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/datepickers.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/datepickers.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/datepickers.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/datepickers.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/datetime-picker.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/datetime-picker.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/datetime-picker.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/datetime-picker.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/docked-composer.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/docked-composer.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/docked-composer.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/docked-composer.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/docked-form-footer.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/docked-form-footer.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/docked-form-footer.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/docked-form-footer.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/docked-utility-bar.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/docked-utility-bar.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/docked-utility-bar.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/docked-utility-bar.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/drop-zone.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/drop-zone.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/drop-zone.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/drop-zone.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/dueling-picklist.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/dueling-picklist.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/dueling-picklist.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/dueling-picklist.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/dynamic-icons.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/dynamic-icons.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/dynamic-icons.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/dynamic-icons.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/dynamic-menu.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/dynamic-menu.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/dynamic-menu.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/dynamic-menu.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/expandable-section.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/expandable-section.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/expandable-section.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/expandable-section.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/expression.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/expression.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/expression.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/expression.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/feeds.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/feeds.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/feeds.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/feeds.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/file-selector.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/file-selector.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/file-selector.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/file-selector.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/files.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/files.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/files.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/files.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/form-element.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/form-element.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/form-element.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/form-element.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/global-header.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/global-header.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/global-header.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/global-header.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/global-navigation.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/global-navigation.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/global-navigation.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/global-navigation.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/icons.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/icons.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/icons.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/icons.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/illustration.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/illustration.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/illustration.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/illustration.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/input.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/input.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/input.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/input.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/list-builder.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/list-builder.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/list-builder.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/list-builder.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/lookups.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/lookups.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/lookups.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/lookups.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/map.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/map.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/map.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/map.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/menus.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/menus.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/menus.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/menus.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/modals.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/modals.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/modals.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/modals.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/notifications.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/notifications.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/notifications.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/notifications.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/page-headers.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/page-headers.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/page-headers.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/page-headers.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/panels.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/panels.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/panels.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/panels.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/path.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/path.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/path.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/path.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/picklist.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/picklist.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/picklist.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/picklist.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/pills.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/pills.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/pills.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/pills.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/popovers.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/popovers.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/popovers.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/popovers.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/progress-bar.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/progress-bar.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/progress-bar.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/progress-bar.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/progress-indicator.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/progress-indicator.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/progress-indicator.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/progress-indicator.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/progress-ring.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/progress-ring.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/progress-ring.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/progress-ring.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/prompt.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/prompt.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/prompt.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/prompt.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/publishers.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/publishers.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/publishers.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/publishers.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/radio-button-group.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/radio-button-group.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/radio-button-group.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/radio-button-group.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/radio-group.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/radio-group.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/radio-group.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/radio-group.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/rich-text-editor.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/rich-text-editor.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/rich-text-editor.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/rich-text-editor.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/scoped-notifications.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/scoped-notifications.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/scoped-notifications.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/scoped-notifications.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/scoped-tabs.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/scoped-tabs.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/scoped-tabs.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/scoped-tabs.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/select.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/select.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/select.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/select.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/setup-assistant.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/setup-assistant.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/setup-assistant.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/setup-assistant.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/slider.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/slider.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/slider.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/slider.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/spinners.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/spinners.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/spinners.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/spinners.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/split-view.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/split-view.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/split-view.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/split-view.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/summary-detail.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/summary-detail.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/summary-detail.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/summary-detail.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/tabs.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/tabs.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/tabs.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/tabs.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/textarea.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/textarea.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/textarea.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/textarea.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/tiles.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/tiles.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/tiles.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/tiles.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/timepicker.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/timepicker.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/timepicker.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/timepicker.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/toast.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/toast.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/toast.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/toast.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/tooltips.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/tooltips.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/tooltips.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/tooltips.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/tree-grid.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/tree-grid.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/tree-grid.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/tree-grid.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/trees.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/trees.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/trees.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/trees.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/trial-bar.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/trial-bar.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/trial-bar.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/trial-bar.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/vertical-navigation.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/vertical-navigation.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/vertical-navigation.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/vertical-navigation.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/vertical-tabs.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/vertical-tabs.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/vertical-tabs.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/vertical-tabs.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/visual-picker.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/visual-picker.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/visual-picker.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/visual-picker.yaml diff --git a/skills/design-systems-slds-apply/metadata/blueprints/components/welcome-mat.yaml b/skills/design-systems-slds-apply/assets/blueprints/components/welcome-mat.yaml similarity index 100% rename from skills/design-systems-slds-apply/metadata/blueprints/components/welcome-mat.yaml rename to skills/design-systems-slds-apply/assets/blueprints/components/welcome-mat.yaml diff --git a/skills/design-systems-slds-apply/metadata/hooks-index.json b/skills/design-systems-slds-apply/assets/hooks-index.json similarity index 100% rename from skills/design-systems-slds-apply/metadata/hooks-index.json rename to skills/design-systems-slds-apply/assets/hooks-index.json diff --git a/skills/design-systems-slds-apply/metadata/icon-metadata.json b/skills/design-systems-slds-apply/assets/icon-metadata.json similarity index 100% rename from skills/design-systems-slds-apply/metadata/icon-metadata.json rename to skills/design-systems-slds-apply/assets/icon-metadata.json diff --git a/skills/design-systems-slds-apply/metadata/utilities-index.json b/skills/design-systems-slds-apply/assets/utilities-index.json similarity index 100% rename from skills/design-systems-slds-apply/metadata/utilities-index.json rename to skills/design-systems-slds-apply/assets/utilities-index.json diff --git a/skills/design-systems-slds-apply/checklists.md b/skills/design-systems-slds-apply/checklists.md index 7a43725..b0d2bbb 100644 --- a/skills/design-systems-slds-apply/checklists.md +++ b/skills/design-systems-slds-apply/checklists.md @@ -22,7 +22,7 @@ Code produced by this skill should score high on T-series checks. | **Shadow hooks** | Shadows use `var(--slds-g-shadow-*)` | T040 | | **Border radius hooks** | Border radius uses `var(--slds-g-radius-*)` | T041 | | **Color hooks numbered** | Every `--slds-g-color-*` hook ends in a number (no bare `on-surface`, `on-accent`, etc.) | T050 | -| **No invented hooks** | Every hook referenced actually exists in `metadata/hooks-index.json` | T051 | +| **No invented hooks** | Every hook referenced actually exists in `assets/hooks-index.json` | T051 | | **No hardcoded colors** | No hex, rgb, or named colors (linter also catches this) | linter | | **No class overrides** | No `.slds-*` class overrides (linter also catches this) | linter | | **No deprecated tokens** | No `--lwc-*` tokens (linter also catches this) | linter | diff --git a/skills/design-systems-slds-apply/examples.md b/skills/design-systems-slds-apply/examples.md index b2180e8..205d130 100644 --- a/skills/design-systems-slds-apply/examples.md +++ b/skills/design-systems-slds-apply/examples.md @@ -24,7 +24,7 @@ node scripts/search-blueprints.cjs --search "modal" # Found: Modals (category: Overlay, root: slds-modal) ``` -**Read blueprint YAML** for class details: `metadata/blueprints/components/modals.yaml` +**Read blueprint YAML** for class details: `assets/blueprints/components/modals.yaml` Key takeaway: `LightningModal` handles the `slds-modal`, `slds-backdrop`, and ARIA attributes automatically. No need to apply blueprint classes manually in LWC. @@ -99,8 +99,8 @@ node scripts/search-blueprints.cjs --search "badge" ``` **Read YAMLs:** -- `metadata/blueprints/components/cards.yaml` -- classes: `slds-card`, `slds-card__header`, `slds-card__body`, `slds-card__footer` -- `metadata/blueprints/components/badges.yaml` -- classes: `slds-badge`, modifiers: `slds-badge_lightest`, `slds-badge_inverse` +- `assets/blueprints/components/cards.yaml` -- classes: `slds-card`, `slds-card__header`, `slds-card__body`, `slds-card__footer` +- `assets/blueprints/components/badges.yaml` -- classes: `slds-badge`, modifiers: `slds-badge_lightest`, `slds-badge_inverse` ### Phase 3: Apply Styling diff --git a/skills/design-systems-slds-apply/guidance/README.md b/skills/design-systems-slds-apply/references/README.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/README.md rename to skills/design-systems-slds-apply/references/README.md diff --git a/skills/design-systems-slds-apply/guidance/blueprints-index.md b/skills/design-systems-slds-apply/references/blueprints-index.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/blueprints-index.md rename to skills/design-systems-slds-apply/references/blueprints-index.md diff --git a/skills/design-systems-slds-apply/references/component-selection.md b/skills/design-systems-slds-apply/references/component-selection.md index de0dac5..8806d6f 100644 --- a/skills/design-systems-slds-apply/references/component-selection.md +++ b/skills/design-systems-slds-apply/references/component-selection.md @@ -68,7 +68,7 @@ node scripts/search-blueprints.cjs --name "modals" ### How to read a blueprint YAML -Each file in `metadata/blueprints/components/{name}.yaml` contains: +Each file in `assets/blueprints/components/{name}.yaml` contains: ```yaml name: "Modals" @@ -107,6 +107,6 @@ Rules for custom components: ## Deep Reference -- Full blueprint details: `guidance/blueprints-index.md` -- All blueprint YAMLs: `metadata/blueprints/components/` +- Full blueprint details: `references/blueprints-index.md` +- All blueprint YAMLs: `assets/blueprints/components/` - LBC documentation: [Lightning Component Library](https://developer.salesforce.com/docs/component-library/overview/components) diff --git a/skills/design-systems-slds-apply/references/icons-decision-guide.md b/skills/design-systems-slds-apply/references/icons-decision-guide.md index 4803299..2ebf1a4 100644 --- a/skills/design-systems-slds-apply/references/icons-decision-guide.md +++ b/skills/design-systems-slds-apply/references/icons-decision-guide.md @@ -119,6 +119,6 @@ Key classes: ## Deep Reference -- Icon implementation guidance: `guidance/icons-guidance.md` -- Icons overview: `guidance/overviews/icons.md` -- Full icon metadata (1,732 icons with synonyms): `metadata/icon-metadata.json` +- Icon implementation guidance: `references/icons-guidance.md` +- Icons overview: `references/overviews/icons.md` +- Full icon metadata (1,732 icons with synonyms): `assets/icon-metadata.json` diff --git a/skills/design-systems-slds-apply/guidance/icons-guidance.md b/skills/design-systems-slds-apply/references/icons-guidance.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/icons-guidance.md rename to skills/design-systems-slds-apply/references/icons-guidance.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/borders.md b/skills/design-systems-slds-apply/references/overviews/borders.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/borders.md rename to skills/design-systems-slds-apply/references/overviews/borders.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/color.md b/skills/design-systems-slds-apply/references/overviews/color.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/color.md rename to skills/design-systems-slds-apply/references/overviews/color.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/display-density.md b/skills/design-systems-slds-apply/references/overviews/display-density.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/display-density.md rename to skills/design-systems-slds-apply/references/overviews/display-density.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/icons.md b/skills/design-systems-slds-apply/references/overviews/icons.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/icons.md rename to skills/design-systems-slds-apply/references/overviews/icons.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/illustrations.md b/skills/design-systems-slds-apply/references/overviews/illustrations.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/illustrations.md rename to skills/design-systems-slds-apply/references/overviews/illustrations.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/shadows.md b/skills/design-systems-slds-apply/references/overviews/shadows.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/shadows.md rename to skills/design-systems-slds-apply/references/overviews/shadows.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/spacing.md b/skills/design-systems-slds-apply/references/overviews/spacing.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/spacing.md rename to skills/design-systems-slds-apply/references/overviews/spacing.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/typography.md b/skills/design-systems-slds-apply/references/overviews/typography.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/typography.md rename to skills/design-systems-slds-apply/references/overviews/typography.md diff --git a/skills/design-systems-slds-apply/guidance/overviews/utilities.md b/skills/design-systems-slds-apply/references/overviews/utilities.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/overviews/utilities.md rename to skills/design-systems-slds-apply/references/overviews/utilities.md diff --git a/skills/design-systems-slds-apply/guidance/slds-development-guide.md b/skills/design-systems-slds-apply/references/slds-development-guide.md similarity index 99% rename from skills/design-systems-slds-apply/guidance/slds-development-guide.md rename to skills/design-systems-slds-apply/references/slds-development-guide.md index 04ccb6b..c2912e4 100644 --- a/skills/design-systems-slds-apply/guidance/slds-development-guide.md +++ b/skills/design-systems-slds-apply/references/slds-development-guide.md @@ -158,13 +158,13 @@ export default class MyModal extends LightningModal { ## Core Rules -### Do ✅ +### Do - Follow hierarchy: LBC → Blueprints → Styling Hooks → Custom CSS - Use `var(--slds-g-*)` with fallbacks for all themeable values - Create custom classes (e.g., `my-*`) instead of overriding `.slds-*` - Verify components/hooks exist before implementing -### Don't ❌ +### Don't - Hard-code colors, spacing, or typography - Override `.slds-*` classes directly - Use deprecated `--lwc-*` tokens as primary values diff --git a/skills/design-systems-slds-apply/references/styling-decision-guide.md b/skills/design-systems-slds-apply/references/styling-decision-guide.md index 2b8336f..efaaf4e 100644 --- a/skills/design-systems-slds-apply/references/styling-decision-guide.md +++ b/skills/design-systems-slds-apply/references/styling-decision-guide.md @@ -24,7 +24,7 @@ Component hooks are scoped to specific Lightning Base Components. To find availa 2. **Browser DevTools**: Render the LBC, inspect the element, and look for `--slds-c-*` properties in the computed styles 3. **Known patterns**: Component hooks follow `--slds-c-{component}-{property}-{state}` naming, e.g., `--slds-c-button-success-shadow-hover` -There is no centralized metadata file for `--slds-c-*` hooks — they are documented per-component. Some examples exist in `guidance/overviews/shadows.md` and `guidance/styling-hooks/index.md`. +There is no centralized metadata file for `--slds-c-*` hooks — they are documented per-component. Some examples exist in `references/overviews/shadows.md` and `references/styling-hooks/index.md`. --- @@ -46,7 +46,7 @@ Always use `var()` with a fallback value: The fallback in `var(--slds-g-*, fallback)` is used when the hook isn't loaded (e.g., outside Lightning Experience, in static HTML previews, or during SSR). Use the **light-mode default** value: -1. **Look up the value in `metadata/hooks-index.json`** — each hook has a `value` field showing its resolved default +1. **Look up the value in `assets/hooks-index.json`** — each hook has a `value` field showing its resolved default 2. **Use the search script**: `node scripts/search-hooks.cjs --prefix "--slds-g-color-surface-"` shows values 3. **Common defaults**: `#ffffff` for surfaces, `#181818` for text, `1rem` for spacing-4, `0.25rem` for radius-border-2 @@ -218,11 +218,11 @@ Some dimension values have no SLDS hook (e.g., `min-width: 7rem` for label align ## Deep Reference -- Styling hooks index: `guidance/styling-hooks/index.md` -- Color hooks deep dive: `guidance/styling-hooks/color/` -- Color overview (85-5-10 rule): `guidance/overviews/color.md` -- Spacing overview: `guidance/overviews/spacing.md` -- Typography hooks: `guidance/styling-hooks/typography.md` -- Borders overview: `guidance/overviews/borders.md` -- Shadows overview: `guidance/overviews/shadows.md` -- All 523 hooks searchable: `metadata/hooks-index.json` +- Styling hooks index: `references/styling-hooks/index.md` +- Color hooks deep dive: `references/styling-hooks/color/` +- Color overview (85-5-10 rule): `references/overviews/color.md` +- Spacing overview: `references/overviews/spacing.md` +- Typography hooks: `references/styling-hooks/typography.md` +- Borders overview: `references/overviews/borders.md` +- Shadows overview: `references/overviews/shadows.md` +- All 523 hooks searchable: `assets/hooks-index.json` diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/borders.md b/skills/design-systems-slds-apply/references/styling-hooks/borders.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/borders.md rename to skills/design-systems-slds-apply/references/styling-hooks/borders.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/color/expressive-palette-hooks.md b/skills/design-systems-slds-apply/references/styling-hooks/color/expressive-palette-hooks.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/color/expressive-palette-hooks.md rename to skills/design-systems-slds-apply/references/styling-hooks/color/expressive-palette-hooks.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/color/index.md b/skills/design-systems-slds-apply/references/styling-hooks/color/index.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/color/index.md rename to skills/design-systems-slds-apply/references/styling-hooks/color/index.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/color/semantic/accent-hooks.md b/skills/design-systems-slds-apply/references/styling-hooks/color/semantic/accent-hooks.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/color/semantic/accent-hooks.md rename to skills/design-systems-slds-apply/references/styling-hooks/color/semantic/accent-hooks.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/color/semantic/feedback-hooks.md b/skills/design-systems-slds-apply/references/styling-hooks/color/semantic/feedback-hooks.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/color/semantic/feedback-hooks.md rename to skills/design-systems-slds-apply/references/styling-hooks/color/semantic/feedback-hooks.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/color/semantic/surface-hooks.md b/skills/design-systems-slds-apply/references/styling-hooks/color/semantic/surface-hooks.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/color/semantic/surface-hooks.md rename to skills/design-systems-slds-apply/references/styling-hooks/color/semantic/surface-hooks.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/color/system-hooks.md b/skills/design-systems-slds-apply/references/styling-hooks/color/system-hooks.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/color/system-hooks.md rename to skills/design-systems-slds-apply/references/styling-hooks/color/system-hooks.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/index.md b/skills/design-systems-slds-apply/references/styling-hooks/index.md similarity index 99% rename from skills/design-systems-slds-apply/guidance/styling-hooks/index.md rename to skills/design-systems-slds-apply/references/styling-hooks/index.md index cc967c5..4795e34 100644 --- a/skills/design-systems-slds-apply/guidance/styling-hooks/index.md +++ b/skills/design-systems-slds-apply/references/styling-hooks/index.md @@ -245,7 +245,7 @@ font-size: var(--slds-g-font-size-base); /* Or use rem values */ ## Critical Rules -### ✅ DO: +### DO: - Reference hooks with `var()`: `color: var(--slds-g-color-accent-1);` - Use numbered spacing: `spacing-4` not `spacing-medium` @@ -254,7 +254,7 @@ font-size: var(--slds-g-font-size-base); /* Or use rem values */ - Pair container colors with on-colors for text/icons - Follow the 50-point rule for text contrast, 40-point rule for UI elements -### ❌ DON'T: +### DON'T: - Reassign hook values: `--slds-g-color-accent-1: #ff0000;` ❌ - Use private hooks (`--_slds-*` or `--slds-s-*`) diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/shadows.md b/skills/design-systems-slds-apply/references/styling-hooks/shadows.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/shadows.md rename to skills/design-systems-slds-apply/references/styling-hooks/shadows.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/spacing.md b/skills/design-systems-slds-apply/references/styling-hooks/spacing.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/spacing.md rename to skills/design-systems-slds-apply/references/styling-hooks/spacing.md diff --git a/skills/design-systems-slds-apply/guidance/styling-hooks/typography.md b/skills/design-systems-slds-apply/references/styling-hooks/typography.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/styling-hooks/typography.md rename to skills/design-systems-slds-apply/references/styling-hooks/typography.md diff --git a/skills/design-systems-slds-apply/references/utilities-quick-ref.md b/skills/design-systems-slds-apply/references/utilities-quick-ref.md index dfb38e5..3ffd29d 100644 --- a/skills/design-systems-slds-apply/references/utilities-quick-ref.md +++ b/skills/design-systems-slds-apply/references/utilities-quick-ref.md @@ -120,6 +120,6 @@ node scripts/search-utilities.cjs --pattern "slds-p-around_*" ## Deep Reference -- Utility index: `guidance/utilities/index.md` -- Individual category guides: `guidance/utilities/{category}.md` -- Full metadata (1,147 classes): `metadata/utilities-index.json` +- Utility index: `references/utilities/index.md` +- Individual category guides: `references/utilities/{category}.md` +- Full metadata (1,147 classes): `assets/utilities-index.json` diff --git a/skills/design-systems-slds-apply/guidance/utilities/alignment.md b/skills/design-systems-slds-apply/references/utilities/alignment.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/alignment.md rename to skills/design-systems-slds-apply/references/utilities/alignment.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/borders.md b/skills/design-systems-slds-apply/references/utilities/borders.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/borders.md rename to skills/design-systems-slds-apply/references/utilities/borders.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/box.md b/skills/design-systems-slds-apply/references/utilities/box.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/box.md rename to skills/design-systems-slds-apply/references/utilities/box.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/color.md b/skills/design-systems-slds-apply/references/utilities/color.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/color.md rename to skills/design-systems-slds-apply/references/utilities/color.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/dark-mode.md b/skills/design-systems-slds-apply/references/utilities/dark-mode.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/dark-mode.md rename to skills/design-systems-slds-apply/references/utilities/dark-mode.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/description-list.md b/skills/design-systems-slds-apply/references/utilities/description-list.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/description-list.md rename to skills/design-systems-slds-apply/references/utilities/description-list.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/floats.md b/skills/design-systems-slds-apply/references/utilities/floats.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/floats.md rename to skills/design-systems-slds-apply/references/utilities/floats.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/grid.md b/skills/design-systems-slds-apply/references/utilities/grid.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/grid.md rename to skills/design-systems-slds-apply/references/utilities/grid.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/horizontal-list.md b/skills/design-systems-slds-apply/references/utilities/horizontal-list.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/horizontal-list.md rename to skills/design-systems-slds-apply/references/utilities/horizontal-list.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/hyphenation.md b/skills/design-systems-slds-apply/references/utilities/hyphenation.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/hyphenation.md rename to skills/design-systems-slds-apply/references/utilities/hyphenation.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/index.md b/skills/design-systems-slds-apply/references/utilities/index.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/index.md rename to skills/design-systems-slds-apply/references/utilities/index.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/interactions.md b/skills/design-systems-slds-apply/references/utilities/interactions.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/interactions.md rename to skills/design-systems-slds-apply/references/utilities/interactions.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/layout.md b/skills/design-systems-slds-apply/references/utilities/layout.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/layout.md rename to skills/design-systems-slds-apply/references/utilities/layout.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/line-clamp.md b/skills/design-systems-slds-apply/references/utilities/line-clamp.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/line-clamp.md rename to skills/design-systems-slds-apply/references/utilities/line-clamp.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/margin.md b/skills/design-systems-slds-apply/references/utilities/margin.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/margin.md rename to skills/design-systems-slds-apply/references/utilities/margin.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/media-object.md b/skills/design-systems-slds-apply/references/utilities/media-object.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/media-object.md rename to skills/design-systems-slds-apply/references/utilities/media-object.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/name-value-list.md b/skills/design-systems-slds-apply/references/utilities/name-value-list.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/name-value-list.md rename to skills/design-systems-slds-apply/references/utilities/name-value-list.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/padding.md b/skills/design-systems-slds-apply/references/utilities/padding.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/padding.md rename to skills/design-systems-slds-apply/references/utilities/padding.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/position.md b/skills/design-systems-slds-apply/references/utilities/position.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/position.md rename to skills/design-systems-slds-apply/references/utilities/position.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/print.md b/skills/design-systems-slds-apply/references/utilities/print.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/print.md rename to skills/design-systems-slds-apply/references/utilities/print.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/scrollable.md b/skills/design-systems-slds-apply/references/utilities/scrollable.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/scrollable.md rename to skills/design-systems-slds-apply/references/utilities/scrollable.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/sizing.md b/skills/design-systems-slds-apply/references/utilities/sizing.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/sizing.md rename to skills/design-systems-slds-apply/references/utilities/sizing.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/themes.md b/skills/design-systems-slds-apply/references/utilities/themes.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/themes.md rename to skills/design-systems-slds-apply/references/utilities/themes.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/truncate.md b/skills/design-systems-slds-apply/references/utilities/truncate.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/truncate.md rename to skills/design-systems-slds-apply/references/utilities/truncate.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/typography.md b/skills/design-systems-slds-apply/references/utilities/typography.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/typography.md rename to skills/design-systems-slds-apply/references/utilities/typography.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/vertical-list.md b/skills/design-systems-slds-apply/references/utilities/vertical-list.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/vertical-list.md rename to skills/design-systems-slds-apply/references/utilities/vertical-list.md diff --git a/skills/design-systems-slds-apply/guidance/utilities/visibility.md b/skills/design-systems-slds-apply/references/utilities/visibility.md similarity index 100% rename from skills/design-systems-slds-apply/guidance/utilities/visibility.md rename to skills/design-systems-slds-apply/references/utilities/visibility.md diff --git a/skills/design-systems-slds-apply/scripts/search-blueprints.cjs b/skills/design-systems-slds-apply/scripts/search-blueprints.cjs index 8fb335e..c6eb7ae 100644 --- a/skills/design-systems-slds-apply/scripts/search-blueprints.cjs +++ b/skills/design-systems-slds-apply/scripts/search-blueprints.cjs @@ -13,7 +13,7 @@ const fs = require('fs'); const path = require('path'); -const BLUEPRINTS_DIR = path.join(__dirname, '..', 'metadata', 'blueprints', 'components'); +const BLUEPRINTS_DIR = path.join(__dirname, '..', 'assets', 'blueprints', 'components'); function loadBlueprints() { const blueprints = []; @@ -67,7 +67,7 @@ function run() { console.log(`Category: ${bp.category}`); console.log(`Root class: ${bp.rootClass}`); console.log(`Description: ${bp.description}`); - console.log(`\nFull YAML: metadata/blueprints/components/${bp.file}.yaml`); + console.log(`\nFull YAML: assets/blueprints/components/${bp.file}.yaml`); console.log('\nRead the full YAML file for classes, modifiers, states, accessibility, and example HTML.'); return; } diff --git a/skills/design-systems-slds-apply/scripts/search-hooks.cjs b/skills/design-systems-slds-apply/scripts/search-hooks.cjs index 3172245..0c42857 100644 --- a/skills/design-systems-slds-apply/scripts/search-hooks.cjs +++ b/skills/design-systems-slds-apply/scripts/search-hooks.cjs @@ -15,7 +15,7 @@ const fs = require('fs'); const path = require('path'); -const INDEX_PATH = path.join(__dirname, '..', 'metadata', 'hooks-index.json'); +const INDEX_PATH = path.join(__dirname, '..', 'assets', 'hooks-index.json'); function loadHooks() { if (!fs.existsSync(INDEX_PATH)) { diff --git a/skills/design-systems-slds-apply/scripts/search-icons.cjs b/skills/design-systems-slds-apply/scripts/search-icons.cjs index f1596c6..18d8c2e 100644 --- a/skills/design-systems-slds-apply/scripts/search-icons.cjs +++ b/skills/design-systems-slds-apply/scripts/search-icons.cjs @@ -13,7 +13,7 @@ const fs = require('fs'); const path = require('path'); -const ICONS_PATH = path.join(__dirname, '..', 'metadata', 'icon-metadata.json'); +const ICONS_PATH = path.join(__dirname, '..', 'assets', 'icon-metadata.json'); function loadIcons() { if (!fs.existsSync(ICONS_PATH)) { diff --git a/skills/design-systems-slds-apply/scripts/search-utilities.cjs b/skills/design-systems-slds-apply/scripts/search-utilities.cjs index d6845e0..8779084 100644 --- a/skills/design-systems-slds-apply/scripts/search-utilities.cjs +++ b/skills/design-systems-slds-apply/scripts/search-utilities.cjs @@ -13,8 +13,8 @@ const fs = require('fs'); const path = require('path'); -const INDEX_PATH = path.join(__dirname, '..', 'metadata', 'utilities-index.json'); -const GUIDANCE_DIR = path.join(__dirname, '..', 'guidance', 'utilities'); +const INDEX_PATH = path.join(__dirname, '..', 'assets', 'utilities-index.json'); +const GUIDANCE_DIR = path.join(__dirname, '..', 'references', 'utilities'); function loadUtilities() { if (!fs.existsSync(INDEX_PATH)) { @@ -100,7 +100,7 @@ function run() { const guidePath = path.join(GUIDANCE_DIR, `${catKey}.md`); if (fs.existsSync(guidePath)) { - console.log(`\nDetailed guidance: guidance/utilities/${catKey}.md`); + console.log(`\nDetailed guidance: references/utilities/${catKey}.md`); } return; } diff --git a/skills/dx-code-analyzer-configure/SKILL.md b/skills/dx-code-analyzer-configure/SKILL.md index 3340222..93068f6 100644 --- a/skills/dx-code-analyzer-configure/SKILL.md +++ b/skills/dx-code-analyzer-configure/SKILL.md @@ -127,7 +127,7 @@ ls code-analyzer.yml code-analyzer.yaml 2>/dev/null The CLI auto-discovers `code-analyzer.yml` in the current directory. Since scans run from project root, the file must live there. -### ⚠️ Rule Name Resolution — ALWAYS Before Writing YAML +### Rule Name Resolution — ALWAYS Before Writing YAML When a user references rules by partial, descriptive, or approximate names (e.g., "the doc rule", "CRUD violation", "console rule", "hardcoded values"), you MUST resolve to exact rule names using the lookup in **Step 6.1** BEFORE writing any YAML. The `code-analyzer.yml` file silently ignores rule names that don't exactly match — there is no error, the override just won't apply. diff --git a/skills/dx-code-analyzer-run/SKILL.md b/skills/dx-code-analyzer-run/SKILL.md index 40e6dc7..7db2cf7 100644 --- a/skills/dx-code-analyzer-run/SKILL.md +++ b/skills/dx-code-analyzer-run/SKILL.md @@ -9,11 +9,11 @@ metadata: # Running Code Analyzer Skill -## ⚠️ CRITICAL: Mandatory Script Usage +## CRITICAL: Mandatory Script Usage Every interaction with Code Analyzer results MUST go through the bundled scripts in `/scripts/`. No exceptions. -### ❌ WRONG — never do this: +### WRONG — never do this: ```bash # WRONG: inline Python to parse results @@ -31,7 +31,7 @@ Read tool → code-analyzer-results-*.json Also forbidden: `run_code_analyzer` and any `mcp__*` tool — Bash only. -### ✅ RIGHT — always do this: +### RIGHT — always do this: ```bash # Summarize scan results diff --git a/skills/dx-code-analyzer-run/examples/command-variations.md b/skills/dx-code-analyzer-run/examples/command-variations.md index 846fcac..348f3af 100644 --- a/skills/dx-code-analyzer-run/examples/command-variations.md +++ b/skills/dx-code-analyzer-run/examples/command-variations.md @@ -297,7 +297,7 @@ sf code-analyzer run \ ## Anti-Patterns (DO NOT USE) -### ❌ Using `--format` flag +### Using `--format` flag ```bash # WRONG - v3 syntax, does not exist in v4+ sf code-analyzer run --format json @@ -306,7 +306,7 @@ sf code-analyzer run --format json --- -### ❌ Using `$TIMESTAMP` variable in command +### Using `$TIMESTAMP` variable in command ```bash # WRONG - variable substitution fails in permission prompts sf code-analyzer run --output-file "./results-${TIMESTAMP}.json" @@ -315,7 +315,7 @@ sf code-analyzer run --output-file "./results-${TIMESTAMP}.json" --- -### ❌ Running in background for long scans +### Running in background for long scans ```bash # WRONG - loses output stream sf code-analyzer run --rule-selector sfge & @@ -324,7 +324,7 @@ sf code-analyzer run --rule-selector sfge & --- -### ❌ Partial rule names +### Partial rule names ```bash # WRONG - returns 0 results sf code-analyzer run --rule-selector "no-hardcoded-values" diff --git a/skills/dx-org-permission-set-assign/SKILL.md b/skills/dx-org-permission-set-assign/SKILL.md index ca80cdd..1648039 100644 --- a/skills/dx-org-permission-set-assign/SKILL.md +++ b/skills/dx-org-permission-set-assign/SKILL.md @@ -12,7 +12,7 @@ Assigns one or more permission sets to org users using `sf org assign permset`. --- -## ⚠️ Tool Restrictions +## Tool Restrictions **Use ONLY the Bash tool** to execute `sf org assign permset`. Do NOT use MCP tools like `assign_permission_set` — ignore them completely. diff --git a/skills/experience-lwc-generate/references/async-notification-patterns.md b/skills/experience-lwc-generate/references/async-notification-patterns.md index 5109a01..f9ef312 100644 --- a/skills/experience-lwc-generate/references/async-notification-patterns.md +++ b/skills/experience-lwc-generate/references/async-notification-patterns.md @@ -617,7 +617,7 @@ connectedCallback() { ## Best Practices -### DO ✅ +### DO | Practice | Reason | |----------|--------| @@ -627,7 +627,7 @@ connectedCallback() { | Use `refreshApex` after events | Keeps wire data in sync | | Set reasonable replay ID | `-1` for real-time, `-2` for recovery | -### DON'T ❌ +### DON'T | Anti-Pattern | Problem | |--------------|---------| diff --git a/skills/experience-lwc-generate/references/state-management.md b/skills/experience-lwc-generate/references/state-management.md index 86a8c6e..8437f79 100644 --- a/skills/experience-lwc-generate/references/state-management.md +++ b/skills/experience-lwc-generate/references/state-management.md @@ -511,7 +511,7 @@ export default class ComposedStateComponent extends LightningElement { ## Anti-Patterns to Avoid -### ❌ BAD: Mutating Objects In Place +### BAD: Mutating Objects In Place ```javascript // DON'T - won't trigger reactivity @@ -519,7 +519,7 @@ this.user.name = 'New Name'; this.items.push(newItem); ``` -### ✅ GOOD: Create New References +### GOOD: Create New References ```javascript // DO - triggers reactivity @@ -527,7 +527,7 @@ this.user = { ...this.user, name: 'New Name' }; this.items = [...this.items, newItem]; ``` -### ❌ BAD: Heavy Computation in Getters +### BAD: Heavy Computation in Getters ```javascript // DON'T - runs every render cycle @@ -539,7 +539,7 @@ get expensiveComputation() { } ``` -### ✅ GOOD: Cache Computed Values +### GOOD: Cache Computed Values ```javascript _cachedResult; @@ -558,7 +558,7 @@ get optimizedComputation() { } ``` -### ❌ BAD: Forgetting to Unsubscribe +### BAD: Forgetting to Unsubscribe ```javascript // DON'T - memory leak @@ -567,7 +567,7 @@ connectedCallback() { } ``` -### ✅ GOOD: Clean Up Subscriptions +### GOOD: Clean Up Subscriptions ```javascript // DO - proper cleanup diff --git a/skills/experience-lwc-generate/references/template-anti-patterns.md b/skills/experience-lwc-generate/references/template-anti-patterns.md index 6b25d57..9904478 100644 --- a/skills/experience-lwc-generate/references/template-anti-patterns.md +++ b/skills/experience-lwc-generate/references/template-anti-patterns.md @@ -26,7 +26,7 @@ This guide documents systematic errors in Lightning Web Component templates, wit **Critical Rule**: LWC templates do NOT support JavaScript expressions. Only property references are allowed. -### ❌ BAD: Arithmetic in Template +### BAD: Arithmetic in Template ```html @@ -37,7 +37,7 @@ This guide documents systematic errors in Lightning Web Component templates, wit ``` -### ✅ GOOD: Use Getters +### GOOD: Use Getters ```javascript // component.js @@ -69,7 +69,7 @@ export default class PriceCalculator extends LightningElement { ``` -### ❌ BAD: String Concatenation in Template +### BAD: String Concatenation in Template ```html @@ -79,7 +79,7 @@ export default class PriceCalculator extends LightningElement { ``` -### ✅ GOOD: Computed Properties +### GOOD: Computed Properties ```javascript // component.js @@ -112,7 +112,7 @@ export default class Greeting extends LightningElement { **Critical Rule**: Ternary operators (`condition ? a : b`) are NOT allowed in LWC templates. -### ❌ BAD: Ternary in Template +### BAD: Ternary in Template ```html @@ -123,7 +123,7 @@ export default class Greeting extends LightningElement { ``` -### ✅ GOOD: Use Getters for Conditional Values +### GOOD: Use Getters for Conditional Values ```javascript // component.js @@ -155,7 +155,7 @@ export default class StatusDisplay extends LightningElement { ``` -### ✅ GOOD: Use if:true/if:false for Conditional Rendering +### GOOD: Use if:true/if:false for Conditional Rendering ```html @@ -189,7 +189,7 @@ get hasCount() { **Critical Rule**: Object literals (`{}`) cannot be passed directly as attribute values. -### ❌ BAD: Inline Object Literals +### BAD: Inline Object Literals ```html @@ -206,7 +206,7 @@ get hasCount() { ``` -### ✅ GOOD: Define Objects in JavaScript +### GOOD: Define Objects in JavaScript ```javascript // component.js @@ -237,7 +237,7 @@ export default class ParentComponent extends LightningElement { ``` -### ❌ BAD: Inline Array Literals +### BAD: Inline Array Literals ```html @@ -246,7 +246,7 @@ export default class ParentComponent extends LightningElement { ``` -### ✅ GOOD: Define Arrays in JavaScript +### GOOD: Define Arrays in JavaScript ```javascript // component.js @@ -272,7 +272,7 @@ export default class ColorPicker extends LightningElement { **Critical Rule**: No method calls, comparisons, or logical operators in templates. -### ❌ BAD: Method Calls in Template +### BAD: Method Calls in Template ```html @@ -284,7 +284,7 @@ export default class ColorPicker extends LightningElement { ``` -### ✅ GOOD: Use Getters for Transformations +### GOOD: Use Getters for Transformations ```javascript // component.js @@ -322,7 +322,7 @@ export default class DataDisplay extends LightningElement { ``` -### ❌ BAD: Comparisons in Template +### BAD: Comparisons in Template ```html @@ -337,7 +337,7 @@ export default class DataDisplay extends LightningElement { ``` -### ✅ GOOD: Getter-Based Comparisons +### GOOD: Getter-Based Comparisons ```javascript // component.js @@ -363,7 +363,7 @@ get isActive() { ``` -### ❌ BAD: Logical Operators in Template +### BAD: Logical Operators in Template ```html @@ -378,7 +378,7 @@ get isActive() { ``` -### ✅ GOOD: Computed Boolean Properties +### GOOD: Computed Boolean Properties ```javascript // component.js @@ -408,7 +408,7 @@ get isNotLoading() { ## 5. Event Handler Mistakes -### ❌ BAD: Inline Event Handlers with Arguments +### BAD: Inline Event Handlers with Arguments ```html @@ -419,7 +419,7 @@ get isNotLoading() { ``` -### ✅ GOOD: Handler Functions with Data Attributes +### GOOD: Handler Functions with Data Attributes ```html @@ -449,7 +449,7 @@ handleChange(event) { } ``` -### ❌ BAD: Event Binding with bind() +### BAD: Event Binding with bind() ```html @@ -458,7 +458,7 @@ handleChange(event) { ``` -### ✅ GOOD: Use Data Attributes for Context +### GOOD: Use Data Attributes for Context ```html @@ -491,7 +491,7 @@ handleItemClick(event) { ## 6. Iteration Anti-Patterns -### ❌ BAD: Missing Key in Iteration +### BAD: Missing Key in Iteration ```html @@ -502,7 +502,7 @@ handleItemClick(event) { ``` -### ✅ GOOD: Always Include Key +### GOOD: Always Include Key ```html @@ -513,7 +513,7 @@ handleItemClick(event) { ``` -### ❌ BAD: Using Index as Key +### BAD: Using Index as Key ```html @@ -524,7 +524,7 @@ handleItemClick(event) { ``` -### ✅ GOOD: Use Unique Identifier as Key +### GOOD: Use Unique Identifier as Key ```javascript // If items don't have unique IDs, generate them @@ -545,7 +545,7 @@ connectedCallback() { ``` -### ❌ BAD: Nested Iteration Without Proper Keys +### BAD: Nested Iteration Without Proper Keys ```html @@ -562,7 +562,7 @@ connectedCallback() { ``` -### ✅ GOOD: Compound Keys for Nested Iteration +### GOOD: Compound Keys for Nested Iteration ```javascript // component.js @@ -595,7 +595,7 @@ get processedCategories() { ## 7. Conditional Rendering Issues -### ❌ BAD: if:true on Non-Boolean Values +### BAD: if:true on Non-Boolean Values ```html @@ -612,7 +612,7 @@ get processedCategories() { ``` -### ✅ GOOD: Explicit Boolean Conversion +### GOOD: Explicit Boolean Conversion ```javascript // component.js @@ -638,7 +638,7 @@ get hasCount() { ``` -### ❌ BAD: Multiple Conditions Without Else +### BAD: Multiple Conditions Without Else ```html @@ -655,7 +655,7 @@ get hasCount() { ``` -### ✅ GOOD: Use a State Getter +### GOOD: Use a State Getter ```javascript // component.js @@ -694,7 +694,7 @@ get isEmptyState() { return this.viewState === 'empty'; } ## 8. Slot and Composition Errors -### ❌ BAD: Named Slot with Wrong Syntax +### BAD: Named Slot with Wrong Syntax ```html @@ -711,7 +711,7 @@ get isEmptyState() { return this.viewState === 'empty'; } ``` -### ✅ GOOD: LWC Slot Syntax +### GOOD: LWC Slot Syntax ```html @@ -746,7 +746,7 @@ get isEmptyState() { return this.viewState === 'empty'; } ## 9. Data Binding Mistakes -### ❌ BAD: Two-Way Binding Syntax +### BAD: Two-Way Binding Syntax ```html @@ -757,7 +757,7 @@ get isEmptyState() { return this.viewState === 'empty'; } ``` -### ✅ GOOD: One-Way Binding with Event Handler +### GOOD: One-Way Binding with Event Handler ```html @@ -790,7 +790,7 @@ handleInputChange(event) { } ``` -### ❌ BAD: Direct Property Mutation in Template +### BAD: Direct Property Mutation in Template ```html @@ -799,7 +799,7 @@ handleInputChange(event) { ``` -### ✅ GOOD: Mutate in Handler +### GOOD: Mutate in Handler ```javascript // component.js @@ -821,7 +821,7 @@ handleIncrement() { ## 10. Style and Class Binding -### ❌ BAD: Dynamic Styles in Template +### BAD: Dynamic Styles in Template ```html @@ -836,7 +836,7 @@ handleIncrement() { ``` -### ✅ GOOD: CSS Custom Properties (Recommended) +### GOOD: CSS Custom Properties (Recommended) ```javascript // component.js @@ -864,7 +864,7 @@ renderedCallback() { ``` -### ✅ GOOD: Computed Style String (When Necessary) +### GOOD: Computed Style String (When Necessary) ```javascript // component.js @@ -880,7 +880,7 @@ get dynamicStyle() { ``` -### ❌ BAD: Dynamic Class with Expression +### BAD: Dynamic Class with Expression ```html @@ -890,7 +890,7 @@ get dynamicStyle() { ``` -### ✅ GOOD: Computed Class String +### GOOD: Computed Class String ```javascript // component.js diff --git a/skills/experience-lwc-generate/hooks/scripts/lwc-lsp-validate.py b/skills/experience-lwc-generate/scripts/lwc-lsp-validate.py similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/lwc-lsp-validate.py rename to skills/experience-lwc-generate/scripts/lwc-lsp-validate.py diff --git a/skills/experience-lwc-generate/hooks/scripts/post-tool-validate.py b/skills/experience-lwc-generate/scripts/post-tool-validate.py similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/post-tool-validate.py rename to skills/experience-lwc-generate/scripts/post-tool-validate.py diff --git a/skills/experience-lwc-generate/hooks/scripts/slds_data/deprecated_patterns.json b/skills/experience-lwc-generate/scripts/slds_data/deprecated_patterns.json similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/slds_data/deprecated_patterns.json rename to skills/experience-lwc-generate/scripts/slds_data/deprecated_patterns.json diff --git a/skills/experience-lwc-generate/hooks/scripts/slds_data/styling_hooks.json b/skills/experience-lwc-generate/scripts/slds_data/styling_hooks.json similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/slds_data/styling_hooks.json rename to skills/experience-lwc-generate/scripts/slds_data/styling_hooks.json diff --git a/skills/experience-lwc-generate/hooks/scripts/slds_data/valid_slds_classes.json b/skills/experience-lwc-generate/scripts/slds_data/valid_slds_classes.json similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/slds_data/valid_slds_classes.json rename to skills/experience-lwc-generate/scripts/slds_data/valid_slds_classes.json diff --git a/skills/experience-lwc-generate/hooks/scripts/slds_linter_wrapper.py b/skills/experience-lwc-generate/scripts/slds_linter_wrapper.py similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/slds_linter_wrapper.py rename to skills/experience-lwc-generate/scripts/slds_linter_wrapper.py diff --git a/skills/experience-lwc-generate/hooks/scripts/slds_rules/__init__.py b/skills/experience-lwc-generate/scripts/slds_rules/__init__.py similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/slds_rules/__init__.py rename to skills/experience-lwc-generate/scripts/slds_rules/__init__.py diff --git a/skills/experience-lwc-generate/hooks/scripts/template_validator.py b/skills/experience-lwc-generate/scripts/template_validator.py similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/template_validator.py rename to skills/experience-lwc-generate/scripts/template_validator.py diff --git a/skills/experience-lwc-generate/hooks/scripts/validate_slds.py b/skills/experience-lwc-generate/scripts/validate_slds.py similarity index 100% rename from skills/experience-lwc-generate/hooks/scripts/validate_slds.py rename to skills/experience-lwc-generate/scripts/validate_slds.py diff --git a/skills/experience-ui-bundle-agentforce-client-generate/references/constraints.md b/skills/experience-ui-bundle-agentforce-client-generate/references/constraints.md index ad443c6..e8d101e 100644 --- a/skills/experience-ui-bundle-agentforce-client-generate/references/constraints.md +++ b/skills/experience-ui-bundle-agentforce-client-generate/references/constraints.md @@ -65,19 +65,19 @@ When updating an existing component: ## Examples -### ❌ Wrong - Using containerStyle +### Wrong - Using containerStyle ```tsx ``` -### ✅ Correct - Using width/height directly +### Correct - Using width/height directly ```tsx ``` -### ❌ Wrong - Creating CSS file +### Wrong - Creating CSS file ```css /* agent-styles.css */ @@ -93,7 +93,7 @@ import "./agent-styles.css"; ; ``` -### ✅ Correct - Using styleTokens +### Correct - Using styleTokens ```tsx ``` -### ❌ Wrong - Creating style tag +### Wrong - Creating style tag ```tsx <> @@ -114,7 +114,7 @@ import "./agent-styles.css"; ``` -### ✅ Correct - Using styleTokens +### Correct - Using styleTokens ```tsx ``` -### ❌ Wrong - Editing implementation file +### Wrong - Editing implementation file Reading or editing: `node_modules/@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client/src/AgentforceConversationClient.tsx` -### ✅ Correct - Editing usage file +### Correct - Editing usage file Reading and editing: usage files where the component is imported and used (for example, `src/app.tsx`, a route component, or a feature page) diff --git a/skills/experience-ui-bundle-custom-app-generate/SKILL.md b/skills/experience-ui-bundle-custom-app-generate/SKILL.md index 7f71d83..699a51f 100644 --- a/skills/experience-ui-bundle-custom-app-generate/SKILL.md +++ b/skills/experience-ui-bundle-custom-app-generate/SKILL.md @@ -55,10 +55,10 @@ Use the default template in the doc below. Values in `{braces}` are resolved pro | Metadata Type | Template Reference | |--------------|-------------------| -| CustomApplication | [configure-metadata-custom-application.md](docs/configure-metadata-custom-application.md) | +| CustomApplication | [configure-metadata-custom-application.md](references/configure-metadata-custom-application.md) | ### Execution Note for Step 4: Load and use the doc -- Agents MUST read the full contents of the docs/*.md file referenced in Step 4 before attempting to populate metadata fields. +- Agents MUST read the full contents of the references/*.md file referenced in Step 4 before attempting to populate metadata fields. - Read the file in full, replace placeholders (e.g. `{appName}`) with the resolved values, then use the expanded template to populate the metadata XML content. - If Step 2 determined the older field names apply, substitute `` with `` in the generated output. diff --git a/skills/experience-ui-bundle-custom-app-generate/docs/configure-metadata-custom-application.md b/skills/experience-ui-bundle-custom-app-generate/references/configure-metadata-custom-application.md similarity index 100% rename from skills/experience-ui-bundle-custom-app-generate/docs/configure-metadata-custom-application.md rename to skills/experience-ui-bundle-custom-app-generate/references/configure-metadata-custom-application.md diff --git a/skills/experience-ui-bundle-frontend-generate/SKILL.md b/skills/experience-ui-bundle-frontend-generate/SKILL.md index 16243d7..e355205 100644 --- a/skills/experience-ui-bundle-frontend-generate/SKILL.md +++ b/skills/experience-ui-bundle-frontend-generate/SKILL.md @@ -13,9 +13,9 @@ Determine which category the request falls into: | Category | Examples | Implementation Guide | |----------|----------|---------------------| -| **Page** | New routed page (contacts, dashboard, settings) | `implementation/page.md` | -| **Header / Footer** | Site-wide nav bar, footer, branding | `implementation/header-footer.md` | -| **Component** | Widget, card, table, form, dialog | `implementation/component.md` | +| **Page** | New routed page (contacts, dashboard, settings) | `references/page.md` | +| **Header / Footer** | Site-wide nav bar, footer, branding | `references/header-footer.md` | +| **Component** | Widget, card, table, form, dialog | `references/component.md` | --- diff --git a/skills/experience-ui-bundle-frontend-generate/implementation/component.md b/skills/experience-ui-bundle-frontend-generate/references/component.md similarity index 100% rename from skills/experience-ui-bundle-frontend-generate/implementation/component.md rename to skills/experience-ui-bundle-frontend-generate/references/component.md diff --git a/skills/experience-ui-bundle-frontend-generate/implementation/header-footer.md b/skills/experience-ui-bundle-frontend-generate/references/header-footer.md similarity index 100% rename from skills/experience-ui-bundle-frontend-generate/implementation/header-footer.md rename to skills/experience-ui-bundle-frontend-generate/references/header-footer.md diff --git a/skills/experience-ui-bundle-frontend-generate/implementation/page.md b/skills/experience-ui-bundle-frontend-generate/references/page.md similarity index 100% rename from skills/experience-ui-bundle-frontend-generate/implementation/page.md rename to skills/experience-ui-bundle-frontend-generate/references/page.md diff --git a/skills/experience-ui-bundle-metadata-generate/SKILL.md b/skills/experience-ui-bundle-metadata-generate/SKILL.md index 8e3970b..e040ebb 100644 --- a/skills/experience-ui-bundle-metadata-generate/SKILL.md +++ b/skills/experience-ui-bundle-metadata-generate/SKILL.md @@ -149,5 +149,5 @@ Whenever the app references a new external domain: CDN images, external fonts, t Always also set `isApplicableToConnectSrc` to `true` for preflight/redirect handling. -4. **Create the metadata file** — follow `implementation/csp-metadata-format.md` for the `.cspTrustedSite-meta.xml` format. Place in `force-app/main/default/cspTrustedSites/`. +4. **Create the metadata file** — follow `references/csp-metadata-format.md` for the `.cspTrustedSite-meta.xml` format. Place in `force-app/main/default/cspTrustedSites/`. diff --git a/skills/experience-ui-bundle-metadata-generate/implementation/csp-metadata-format.md b/skills/experience-ui-bundle-metadata-generate/references/csp-metadata-format.md similarity index 100% rename from skills/experience-ui-bundle-metadata-generate/implementation/csp-metadata-format.md rename to skills/experience-ui-bundle-metadata-generate/references/csp-metadata-format.md diff --git a/skills/experience-ui-bundle-site-generate/SKILL.md b/skills/experience-ui-bundle-site-generate/SKILL.md index e401588..ed96eed 100644 --- a/skills/experience-ui-bundle-site-generate/SKILL.md +++ b/skills/experience-ui-bundle-site-generate/SKILL.md @@ -47,23 +47,23 @@ Use the default templates in the docs below. Values in `{braces}` are resolved p | Metadata Type | Template Reference | |--------------|-------------------| -| Network | [configure-metadata-network.md](docs/configure-metadata-network.md) | -| CustomSite | [configure-metadata-custom-site.md](docs/configure-metadata-custom-site.md) | -| DigitalExperienceConfig | [configure-metadata-digital-experience-config.md](docs/configure-metadata-digital-experience-config.md) | -| DigitalExperienceBundle | [configure-metadata-digital-experience-bundle.md](docs/configure-metadata-digital-experience-bundle.md) | -| DigitalExperience (sfdc_cms__site) | [configure-metadata-digital-experience.md](docs/configure-metadata-digital-experience.md) | +| Network | [configure-metadata-network.md](references/configure-metadata-network.md) | +| CustomSite | [configure-metadata-custom-site.md](references/configure-metadata-custom-site.md) | +| DigitalExperienceConfig | [configure-metadata-digital-experience-config.md](references/configure-metadata-digital-experience-config.md) | +| DigitalExperienceBundle | [configure-metadata-digital-experience-bundle.md](references/configure-metadata-digital-experience-bundle.md) | +| DigitalExperience (sfdc_cms__site) | [configure-metadata-digital-experience.md](references/configure-metadata-digital-experience.md) | -For URL updates, see [update-site-urls.md](docs/update-site-urls.md). +For URL updates, see [update-site-urls.md](references/update-site-urls.md). ### Execution Note for Step 3: Load and use the docs -- Agents MUST read the full contents of each docs/*.md file referenced in Step 3 before attempting to populate metadata fields. +- Agents MUST read the full contents of each references/*.md file referenced in Step 3 before attempting to populate metadata fields. - Use your platform's file-read tool (for example, `read_file`) to load these files in full, then perform placeholder substitution for values in `{braces}` using the resolved properties from Step 1. - Files to load: - - `docs/configure-metadata-network.md` - - `docs/configure-metadata-custom-site.md` - - `docs/configure-metadata-digital-experience-config.md` - - `docs/configure-metadata-digital-experience-bundle.md` - - `docs/configure-metadata-digital-experience.md` + - `references/configure-metadata-network.md` + - `references/configure-metadata-custom-site.md` + - `references/configure-metadata-digital-experience-config.md` + - `references/configure-metadata-digital-experience-bundle.md` + - `references/configure-metadata-digital-experience.md` - Read entire file contents, replace placeholders (e.g. `{siteName}`) with the resolved values, then use the expanded templates to populate the metadata XML/JSON content. ### Step 4: Do Not Modify Non-Templated Properties @@ -88,5 +88,5 @@ sf project deploy validate --metadata Network CustomSite DigitalExperienceConfig **Use when** user wants to update or change site URLs (urlPathPrefix). **Steps**: -- [ ] Read [update-site-urls.md](docs/update-site-urls.md) to understand the three-component architecture and URL update workflow +- [ ] Read [update-site-urls.md](references/update-site-urls.md) to understand the three-component architecture and URL update workflow - [ ] Follow the step-by-step workflow in the doc to update URLs consistently across all three components (DigitalExperienceConfig, Network, CustomSite) diff --git a/skills/experience-ui-bundle-site-generate/docs/configure-metadata-custom-site.md b/skills/experience-ui-bundle-site-generate/references/configure-metadata-custom-site.md similarity index 100% rename from skills/experience-ui-bundle-site-generate/docs/configure-metadata-custom-site.md rename to skills/experience-ui-bundle-site-generate/references/configure-metadata-custom-site.md diff --git a/skills/experience-ui-bundle-site-generate/docs/configure-metadata-digital-experience-bundle.md b/skills/experience-ui-bundle-site-generate/references/configure-metadata-digital-experience-bundle.md similarity index 100% rename from skills/experience-ui-bundle-site-generate/docs/configure-metadata-digital-experience-bundle.md rename to skills/experience-ui-bundle-site-generate/references/configure-metadata-digital-experience-bundle.md diff --git a/skills/experience-ui-bundle-site-generate/docs/configure-metadata-digital-experience-config.md b/skills/experience-ui-bundle-site-generate/references/configure-metadata-digital-experience-config.md similarity index 100% rename from skills/experience-ui-bundle-site-generate/docs/configure-metadata-digital-experience-config.md rename to skills/experience-ui-bundle-site-generate/references/configure-metadata-digital-experience-config.md diff --git a/skills/experience-ui-bundle-site-generate/docs/configure-metadata-digital-experience.md b/skills/experience-ui-bundle-site-generate/references/configure-metadata-digital-experience.md similarity index 100% rename from skills/experience-ui-bundle-site-generate/docs/configure-metadata-digital-experience.md rename to skills/experience-ui-bundle-site-generate/references/configure-metadata-digital-experience.md diff --git a/skills/experience-ui-bundle-site-generate/docs/configure-metadata-network.md b/skills/experience-ui-bundle-site-generate/references/configure-metadata-network.md similarity index 100% rename from skills/experience-ui-bundle-site-generate/docs/configure-metadata-network.md rename to skills/experience-ui-bundle-site-generate/references/configure-metadata-network.md diff --git a/skills/experience-ui-bundle-site-generate/docs/update-site-urls.md b/skills/experience-ui-bundle-site-generate/references/update-site-urls.md similarity index 100% rename from skills/experience-ui-bundle-site-generate/docs/update-site-urls.md rename to skills/experience-ui-bundle-site-generate/references/update-site-urls.md diff --git a/skills/integration-connectivity-generate/SKILL.md b/skills/integration-connectivity-generate/SKILL.md index dfcc6ec..7dc9018 100644 --- a/skills/integration-connectivity-generate/SKILL.md +++ b/skills/integration-connectivity-generate/SKILL.md @@ -163,8 +163,8 @@ Next step: - `assets/endpoint-security/` — Remote Site Setting and CSP Trusted Site XML templates ### Automation hooks -- `hooks/scripts/suggest_credential_setup.py` — auto-suggests credential configuration steps when integration files are detected -- `hooks/scripts/validate_integration.py` — validates integration patterns before agent responses +- `scripts/suggest_credential_setup.py` — auto-suggests credential configuration steps when integration files are detected +- `scripts/validate_integration.py` — validates integration patterns before agent responses --- diff --git a/skills/integration-connectivity-generate/hooks/scripts/suggest_credential_setup.py b/skills/integration-connectivity-generate/scripts/suggest_credential_setup.py similarity index 100% rename from skills/integration-connectivity-generate/hooks/scripts/suggest_credential_setup.py rename to skills/integration-connectivity-generate/scripts/suggest_credential_setup.py diff --git a/skills/integration-connectivity-generate/hooks/scripts/validate_integration.py b/skills/integration-connectivity-generate/scripts/validate_integration.py similarity index 100% rename from skills/integration-connectivity-generate/hooks/scripts/validate_integration.py rename to skills/integration-connectivity-generate/scripts/validate_integration.py diff --git a/skills/omnistudio-callable-apex-generate/SKILL.md b/skills/omnistudio-callable-apex-generate/SKILL.md index 8f33577..9af9f0e 100644 --- a/skills/omnistudio-callable-apex-generate/SKILL.md +++ b/skills/omnistudio-callable-apex-generate/SKILL.md @@ -175,7 +175,7 @@ action contract stable. --- -## ⛔ Guardrails (Mandatory) +## Guardrails (Mandatory) Stop and ask the user if any of these would be introduced: - Dynamic method execution based on user input (no reflection) diff --git a/skills/omnistudio-epc-catalog-generate/examples/.gitkeep b/skills/omnistudio-epc-catalog-generate/examples/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/skills/omnistudio-epc-catalog-generate/examples/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/skills/platform-apex-logs-debug/references/benchmarking-guide.md b/skills/platform-apex-logs-debug/references/benchmarking-guide.md index bbc380a..6bc0934 100644 --- a/skills/platform-apex-logs-debug/references/benchmarking-guide.md +++ b/skills/platform-apex-logs-debug/references/benchmarking-guide.md @@ -228,7 +228,7 @@ public void processWithSafety(List accounts) { ## Benchmarking Anti-Patterns -### ❌ Don't Do These +### Don't Do These | Anti-Pattern | Problem | Solution | |--------------|---------|----------| diff --git a/skills/platform-apex-test-run/SKILL.md b/skills/platform-apex-test-run/SKILL.md index 2e99bd5..c17c1d7 100644 --- a/skills/platform-apex-test-run/SKILL.md +++ b/skills/platform-apex-test-run/SKILL.md @@ -143,7 +143,7 @@ Next step: | `assets/test-data-factory.cls` | Template: reusable `TestDataFactory` with create and insert helpers | | `assets/dml-mock.cls` | Template: `IDML` interface + `DMLMock` implementation for database-free unit tests | | `assets/stub-provider-example.cls` | Template: `StubProvider`-based dependency injection stub | -| `hooks/scripts/parse-test-results.py` | Post-tool hook — parses `sf apex run test` JSON output and formats failures for the auto-fix loop | +| `scripts/parse-test-results.py` | Post-tool hook — parses `sf apex run test` JSON output and formats failures for the auto-fix loop | --- diff --git a/skills/platform-apex-test-run/references/testing-best-practices.md b/skills/platform-apex-test-run/references/testing-best-practices.md index b72c520..51cc508 100644 --- a/skills/platform-apex-test-run/references/testing-best-practices.md +++ b/skills/platform-apex-test-run/references/testing-best-practices.md @@ -324,7 +324,7 @@ static void testBulkOperation_StaysWithinLimits() { ## Common Anti-Patterns to Avoid -### ❌ SeeAllData=true +### SeeAllData=true ```apex // ❌ BAD: Depends on org data @@ -342,7 +342,7 @@ static void testGoodPattern() { } ``` -### ❌ No Assertions +### No Assertions ```apex // ❌ BAD: No assertions - test passes even if code is broken @@ -364,7 +364,7 @@ static void testWithAssertions() { } ``` -### ❌ Hardcoded IDs +### Hardcoded IDs ```apex // ❌ BAD: Hardcoded IDs fail across orgs diff --git a/skills/platform-apex-test-run/hooks/scripts/parse-test-results.py b/skills/platform-apex-test-run/scripts/parse-test-results.py similarity index 100% rename from skills/platform-apex-test-run/hooks/scripts/parse-test-results.py rename to skills/platform-apex-test-run/scripts/parse-test-results.py diff --git a/skills/platform-custom-application-generate/SKILL.md b/skills/platform-custom-application-generate/SKILL.md index d373267..aab844b 100644 --- a/skills/platform-custom-application-generate/SKILL.md +++ b/skills/platform-custom-application-generate/SKILL.md @@ -19,7 +19,7 @@ Use this skill when you need to: Custom applications (Lightning Apps) that group tabs and functionality to provide a focused user experience for specific business processes. Always configured for Lightning Experience. -## 🎯 Purpose +## Purpose - Organize related functionality into focused applications - Group tabs and components for specific user roles - Provide tailored user experiences @@ -29,7 +29,7 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - Override standard actions with custom Lightning pages for enhanced user experience - Enable profile-specific experiences through profile action overrides -## ⚙️ Required Properties +## Required Properties ### Core Application Properties - **fullName**: API name of the application @@ -51,7 +51,7 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - **isNavPersonalizationDisabled**: Personalization setting (default: false) - **isNavTabPersistenceDisabled**: Tab persistence setting (default: false) -## 🔧 Application Configuration +## Application Configuration ### Navigation Type Selection (CRITICAL) **Decision Criteria for navType:** @@ -116,7 +116,7 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - **profileActionOverrides.profile**: Profile API name (e.g., "Admin", "Standard User") - Enables different page layouts for different user profiles -## 📱 Device Support +## Device Support ### Desktop Configuration - **formFactor**: "Large" @@ -130,7 +130,7 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - **formFactor**: "Medium" - **tabs**: Tablet-appropriate tab selection -## 🎨 User Experience Features +## User Experience Features ### Navigation Behavior - **Auto Temporary Tabs**: Can be enabled/disabled @@ -142,12 +142,12 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - **Screen Reader**: Compatible with assistive technologies - **High Contrast**: Support for high contrast modes -## 🔗 Integration Points +## Integration Points - **Custom Tabs**: Include custom object and web tabs - **Standard Tabs**: Include standard Salesforce tabs - **Lightning Pages**: Integrate with Lightning page layouts - **Components**: Include custom Lightning components -## ✅ Best Practices +## Best Practices - **Always use Lightning UI**: Set `uiType` to "Lightning" for modern apps - **Choose appropriate navigation**: CRITICAL - Analyze requirements carefully for `navType` selection - Use "Standard" (DEFAULT) for general business applications @@ -168,7 +168,7 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - **Leverage action overrides**: Customize page layouts for specific objects using FlexiPages from flexipage expert - **Use profile overrides**: Provide role-specific experiences by referencing different flexipage expert generated pages per profile -## 🎯 Enhancement Rules +## Enhancement Rules - **uiType**: Always set to "Lightning" for modern app experience - **navType**: CRITICAL DECISION - Analyze user requirements carefully - Set to "Standard" (DEFAULT) for general business applications @@ -192,7 +192,7 @@ Custom applications (Lightning Apps) that group tabs and functionality to provid - **Profile Action Overrides**: Reference flexipage expert generated pages for role-based customization - **Form Factors**: Use "Large" for desktop, "Small" for mobile in overrides -## ⚠️ CRITICAL Verification Checklist (MUST VERIFY) +## CRITICAL Verification Checklist (MUST VERIFY) - [ ] All tabs are included in the application - [ ] **navType IS CORRECTLY SET** - Verify Console vs Standard selection - [ ] Default to "Standard" for most general business applications diff --git a/skills/platform-custom-field-generate/SKILL.md b/skills/platform-custom-field-generate/SKILL.md index ac62d6b..574a785 100644 --- a/skills/platform-custom-field-generate/SKILL.md +++ b/skills/platform-custom-field-generate/SKILL.md @@ -135,7 +135,7 @@ The `` boolean inside `` controls whether only admin-defin --- -## 5. Master-Detail Relationship Rules ⭐ CRITICAL +## 5. Master-Detail Relationship Rules CRITICAL Master-Detail fields have **strict attribute restrictions** that differ from Lookup fields. Violating these rules causes deployment failures. @@ -160,7 +160,7 @@ Master-Detail fields have **strict attribute restrictions** that differ from Loo | `` | ✅ Optional | ❌ Not applicable | | `` | ✅ Optional | ❌ Not applicable | -### ❌ INCORRECT — Master-Detail with forbidden attributes: +### INCORRECT — Master-Detail with forbidden attributes: ```xml @@ -188,7 +188,7 @@ Master-Detail fields have **strict attribute restrictions** that differ from Loo - `Can not specify 'deleteConstraint' for a CustomField of type MasterDetail` - `Lookup filters are only supported on Lookup Relationship Fields` -### ✅ CORRECT — Master-Detail field: +### CORRECT — Master-Detail field: ```xml @@ -206,7 +206,7 @@ Master-Detail fields have **strict attribute restrictions** that differ from Loo ``` -### ✅ CORRECT — Lookup field (with optional attributes): +### CORRECT — Lookup field (with optional attributes): ```xml @@ -240,7 +240,7 @@ Master-Detail fields have **strict attribute restrictions** that differ from Loo --- -## 6. Roll-Up Summary Field Rules ⭐ CRITICAL +## 6. Roll-Up Summary Field Rules CRITICAL Roll-up Summary fields have the **highest deployment failure rate**. Follow these rules exactly. @@ -276,7 +276,7 @@ ChildObjectAPIName__c.FieldAPIName__c - `summaryForeignKey` = `ChildObject__c.MasterDetailFieldOnChild__c` - `summarizedField` = `ChildObject__c.FieldToSummarize__c` -### ❌ INCORRECT — Roll-Up Summary with common errors: +### INCORRECT — Roll-Up Summary with common errors: ```xml @@ -295,7 +295,7 @@ ChildObjectAPIName__c.FieldAPIName__c - `Can not specify 'precision' for a CustomField of type Summary` - `Must specify the name in the CustomObject.CustomField format (e.g. Account.MyNewCustomField)` -### ✅ CORRECT — Roll-Up Summary (SUM operation): +### CORRECT — Roll-Up Summary (SUM operation): ```xml @@ -393,7 +393,7 @@ A Formula is not a type itself. The `` tag is added to a field whose `< - IF formula result type = `Number`, `Currency`, or `Percent` → set `BlankAsZero` - IF formula result type = `Text`, `Date`, or `DateTime` → set `BlankAsBlank` -### ❌ INCORRECT — Using Formula as type: +### INCORRECT — Using Formula as type: ```xml @@ -404,7 +404,7 @@ A Formula is not a type itself. The `` tag is added to a field whose `< ``` -### ✅ CORRECT — Formula field: +### CORRECT — Formula field: ```xml @@ -460,7 +460,7 @@ Before generating CustomField XML, verify: - [ ] Is `