From f528c8dbb4e6504995c6df0db89b68b837052abd Mon Sep 17 00:00:00 2001 From: Ash Shaw Date: Thu, 18 Jun 2026 17:31:16 +0200 Subject: [PATCH 1/5] fix: make mermaid diagrams accessible --- .github/ISSUE_TEMPLATE/README.md | 6 +- .github/README.md | 24 +- .../.archive/frontmatter.instructions.md | 2 + .../.archive/tests.instructions.md | 6 + .../prompts/update-mermaid-diagrams.prompt.md | 50 +- .../reports/mermaid-accessibility-report.md | 1202 ++++++++++++++++- ...maid-diagram-accessibility-spreadsheet.csv | 43 +- .github/reports/mermaid-validation-report.md | 894 +++++++++++- .../colour-contrast-report-2026-06-18.md | 8 +- .../mermaid/diagram-validation-2025-12-11.md | 2 + .github/workflows/readme-audit.yml | 35 +- .github/workflows/readme-update.yml | 13 +- .vscode/README.md | 8 +- CONTRIBUTING.md | 2 + README.md | 42 +- docs/AGENT_CREATION.md | 50 +- docs/HUSKY_PRECOMMITS.md | 2 + instructions/automation.instructions.md | 4 + .../documentation-formats.instructions.md | 20 +- instructions/linting.instructions.md | 4 + instructions/mermaid.instructions.md | 160 +-- .../quality-assurance.instructions.md | 14 +- package.json | 3 +- profile/README.md | 34 +- scripts/README.md | 28 +- scripts/fix-mermaid-diagrams.js | 156 ++- .../validate-mermaid-accessibility.js | 19 +- .../validate-mermaid-colour-contrast.js | 211 +-- scripts/validation/validate-mermaid-syntax.js | 18 +- 29 files changed, 2557 insertions(+), 503 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/README.md b/.github/ISSUE_TEMPLATE/README.md index b4157ad4b..5b8f47afa 100644 --- a/.github/ISSUE_TEMPLATE/README.md +++ b/.github/ISSUE_TEMPLATE/README.md @@ -3,7 +3,7 @@ title: "Issue Templates Directory" description: "Standardized issue templates for the LightSpeedWP organization. Templates for bugs, features, documentation, and custom issues with automation integration." name: "Issue Templates" file_type: documentation -version: v1.6 +version: v1.5 last_updated: "2026-06-18" created_date: "2025-10-20" authors: ["LightSpeed Team"] @@ -46,10 +46,8 @@ For advanced usage, see the [Issue Template Index](./README.md) and individual t ## ๐Ÿ—‚๏ธ Issue Template Workflow ```mermaid ---- accTitle: Issue template workflow -accDescr: Shows the issue creation workflow from template selection through auto-population, agent processing, auto-labeling, issue type assignment, project board assignment, and notification routing, with template sync feeding all organisation repositories. ---- +accDescr: Shows how users select an issue template, auto-populated fields flow into issue creation, and automation routes the issue to labelling, project, and notification steps. flowchart TD A[User Creates Issue] --> B{Select Template} B -->|Bug Report| C[Bug Template] diff --git a/.github/README.md b/.github/README.md index c192c3b99..c60162346 100644 --- a/.github/README.md +++ b/.github/README.md @@ -116,10 +116,10 @@ accDescr { P --> R Q --> S - style A fill:#e1f5fe - style D fill:#fce4ec - style M fill:#e8f5e8 - style R fill:#fff3e0 + style A fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + style D fill:#f3e8ff,color:#3b0764,stroke:#7e22ce + style M fill:#dcfce7,color:#14532d,stroke:#14532d + style R fill:#fef3c7,color:#4a2c00,stroke:#b45309 ``` **Key goals:** @@ -316,10 +316,10 @@ accDescr { H --> H4 D --> D1 - style A fill:#e1f5fe - style B fill:#fce4ec - style H fill:#e8f5e8 - style D fill:#fff3e0 + style A fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + style B fill:#f3e8ff,color:#3b0764,stroke:#7e22ce + style H fill:#dcfce7,color:#14532d,stroke:#14532d + style D fill:#fef3c7,color:#4a2c00,stroke:#b45309 ``` ## Directory Structure Details @@ -454,10 +454,10 @@ accDescr { L --> P M --> Q - style A fill:#e1f5fe - style E fill:#f3e5f5 - style J fill:#e8f5e8 - style N fill:#c8e6c9 + style A fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + style E fill:#f3e8ff,color:#3b0764,stroke:#7e22ce + style J fill:#dcfce7,color:#14532d,stroke:#14532d + style N fill:#dcfce7,color:#14532d,stroke:#14532d ``` ## Component Integration Details diff --git a/.github/instructions/.archive/frontmatter.instructions.md b/.github/instructions/.archive/frontmatter.instructions.md index b244c7f8b..e815260d9 100644 --- a/.github/instructions/.archive/frontmatter.instructions.md +++ b/.github/instructions/.archive/frontmatter.instructions.md @@ -83,6 +83,8 @@ references: - VS Code and Copilot validate automatically if configured (see `.vscode/settings.json`). ```mermaid +accTitle: Frontmatter validation flow +accDescr: Shows how a file with frontmatter moves through schema validation and either passes or returns for correction before automation uses it. graph TD A[File with Frontmatter] --> B[Schema Validation] B -->|Valid| C[Accepted] diff --git a/.github/instructions/.archive/tests.instructions.md b/.github/instructions/.archive/tests.instructions.md index 07da70c14..ee4eb34a4 100644 --- a/.github/instructions/.archive/tests.instructions.md +++ b/.github/instructions/.archive/tests.instructions.md @@ -85,6 +85,8 @@ You are the test style and quality enforcer for LightSpeed projects. Maintain co ## ๐Ÿงช Testing Pyramid ```mermaid +accTitle: Testing pyramid overview +accDescr: Shows how end-to-end, integration, unit, and static analysis layers stack within the testing strategy. graph TD A[E2E Tests
Playwright] --> B[Integration Tests
Jest + PHPUnit] B --> C[Unit Tests
Jest + PHPUnit + pytest] @@ -94,6 +96,8 @@ graph TD ## ๐Ÿ”„ Test Execution Flow ```mermaid +accTitle: Test execution flow +accDescr: Shows how a developer runs local tests, receives coverage feedback, and then CI repeats the test stages and quality gate checks. sequenceDiagram participant Dev as Developer participant Local as Local Tests @@ -173,6 +177,8 @@ sequenceDiagram ## ๐Ÿ“Š Test Coverage Matrix ```mermaid +accTitle: Test coverage matrix +accDescr: Shows how code changes branch into unit, integration, and end-to-end tests before reaching the quality gate. graph LR A[Code Changes] --> B{Test Type} B --> C[Unit Tests
Fast & Isolated] diff --git a/.github/prompts/update-mermaid-diagrams.prompt.md b/.github/prompts/update-mermaid-diagrams.prompt.md index 669599a65..b2dcc3604 100644 --- a/.github/prompts/update-mermaid-diagrams.prompt.md +++ b/.github/prompts/update-mermaid-diagrams.prompt.md @@ -1,28 +1,29 @@ --- file_type: "prompt" title: "Update Mermaid Diagrams" -description: "Refresh Mermaid diagrams across the repository or targeted paths with WCAG 2.2 AA colour contrast, updated content, and current standards." +description: "Refresh Mermaid diagrams across the repository with WCAG 2.2 AA contrast, explicit accessibility metadata, and current repository standards." mode: "agent" tools: ["read", "edit", "search", "shell"] -tags: ["mermaid", "documentation", "a11y", "wcag", "colour-contrast", "readme", "automation"] +tags: ["mermaid", "documentation", "a11y", "wcag", "colour-contrast", "readme"] last_updated: "2026-06-18" --- # Update Mermaid Diagrams -Refresh Mermaid diagrams across the repository to conform with the v2.0 standards in `instructions/mermaid.instructions.md`. +Refresh Mermaid diagrams across the repository to conform with the current standards in `instructions/mermaid.instructions.md`. ## Standards Reference -- **Instructions**: `instructions/mermaid.instructions.md` โ€” v2.0 approved palette, required structure, emoji vocabulary -- **Validator**: `scripts/validation/validate-mermaid-colour-contrast.js` โ€” WCAG 2.2 AA contrast checker -- **Workflow**: `.github/workflows/validate-mermaid-pr.yml` โ€” PR enforcement +- **Instructions**: `instructions/mermaid.instructions.md` - required structure, palette, and accessibility rules +- **Validator**: `scripts/validation/validate-mermaid-accessibility.js` - accTitle / accDescr checks +- **Validator**: `scripts/validation/validate-mermaid-colour-contrast.js` - WCAG 2.2 AA colour contrast checks +- **Workflow**: `.github/workflows/readme-audit.yml` and `.github/workflows/readme-update.yml` - audit and update automation ## What to Fix in Every Diagram ### 1. Required accessibility header block -Every `\`\`\`mermaid` block must open with a YAML header before the diagram type: +Every `\`\`\`mermaid` block must open with an accessibility header before the diagram type: ```text --- @@ -46,19 +47,19 @@ accDescr { Remove any legacy inline `accTitle` / `accDescr` attributes that appear after the diagram type line. -### 2. Approved colour palette โ€” replace ALL old `style` declarations +### 2. Approved colour palette -Replace every old `style X fill:#colour` (single property) with an approved triple. Choose the role that best matches the node's meaning: +Replace every `style` or `classDef` declaration that sets a `fill:` colour with an approved triple. Choose the role that best matches the node's meaning: | Role | fill | color | stroke | |------|------|-------|--------| -| Information (entry points, primary) | `#dbeafe` | `#1e3a5f` | `#1e3a5f` | -| Success (outputs, completed) | `#dcfce7` | `#14532d` | `#14532d` | -| Warning (caution, external) | `#fef3c7` | `#4a2c00` | `#b45309` | -| Error / Alert (failure, blockers) | `#fee2e2` | `#7f1d1d` | `#b91c1c` | -| Documentation (specs, instructions, AI) | `#f3e8ff` | `#3b0764` | `#7e22ce` | -| Neutral (connectors, supporting) | `#f1f5f9` | `#0f172a` | `#334155` | -| Highlight (automation, key actions) | `#ecfdf5` | `#064e3b` | `#059669` | +| Information | `#dbeafe` | `#1e3a5f` | `#1e3a5f` | +| Success | `#dcfce7` | `#14532d` | `#14532d` | +| Warning | `#fef3c7` | `#4a2c00` | `#b45309` | +| Error / Alert | `#fee2e2` | `#7f1d1d` | `#b91c1c` | +| Documentation | `#f3e8ff` | `#3b0764` | `#7e22ce` | +| Neutral | `#f1f5f9` | `#0f172a` | `#334155` | +| Highlight | `#ecfdf5` | `#064e3b` | `#059669` | Example: @@ -70,7 +71,7 @@ style C fill:#dcfce7,color:#14532d,stroke:#14532d ### 3. Diagram type and direction -- Prefer `flowchart` over `graph` (current Mermaid standard). +- Prefer `flowchart` over `graph`. - Always specify direction: `flowchart LR`, `flowchart TD`, etc. ### 4. Emoji vocabulary @@ -92,28 +93,29 @@ Update diagram content to reflect the current codebase. Check: ## Process -1. Run the contrast validator to get the full list of affected files: +1. Run the Mermaid validators to identify all affected files: ```bash + npm run validate:mermaid-accessibility npm run validate:mermaid-contrast ``` 2. For each file with findings, open it and apply the fixes above. -3. After fixing all files, run the full suite to confirm zero failures: +3. After fixing all files, run the full Mermaid suite: ```bash npm run validate:mermaid ``` -4. If adding new diagrams to README files that don't have one, ensure the diagram accurately represents what that file/folder contains. +4. If a documentation file does not yet contain a diagram, only add one when the visual adds clear value over prose. ## Validation Gate -All three checks must pass before committing: +All Mermaid checks must pass before merging: ```bash -npm run validate:mermaid-syntax # diagram type, direction, bracket matching -npm run validate:mermaid-accessibility # accTitle and accDescr present -npm run validate:mermaid-contrast # WCAG 2.2 AA colour contrast +npm run validate:mermaid-syntax +npm run validate:mermaid-accessibility +npm run validate:mermaid-contrast ``` diff --git a/.github/reports/mermaid-accessibility-report.md b/.github/reports/mermaid-accessibility-report.md index c8f1d2339..754788e28 100644 --- a/.github/reports/mermaid-accessibility-report.md +++ b/.github/reports/mermaid-accessibility-report.md @@ -1,9 +1,9 @@ --- title: Mermaid Diagram Accessibility Compliance Report โ€” Issue #669 -description: Accessibility compliance audit of all 23 Mermaid diagrams for accTitle and accDescr attributes -version: 1.1.0 +description: Accessibility compliance audit of all 24 Mermaid diagrams for accTitle and accDescr attributes +version: 1.0.0 created_date: "2026-05-31" -last_updated: "2026-06-18" +last_updated: "2026-05-31" file_type: documentation maintainer: Claude Code owners: @@ -27,108 +27,1222 @@ stability: stable ## Summary -- **Total diagrams**: 23 -- **Accessible diagrams**: 23 +- **Total diagrams**: 60 +- **Accessible diagrams**: 60 - **Non-compliant diagrams**: 0 - **Compliance rate**: 100.0% ## Files Analyzed +- .github/CodeRabbit-Config-Spec.md - .github/DISCUSSION_TEMPLATE/README.md +- .github/ISSUE_TEMPLATE/01-task.md +- .github/ISSUE_TEMPLATE/02-bug.md +- .github/ISSUE_TEMPLATE/03-feature.md +- .github/ISSUE_TEMPLATE/04-design.md +- .github/ISSUE_TEMPLATE/05-epic.md +- .github/ISSUE_TEMPLATE/06-story.md +- .github/ISSUE_TEMPLATE/07-improvement.md +- .github/ISSUE_TEMPLATE/08-chore.md +- .github/ISSUE_TEMPLATE/09-code-refactor.md +- .github/ISSUE_TEMPLATE/10-build-ci.md +- .github/ISSUE_TEMPLATE/11-automation.md +- .github/ISSUE_TEMPLATE/12-testing-coverage.md +- .github/ISSUE_TEMPLATE/13-performance.md +- .github/ISSUE_TEMPLATE/14-a11y.md +- .github/ISSUE_TEMPLATE/15-security.md +- .github/ISSUE_TEMPLATE/16-compatibility.md +- .github/ISSUE_TEMPLATE/17-integration-issue.md +- .github/ISSUE_TEMPLATE/18-release.md +- .github/ISSUE_TEMPLATE/19-maintenance.md +- .github/ISSUE_TEMPLATE/20-documentation.md +- .github/ISSUE_TEMPLATE/21-research.md +- .github/ISSUE_TEMPLATE/22-audit.md +- .github/ISSUE_TEMPLATE/23-code-review.md +- .github/ISSUE_TEMPLATE/24-ai-ops.md +- .github/ISSUE_TEMPLATE/25-content-modelling.md - .github/ISSUE_TEMPLATE/README.md - .github/PULL_REQUEST_TEMPLATE/README.md +- .github/PULL_REQUEST_TEMPLATE/pr_bug.md +- .github/PULL_REQUEST_TEMPLATE/pr_chore.md +- .github/PULL_REQUEST_TEMPLATE/pr_ci.md +- .github/PULL_REQUEST_TEMPLATE/pr_dep_update.md +- .github/PULL_REQUEST_TEMPLATE/pr_docs.md +- .github/PULL_REQUEST_TEMPLATE/pr_feature.md +- .github/PULL_REQUEST_TEMPLATE/pr_hotfix.md +- .github/PULL_REQUEST_TEMPLATE/pr_refactor.md +- .github/PULL_REQUEST_TEMPLATE/pr_release.md - .github/README.md +- .github/SAVED_REPLIES.md - .github/SAVED_REPLIES/README.md +- .github/SAVED_REPLIES/community/code-of-conduct.md +- .github/SAVED_REPLIES/community/contribution-thanks.md +- .github/SAVED_REPLIES/community/guidelines.md +- .github/SAVED_REPLIES/community/legal.md +- .github/SAVED_REPLIES/community/welcome.md +- .github/SAVED_REPLIES/issues/a11y-acknowledge.md +- .github/SAVED_REPLIES/issues/area-routing.md +- .github/SAVED_REPLIES/issues/blockers.md +- .github/SAVED_REPLIES/issues/bug-reports.md +- .github/SAVED_REPLIES/issues/documentation.md +- .github/SAVED_REPLIES/issues/duplicate.md +- .github/SAVED_REPLIES/issues/duplicates.md +- .github/SAVED_REPLIES/issues/epic-tracking.md +- .github/SAVED_REPLIES/issues/feature-requests.md +- .github/SAVED_REPLIES/issues/good-first-issue.md +- .github/SAVED_REPLIES/issues/inactive-issue.md +- .github/SAVED_REPLIES/issues/label-clarification.md +- .github/SAVED_REPLIES/issues/meta-label-nudge.md +- .github/SAVED_REPLIES/issues/missing-info.md +- .github/SAVED_REPLIES/issues/more-info.md +- .github/SAVED_REPLIES/issues/needs-reproduction.md +- .github/SAVED_REPLIES/issues/research-completion.md +- .github/SAVED_REPLIES/issues/security-acknowledge.md +- .github/SAVED_REPLIES/issues/stale-abandoned.md +- .github/SAVED_REPLIES/issues/support.md +- .github/SAVED_REPLIES/issues/triage.md +- .github/SAVED_REPLIES/issues/wontfix.md +- .github/SAVED_REPLIES/pull-requests/ai-assist.md +- .github/SAVED_REPLIES/pull-requests/area-labeling.md +- .github/SAVED_REPLIES/pull-requests/area-routing.md +- .github/SAVED_REPLIES/pull-requests/automated-dependency-update.md +- .github/SAVED_REPLIES/pull-requests/awaiting-author.md +- .github/SAVED_REPLIES/pull-requests/branch-naming.md +- .github/SAVED_REPLIES/pull-requests/changelog-required.md +- .github/SAVED_REPLIES/pull-requests/closing-inactive.md +- .github/SAVED_REPLIES/pull-requests/code-review.md +- .github/SAVED_REPLIES/pull-requests/conflicts.md +- .github/SAVED_REPLIES/pull-requests/dependency-update.md +- .github/SAVED_REPLIES/pull-requests/documentation-pr.md +- .github/SAVED_REPLIES/pull-requests/draft-pr.md +- .github/SAVED_REPLIES/pull-requests/merge-discipline.md +- .github/SAVED_REPLIES/pull-requests/missing-labels.md +- .github/SAVED_REPLIES/pull-requests/needs-qa.md +- .github/SAVED_REPLIES/pull-requests/performance.md +- .github/SAVED_REPLIES/pull-requests/ready-for-review.md +- .github/SAVED_REPLIES/pull-requests/release-label-guidance.md +- .github/SAVED_REPLIES/pull-requests/security.md +- .github/SAVED_REPLIES/pull-requests/testing.md +- .github/SAVED_REPLIES/technical/api-integration.md +- .github/SAVED_REPLIES/technical/code-style.md +- .github/SAVED_REPLIES/technical/configuration.md +- .github/SAVED_REPLIES/technical/dependencies.md +- .github/SAVED_REPLIES/technical/dependency-update.md +- .github/SAVED_REPLIES/technical/environment-config.md +- .github/SAVED_REPLIES/technical/environment.md +- .github/SAVED_REPLIES/technical/missing-tests.md +- .github/SAVED_REPLIES/technical/performance.md +- .github/SAVED_REPLIES/technical/security.md +- .github/SAVED_REPLIES/workflow/automation.md +- .github/SAVED_REPLIES/workflow/branch-management.md +- .github/SAVED_REPLIES/workflow/branches.md +- .github/SAVED_REPLIES/workflow/changelog-versioning.md +- .github/SAVED_REPLIES/workflow/cicd-failures.md +- .github/SAVED_REPLIES/workflow/dependency-update.md +- .github/SAVED_REPLIES/workflow/deployment.md +- .github/SAVED_REPLIES/workflow/draft-pr.md +- .github/SAVED_REPLIES/workflow/environment-config.md +- .github/SAVED_REPLIES/workflow/labeling.md +- .github/SAVED_REPLIES/workflow/needs-rebase.md +- .github/SAVED_REPLIES/workflow/permissions-secrets.md +- .github/SAVED_REPLIES/workflow/project-sync.md +- .github/SAVED_REPLIES/workflow/release-management.md +- .github/SAVED_REPLIES/workflow/releases.md +- .github/SAVED_REPLIES/workflow/workflow-failure.md - .github/agents/README.md +- .github/custom-instructions.md +- .github/instructions/.archive/CONSOLIDATION_MIGRATION_GUIDE.md +- .github/instructions/.archive/INSTRUCTION_CONSOLIDATION_MIGRATION.md - .github/instructions/.archive/README.md +- .github/instructions/.archive/agents.instructions.md +- .github/instructions/.archive/file-management.instructions.md +- .github/instructions/.archive/frontmatter.instructions.md +- .github/instructions/.archive/javascript.instructions.md +- .github/instructions/.archive/jest.instructions.md +- .github/instructions/.archive/jsdoc.instructions.md +- .github/instructions/.archive/json.instructions.md +- .github/instructions/.archive/markdown.instructions.md +- .github/instructions/.archive/naming-conventions.instructions.md +- .github/instructions/.archive/reporting.instructions.md +- .github/instructions/.archive/reviewer.instructions.md +- .github/instructions/.archive/saved-replies.instructions.md +- .github/instructions/.archive/testing.instructions.md +- .github/instructions/.archive/tests.instructions.md +- .github/instructions/.archive/yaml.instructions.md - .github/instructions/README.md +- .github/instructions/markdown.instructions.md - .github/metrics/README.md -- .github/projects/README.md -- .github/projects/active/openspec/README.md -- .github/projects/active/openspec/changes/test-coverage-implementation/README.md -- .github/projects/active/template-enforcement-governance/README.md -- .github/projects/active/template-enforcement-governance/openspec-strict/README.md -- .github/projects/active/test-coverage-implementation/README.md -- .github/projects/active/test-coverage-implementation/openspec-strict/README.md -- .github/projects/active/wave-5-documentation-audit/execution/issue-seed-2026-06-08/README.md -- .github/projects/archived/awesome-github-site/README.md -- .github/projects/archived/awesome-github-site/openspec/README.md -- .github/projects/archived/awesome-github-site/phase-1/README.md -- .github/projects/archived/awesome-github-site/phase-2/README.md -- .github/projects/completed/adoption-workstream-2026-05-26/README.md -- .github/projects/completed/agent-skill-memory-platform/issues/README.md -- .github/projects/completed/awesome-github-site/README.md -- .github/projects/completed/awesome-github-site/openspec/README.md -- .github/projects/completed/awesome-github-site/phase-1/README.md -- .github/projects/completed/awesome-github-site/phase-2/README.md -- .github/projects/completed/branch-governance-hardening-2026-06-08/README.md -- .github/projects/completed/branch-governance-hardening-2026-06-08/openspec-strict/README.md -- .github/projects/completed/github-workflow-consolidation-2026-05-28/README.md -- .github/projects/completed/github-workflow-consolidation-2026-05-28/issues/README.md -- .github/projects/completed/issue-35-instruction-audit/README.md -- .github/projects/completed/issue-670-readme-refresh/README.md -- .github/projects/completed/label-governance-stabilisation-2026-05-27/README.md -- .github/projects/completed/label-governance-stabilisation-2026-05-27/issues/README.md -- .github/projects/completed/plugin-pack-waves/README.md -- .github/projects/completed/plugin-pack-waves/issues/README.md -- .github/projects/completed/plugin-pack-waves/openspec-strict/README.md -- .github/projects/completed/portable-ai-plugin-restructure/issues/README.md -- .github/projects/completed/refactor-migrate-prompts/openspec-strict/README.md -- .github/projects/completed/refactor-migrate-prompts/openspec/README.md -- .github/projects/completed/root-cleanup-dependency-audit-closed-2026-06-08/README.md -- .github/projects/completed/root-cleanup-dependency-audit-closed-2026-06-08/openspec-strict/README.md -- .github/projects/completed/wave-5-documentation-audit-closed-2026-06-01/README.md +- .github/metrics/meta-log.md +- .github/metrics/out/frontmatter-metrics.md - .github/prompts/README.md +- .github/prompts/add-frontmatter.prompt.md +- .github/prompts/agent-task-markdown-linting.prompt.md +- .github/prompts/agents.prompt.md +- .github/prompts/architecture-blueprint-generator.prompt.md +- .github/prompts/breakdown-epic-arch.prompt.md +- .github/prompts/breakdown-epic-pm.prompt.md +- .github/prompts/breakdown-feature-implementation.prompt.md +- .github/prompts/breakdown-feature-prd.prompt.md +- .github/prompts/breakdown-plan.prompt.md +- .github/prompts/breakdown-test.prompt.md +- .github/prompts/build-agent-and-tests.prompt.md +- .github/prompts/changelog-lines.prompt.md +- .github/prompts/changelog.prompt.md +- .github/prompts/code-review.prompt.md +- .github/prompts/conventional-commit.prompt.md +- .github/prompts/create-agentsmd.prompt.md +- .github/prompts/create-architectural-decision-record.prompt.md +- .github/prompts/create-github-action-workflow-specification.prompt.md +- .github/prompts/create-github-issue-feature-from-specification.prompt.md +- .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md +- .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md +- .github/prompts/create-github-pull-request-from-specification.prompt.md +- .github/prompts/create-implementation-plan.prompt.md +- .github/prompts/create-llms.prompt.md +- .github/prompts/create-readme.prompt.md +- .github/prompts/create-specification.prompt.md +- .github/prompts/dependency-audit-agent.prompt.md +- .github/prompts/docs-from-comments.prompt.md +- .github/prompts/docs-writeup.prompt.md +- .github/prompts/documentation-writer.prompt.md +- .github/prompts/editorconfig.prompt.md +- .github/prompts/finalize-agent-prompt.prompt.md +- .github/prompts/folder-structure-blueprint-generator.prompt.md +- .github/prompts/generate-changelog.prompt.md +- .github/prompts/generate-custom-instructions-from-codebase.prompt.md +- .github/prompts/generate-gh-workflow.prompt.md +- .github/prompts/generate-pr-description.prompt.md +- .github/prompts/git-flow-branch-creator.prompt.md +- .github/prompts/github-copilot-starter.prompt.md +- .github/prompts/inline-documentation.prompt.md +- .github/prompts/labeling.prompt.md +- .github/prompts/model-recommendation.prompt.md +- .github/prompts/multi-stage-dockerfile.prompt.md +- .github/prompts/my-issues.prompt.md +- .github/prompts/my-pull-requests.prompt.md +- .github/prompts/normalize-docs-labels.prompt.md +- .github/prompts/pr-description.prompt.md +- .github/prompts/pr-review.prompt.md +- .github/prompts/project-workflow-analysis-blueprint-generator.prompt.md +- .github/prompts/prompt-builder.prompt.md +- .github/prompts/prompts.md +- .github/prompts/python-mcp-server-generator.prompt.md +- .github/prompts/readme-blueprint-generator.prompt.md +- .github/prompts/release.prompt.md +- .github/prompts/remember-interactive-programming.prompt.md +- .github/prompts/remember.prompt.md +- .github/prompts/repo-story-time.prompt.md +- .github/prompts/reporting.prompt.md +- .github/prompts/review-and-refactor.prompt.md +- .github/prompts/saved-replies.prompt.md +- .github/prompts/shuffle-json-data.prompt.md +- .github/prompts/spec-driven-workflow-start.prompt.md +- .github/prompts/technology-stack-blueprint-generator.prompt.md +- .github/prompts/testing.prompt.md +- .github/prompts/update-implementation-plan.prompt.md +- .github/prompts/update-llms.prompt.md +- .github/prompts/update-markdown-file-index.prompt.md +- .github/prompts/update-mermaid-diagrams.prompt.md +- .github/prompts/update-oo-component-documentation.prompt.md +- .github/prompts/update-readmes.prompt.md +- .github/prompts/update-specification.prompt.md +- .github/prompts/write-coding-standards-from-file.prompt.md +- .github/pull_request_template.md - .github/reports/README.md +- .github/reports/agents/agent-infrastructure-audit-2025-12-10.md +- .github/reports/agents/agent-tools-permissions-mcp-audit-2026-06-02.md +- .github/reports/agents/critical-agent-fixes-2025-12-10.md +- .github/reports/analysis/pre-release-audit-v1.0.0.md +- .github/reports/analysis/reports-folder-structure-audit-2025-12-10.md +- .github/reports/analysis/test-coverage-expansion-plan.md +- .github/reports/audits/2026-06-03-agent-script-migration-status-audit-672.md +- .github/reports/audits/2026-06-03-docs-folder-structure-vs-claude-boundaries-audit-665.md +- .github/reports/audits/2026-06-03-file-organisation-migration-plan-673.md +- .github/reports/audits/2026-06-03-file-organisation-vs-claude-boundaries-audit-671.md +- .github/reports/audits/2026-06-03-issue-fields-config-vs-github-api-audit-660.md +- .github/reports/audits/2026-06-03-issue-labeling-rules-in-labeler-audit-656.md +- .github/reports/audits/2026-06-03-issue-template-automation-trigger-mapping-audit-655.md +- .github/reports/audits/2026-06-03-issue-template-inventory-standardization-audit-654.md +- .github/reports/audits/2026-06-03-labeling-docs-consolidation-audit-664.md +- .github/reports/audits/2026-06-07-private-project-issue-field-write-verification-879.md +- .github/reports/audits/WORKFLOW_AUDIT_REPORT.md +- .github/reports/audits/governance-change-management-audit-2026-05-19.md +- .github/reports/audits/governance-change-management-audit-2026-05-27.md +- .github/reports/audits/issue-32-closeout-comments-2026-05-26.md +- .github/reports/audits/issue-95-orphan-labels-audit-2026-05-27.md +- .github/reports/audits/issue-creation-docs-audit-report.md +- .github/reports/audits/issue-pr-metadata-audit-300plus-2026-05-27.md +- .github/reports/audits/issue-types-alignment-audit-2026-06-01.md +- .github/reports/audits/label-color-consistency-audit-2026-06-01.md +- .github/reports/audits/readme-audit-2026-05-31.md +- .github/reports/audits/readme-audit-extended-2026-05-31.md +- .github/reports/audits/workflow-standards-audit-2026-05-31.md +- .github/reports/canonical-config-audit-2026-05-31.md +- .github/reports/issue-template-audit-2026-05-31.md +- .github/reports/mermaid-accessibility-report.md +- .github/reports/mermaid-audit/audit-log.md +- .github/reports/mermaid-audit/audit-report-2026-05-28.md +- .github/reports/mermaid-diagram-audit.md +- .github/reports/mermaid-validation-report.md +- .github/reports/mermaid/colour-contrast-report-2026-06-18.md +- .github/reports/mermaid/diagram-validation-2025-12-11.md +- .github/reports/metrics/weekly-summary-2025-12-08.md +- .github/reports/migration/INSTRUCTIONS_MIGRATION_GUIDE.md +- .github/reports/migration/file-organization-migration-2025-12-09.md +- .github/reports/tech-debt/v1.0.0-pre-launch-debt.md +- .github/reports/validation/pre-launch-validation-2025-12-10.md +- .github/reports/validation/v1.0.0-launch-readiness-final-2025-12-10.md +- .github/reports/wave-4c-audit-report.md +- .github/reports/wave-4c-remediation-plan.md +- .github/reports/wave-5-4-readme-discovery-audit.md +- .github/reports/wave-5-completion-summary.md +- .github/reports/weekly-summary-2025-12-15.md +- .github/reports/weekly-summary-2025-12-22.md +- .github/reports/weekly-summary-2025-12-29.md +- .github/reports/weekly-summary-2026-01-05.md +- .github/reports/weekly-summary-2026-01-12.md +- .github/reports/weekly-summary-2026-01-19.md +- .github/reports/weekly-summary-2026-01-26.md +- .github/reports/weekly-summary-2026-02-02.md +- .github/reports/weekly-summary-2026-02-09.md +- .github/reports/weekly-summary-2026-02-16.md +- .github/reports/weekly-summary-2026-02-23.md +- .github/reports/weekly-summary-2026-03-02.md +- .github/reports/weekly-summary-2026-03-09.md +- .github/reports/weekly-summary-2026-03-16.md +- .github/reports/weekly-summary-2026-03-23.md +- .github/reports/weekly-summary-2026-03-30.md +- .github/reports/weekly-summary-2026-04-06.md +- .github/reports/weekly-summary-2026-04-13.md +- .github/reports/weekly-summary-2026-04-20.md +- .github/reports/weekly-summary-2026-04-27.md +- .github/reports/weekly-summary-2026-05-04.md +- .github/reports/weekly-summary-2026-05-11.md +- .github/reports/weekly-summary-2026-05-18.md +- .github/reports/weekly-summary-2026-05-25.md +- .github/reports/weekly-summary-2026-06-01.md - .github/rulesets/README.md - .github/schemas/README.md - .github/tests/fixtures/pr-templates/README.md +- .github/tests/fixtures/pr-templates/invalid/missing-changelog-entry.md +- .github/tests/fixtures/pr-templates/invalid/missing-linked-issues.md +- .github/tests/fixtures/pr-templates/invalid/unchecked-checklist.md +- .github/tests/fixtures/pr-templates/valid/pr_bug.md +- .github/tests/fixtures/pr-templates/valid/pr_chore.md +- .github/tests/fixtures/pr-templates/valid/pr_ci.md +- .github/tests/fixtures/pr-templates/valid/pr_dep_update.md +- .github/tests/fixtures/pr-templates/valid/pr_docs.md +- .github/tests/fixtures/pr-templates/valid/pr_feature.md +- .github/tests/fixtures/pr-templates/valid/pr_hotfix.md +- .github/tests/fixtures/pr-templates/valid/pr_refactor.md +- .github/tests/fixtures/pr-templates/valid/pr_release.md - .github/workflows/README.md - .schemas/README.md - .vscode/README.md +- AGENTS.md +- CHANGELOG.md +- CLAUDE.md +- CODE_OF_CONDUCT.md +- CONTRIBUTING.md +- DEVELOPMENT.md +- GOVERNANCE.md - README.md +- SECURITY.md +- SUPPORT.md - agents/README.md +- agents/adr.agent.md +- agents/agent.md +- agents/issues.agent.md +- agents/labeling.agent.md +- agents/linting.agent.md +- agents/meta.agent.md +- agents/metrics.agent.md +- agents/mode-demonstrate-understanding.agent.md +- agents/mode-document-reviewer.agent.md +- agents/mode-prd.agent.md +- agents/mode-thinking.agent.md +- agents/project-meta-sync.agent.md +- agents/prompt-engineer.agent.md +- agents/release.agent.md +- agents/reporting.agent.md +- agents/reviewer.agent.md +- agents/task-planner.agent.md +- agents/task-researcher.agent.md +- agents/template.agent.md +- agents/testing.agent.md +- ai/AUDIT-SUMMARY.md +- ai/Claude.md +- ai/Gemini.md - ai/README.md +- ai/RUNNERS.md +- ai/agents.md +- ai/audit-planner-reviewer-agents.md +- ai/improvement-plan-planner-reviewer.md - cookbook/README.md +- cookbook/project-planning-and-prd-playbook.md +- cookbook/spec-driven-workflow-example.md +- cookbook/wordpress-plugin-checklist.md +- docs/AGENT_CREATION.md +- docs/ARCHITECTURE.md +- docs/AUDIT_PR_DOCS_663.md +- docs/AUTOMATION.md +- docs/AWESOME_ALIGNMENT.md +- docs/AWESOME_GITHUB_MAPPING_STRATEGY.md +- docs/BRANCHING_STRATEGY.md +- docs/BRANDING_AGENT_USAGE.md +- docs/BRANDING_CONFIG_SPEC.md +- docs/CANONICAL_CONFIGS_GUIDE.md +- docs/CONFIGS.md +- docs/CROSS_PLATFORM_SKILL_YAML_SPEC.md +- docs/DECISIONS.md +- docs/DEPLOY.md +- docs/DISCUSSIONS.md +- docs/FOOTER_REMEDIATION_GUIDE.md +- docs/FRONTMATTER_SCHEMA.md +- docs/GITHUB_PROJECT_OPERATIONS_SPEC.md +- docs/GOVERNANCE_REVISION_LOG.md +- docs/HUSKY_PRECOMMITS.md +- docs/ISSUE_CREATION_GUIDE.md +- docs/ISSUE_FIELDS.md +- docs/ISSUE_TYPES.md +- docs/LABELING.md +- docs/LABEL_COLOR_STRATEGY.md +- docs/LABEL_INVENTORY.md +- docs/LABEL_STRATEGY.md +- docs/LINTING.md +- docs/METRICS.md +- docs/MIGRATION.md +- docs/MIGRATION_GUIDE.md +- docs/ORGANIZATION.md +- docs/OVERRIDE_POLICY.md +- docs/PLUGIN_INSTALLATION_GUIDE.md +- docs/PLUGIN_PACK_ROADMAP.md +- docs/PR_CREATION_PROCESS.md - docs/README.md +- docs/RELEASE_PROCESS.md +- docs/ROADMAP.md +- docs/SHARED_GITHUB_ADOPTION_GUIDE.md +- docs/TESTING.md +- docs/VERSIONING.md +- docs/WORKFLOW_COORDINATION.md +- docs/agents/AGENT_ARCHITECTURE.md +- docs/agents/PLANNER_RUNBOOK.md +- docs/agents/REVIEWER_RUNBOOK.md +- docs/downstream/tour-operator-adoption.md +- docs/index.md - hooks/README.md - hooks/secrets-scanner/README.md - hooks/session-logger/README.md - hooks/tool-guardian/README.md +- instructions/DEPRECATED.md - instructions/README.md +- instructions/a11y.instructions.md +- instructions/agent-spec.instructions.md +- instructions/automation.instructions.md +- instructions/coding-standards.instructions.md +- instructions/community-standards.instructions.md +- instructions/copilot-operations.instructions.md +- instructions/docs.instructions.md +- instructions/documentation-formats.instructions.md +- instructions/file-organisation.instructions.md +- instructions/hooks.instructions.md +- instructions/instructions.instructions.md +- instructions/issue-templates.instructions.md +- instructions/issues.instructions.md +- instructions/languages.instructions.md +- instructions/linting.instructions.md +- instructions/mermaid.instructions.md +- instructions/meta.instructions.md +- instructions/metrics.instructions.md +- instructions/multi-platform-skill-manifests.instructions.md +- instructions/planner.instructions.md +- instructions/plugin-structure.instructions.md +- instructions/pr-templates.instructions.md +- instructions/project-meta-sync.instructions.md +- instructions/prompt.instructions.md +- instructions/pull-requests.instructions.md +- instructions/quality-assurance.instructions.md +- instructions/readme.instructions.md +- instructions/release.instructions.md +- instructions/reporting.instructions.md +- instructions/self-explanatory-code-commenting.instructions.md +- instructions/spec-driven-workflow.instructions.md +- instructions/task-implementation.instructions.md +- instructions/tasksync.instructions.md +- instructions/template.instructions.md +- instructions/tools.instructions.md +- instructions/wordpress-project-planning.instructions.md +- instructions/workflows.instructions.md - plugins/README.md +- plugins/lightspeed-github-ops/INSTALL.md - plugins/lightspeed-github-ops/README.md +- plugins/lightspeed-github-ops/agents/reviewer.agent.md - plugins/lightspeed-github-ops/hooks/README.md +- plugins/lightspeed-github-ops/skills/lightspeed-frontmatter-audit/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-issue-template-compliance/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-issue-triage-automation/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-label-governance/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-pr-review/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-pr-template-compliance/SKILL.md - plugins/lightspeed-metrics-and-reporting/README.md +- plugins/lightspeed-metrics-and-reporting/agents/metrics-reporting-orchestrator.agent.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-issue-response-time-report/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-labeling-metrics-report/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-metrics-reporting/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-pr-cycle-time-report/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-repository-health-summary/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-review-latency-report/SKILL.md - plugins/lightspeed-quality-assurance/README.md +- plugins/lightspeed-quality-assurance/agents/qa-orchestrator.agent.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-flaky-test-triage/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-qa-signoff-summary/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-quality-gate/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-regression-risk-assessment/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-test-failure-triage/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-test-matrix-planner/SKILL.md - plugins/lightspeed-release-ops/README.md +- plugins/lightspeed-release-ops/agents/release-ops-orchestrator.agent.md +- plugins/lightspeed-release-ops/skills/lightspeed-changelog-compliance/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-notes-generator/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-readiness/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-risk-assessment/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-rollout-checklist/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-version-bump-planner/SKILL.md - plugins/lightspeed-wordpress-governance/README.md +- plugins/lightspeed-wordpress-governance/agents/wordpress-governance-reviewer.agent.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-accessibility-governance/SKILL.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-governance-checks/SKILL.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-release-hygiene-check/SKILL.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-security-governance/SKILL.md - plugins/lightspeed-wordpress-planning/README.md +- plugins/lightspeed-wordpress-planning/agents/project-spec-orchestrator.agent.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-capacity-planner/SKILL.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-milestone-planner/SKILL.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-spec-planning/SKILL.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-sprint-roadmap/SKILL.md - profile/README.md - prompts/README.md - schema/README.md +- schema/agent-config.example.md - scripts/README.md -- scripts/agents/**tests**/README.md +- scripts/agents/__tests__/README.md - scripts/agents/includes/README.md -- scripts/agents/includes/**tests**/README.md +- scripts/agents/includes/__tests__/README.md - scripts/validation/README.md - skills/README.md +- skills/design-md-agent/INDEX.md +- skills/design-md-agent/agent-creator/SKILL.md +- skills/design-md-agent/agent-creator/references/agent-requirements-template.md +- skills/design-md-agent/agent-creator/references/agent-system-prompt-template.md +- skills/design-md-agent/agent-creator/references/example-pre-call-researcher.md +- skills/design-md-agent/agent-creator/references/output-template-library.md +- skills/design-md-agent/agent-creator/references/quality-checklist.md +- skills/design-md-agent/agent-creator/references/skill-package-template.md +- skills/design-md-agent/agent-creator/references/tool-permission-matrix-template.md +- skills/design-md-agent/ai-chatbot-planner/SKILL.md +- skills/design-md-agent/ai-chatbot-planner/references/ai-engine-implementation-notes.md +- skills/design-md-agent/ai-chatbot-planner/references/chatbot-brief-template.md +- skills/design-md-agent/ai-chatbot-planner/references/launch-gates.md +- skills/design-md-agent/ai-chatbot-planner/references/privacy-log-retention.md +- skills/design-md-agent/ai-chatbot-planner/references/test-scripts.md +- skills/design-md-agent/ai-governance-documentor/SKILL.md +- skills/design-md-agent/ai-governance-documentor/references/governance-guide-template.md +- skills/design-md-agent/ai-governance-documentor/references/high-risk-interactive-mode.md +- skills/design-md-agent/ai-governance-documentor/references/minimum-client-inputs.md +- skills/design-md-agent/ai-governance-documentor/references/prompt-templates.md +- skills/design-md-agent/ai-governance-documentor/references/role-map.md +- skills/design-md-agent/ai-readiness-assessor/SKILL.md +- skills/design-md-agent/ai-readiness-assessor/references/red-flags.md +- skills/design-md-agent/ai-readiness-assessor/references/report-template.md +- skills/design-md-agent/ai-readiness-assessor/references/scoring-model.md +- skills/design-md-agent/ai-readiness-assessor/references/tool-checks.md +- skills/design-md-agent/apply-design-system/SKILL.md +- skills/design-md-agent/audit-design-system/SKILL.md +- skills/design-md-agent/cc-figma-component/SKILL.md +- skills/design-md-agent/chatgpt-apps/SKILL.md +- skills/design-md-agent/chatgpt-apps/references/app-archetypes.md +- skills/design-md-agent/chatgpt-apps/references/apps-sdk-docs-workflow.md +- skills/design-md-agent/chatgpt-apps/references/interactive-state-sync-patterns.md +- skills/design-md-agent/chatgpt-apps/references/repo-contract-and-validation.md +- skills/design-md-agent/chatgpt-apps/references/search-fetch-standard.md +- skills/design-md-agent/chatgpt-apps/references/upstream-example-workflow.md +- skills/design-md-agent/chatgpt-apps/references/window-openai-patterns.md +- skills/design-md-agent/content-collection-planner/SKILL.md +- skills/design-md-agent/content-collection-planner/references/client-email-template.md +- skills/design-md-agent/content-collection-planner/references/content-gap-report-template.md +- skills/design-md-agent/content-collection-planner/references/folder-structure.md +- skills/design-md-agent/content-collection-planner/references/generic-website-content-checklist.md +- skills/design-md-agent/content-collection-planner/references/sector-addons.md +- skills/design-md-agent/design-md-evidence-gatherer/SKILL.md +- skills/design-md-agent/design-md-format-enforcer/SKILL.md +- skills/design-md-agent/design-md-generator/SKILL.md +- skills/design-md-agent/design-md-generator/references/design-md-cli-and-portability.md +- skills/design-md-agent/design-md-generator/references/design-md-workflow.md +- skills/design-md-agent/design-md-generator/references/figma-to-design-md-mapping.md +- skills/design-md-agent/design-md-generator/references/output-templates.md +- skills/design-md-agent/design-md-generator/references/qa-rubric.md +- skills/design-md-agent/design-md-generator/references/wordpress-ci-integration.md +- skills/design-md-agent/design-md-generator/references/wordpress-theme-json-mapping.md +- skills/design-md-agent/design-md-intake-triage/SKILL.md +- skills/design-md-agent/design-md-standards-validator/SKILL.md +- skills/design-md-agent/design-md-user-defaults-onboarding/SKILL.md +- skills/design-md-agent/docx/SKILL.md +- skills/design-md-agent/docx/examples/end_to_end_smoke_test.md +- skills/design-md-agent/docx/ooxml/comments.md +- skills/design-md-agent/docx/ooxml/hyperlinks_and_fields.md +- skills/design-md-agent/docx/ooxml/rels_and_content_types.md +- skills/design-md-agent/docx/ooxml/tracked_changes.md +- skills/design-md-agent/docx/tasks/accessibility_a11y.md +- skills/design-md-agent/docx/tasks/captions_crossrefs.md +- skills/design-md-agent/docx/tasks/clean_tracked_changes.md +- skills/design-md-agent/docx/tasks/comments_manage.md +- skills/design-md-agent/docx/tasks/compare_diff.md +- skills/design-md-agent/docx/tasks/create_edit.md +- skills/design-md-agent/docx/tasks/fields_update.md +- skills/design-md-agent/docx/tasks/fixtures_edge_cases.md +- skills/design-md-agent/docx/tasks/footnotes_endnotes.md +- skills/design-md-agent/docx/tasks/forms_content_controls.md +- skills/design-md-agent/docx/tasks/headings_numbering.md +- skills/design-md-agent/docx/tasks/images_figures.md +- skills/design-md-agent/docx/tasks/multi_doc_merge.md +- skills/design-md-agent/docx/tasks/navigation_internal_links.md +- skills/design-md-agent/docx/tasks/privacy_scrub_metadata.md +- skills/design-md-agent/docx/tasks/protection_restrict_editing.md +- skills/design-md-agent/docx/tasks/read_review.md +- skills/design-md-agent/docx/tasks/redaction_anonymization.md +- skills/design-md-agent/docx/tasks/sections_layout.md +- skills/design-md-agent/docx/tasks/style_lint_normalize.md +- skills/design-md-agent/docx/tasks/tables_spreadsheets.md +- skills/design-md-agent/docx/tasks/templates_style_packs.md +- skills/design-md-agent/docx/tasks/toc_workflow.md +- skills/design-md-agent/docx/tasks/verify_render.md +- skills/design-md-agent/docx/tasks/watermarks_background.md +- skills/design-md-agent/docx/troubleshooting/libreoffice_headless.md +- skills/design-md-agent/docx/troubleshooting/run_splitting.md +- skills/design-md-agent/edit-figma-design/SKILL.md +- skills/design-md-agent/figma-code-connect/SKILL.md +- skills/design-md-agent/figma-code-connect/references/advanced-patterns.md +- skills/design-md-agent/figma-code-connect/references/api.md +- skills/design-md-agent/figma-create-design-system-rules/SKILL.md +- skills/design-md-agent/figma-implement-design/SKILL.md +- skills/design-md-agent/figma-themejson-custom-color-tokens/SKILL.md +- skills/design-md-agent/figma-themejson-palette/SKILL.md +- skills/design-md-agent/figma-themejson-radius/SKILL.md +- skills/design-md-agent/figma-themejson-shadow/SKILL.md +- skills/design-md-agent/figma-themejson-spacing/SKILL.md +- skills/design-md-agent/figma-themejson-style-variations/SKILL.md +- skills/design-md-agent/figma-themejson-typography/SKILL.md +- skills/design-md-agent/figma-use/SKILL.md +- skills/design-md-agent/figma-use/references/api-reference.md +- skills/design-md-agent/figma-use/references/common-patterns.md +- skills/design-md-agent/figma-use/references/component-patterns.md +- skills/design-md-agent/figma-use/references/effect-style-patterns.md +- skills/design-md-agent/figma-use/references/gotchas.md +- skills/design-md-agent/figma-use/references/plugin-api-patterns.md +- skills/design-md-agent/figma-use/references/plugin-api-standalone.index.md +- skills/design-md-agent/figma-use/references/text-style-patterns.md +- skills/design-md-agent/figma-use/references/validation-and-recovery.md +- skills/design-md-agent/figma-use/references/variable-patterns.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-components--creating.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-components--using.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-components.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-effect-styles.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-text-styles.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-variables--creating.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-variables--using.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-variables.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds.md +- skills/design-md-agent/figma-wordpress-skill-creator/SKILL.md +- skills/design-md-agent/figma-wordpress-skill-creator/references/eval-and-trigger-rubric.md +- skills/design-md-agent/figma-wordpress-skill-creator/references/figma-wordpress-patterns.md +- skills/design-md-agent/figma-wordpress-skill-creator/references/output-templates.md +- skills/design-md-agent/fix-design-system-finding/SKILL.md +- skills/design-md-agent/generate-project-plan/SKILL.md +- skills/design-md-agent/generate-project-plan/references/blocks/diagram-section.md +- skills/design-md-agent/generate-project-plan/references/blocks/intro-callout.md +- skills/design-md-agent/generate-project-plan/references/blocks/metadata-strip.md +- skills/design-md-agent/generate-project-plan/references/blocks/multi-column-text.md +- skills/design-md-agent/generate-project-plan/references/blocks/nested-section.md +- skills/design-md-agent/generate-project-plan/references/blocks/section.md +- skills/design-md-agent/generate-project-plan/references/blocks/sticky-column.md +- skills/design-md-agent/generate-project-plan/references/blocks/table.md +- skills/design-md-agent/generate-project-plan/references/blocks/text-primitives.md +- skills/design-md-agent/generate-project-plan/references/foundation/codebase-grounding.md +- skills/design-md-agent/generate-project-plan/references/foundation/layout.md +- skills/design-md-agent/generate-project-plan/references/foundation/palette.md +- skills/design-md-agent/generate-project-plan/references/foundation/plugin-api-traps.md +- skills/design-md-agent/generate-project-plan/references/section-catalog.md +- skills/design-md-agent/gh-fix-ci/SKILL.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/SKILL.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/acceptance-test-plan-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/go-no-go-acceptance-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/issue-test-matrix-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/requirement-test-matrix-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/test-script-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/acceptance-test-workflow.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/accessibility-responsive-tests.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/block-plugin-tests.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/figma-parity-tests.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/report-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/test-scenario-types.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/wordpress-block-theme-tests.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/SKILL.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/client-project-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/lightspeed-service-positioning.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/output-standards.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/red-flags.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/skill-routing-rules.md +- skills/design-md-agent/lightspeed-ai-readiness-router/SKILL.md +- skills/design-md-agent/lightspeed-ai-readiness-router/references/client-project-pack-outputs.md +- skills/design-md-agent/lightspeed-ai-readiness-router/references/proposal-line-items.md +- skills/design-md-agent/lightspeed-ai-readiness-router/references/workflow-router.md +- skills/design-md-agent/lightspeed-ai-readiness/SKILL.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/chatbot-planning-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/content-collection-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/governance-discovery-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/readiness-assessment-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/universal-client-project-kickoff.md +- skills/design-md-agent/lightspeed-ai-readiness/references/ai-chatbot-planner.md +- skills/design-md-agent/lightspeed-ai-readiness/references/ai-governance-documentor.md +- skills/design-md-agent/lightspeed-ai-readiness/references/ai-readiness-assessor.md +- skills/design-md-agent/lightspeed-ai-readiness/references/client-output-standards.md +- skills/design-md-agent/lightspeed-ai-readiness/references/content-collection-planner.md +- skills/design-md-agent/lightspeed-ai-readiness/references/lightspeed-style-guide.md +- skills/design-md-agent/lightspeed-ai-readiness/references/router-and-project-pack.md +- skills/design-md-agent/lightspeed-ai-readiness/references/source-frameworks.md +- skills/design-md-agent/lightspeed-approval-gate-manager/SKILL.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/approval-summary-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/decision-log-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/gate-checklist-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/risk-register-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/stakeholder-review-pack-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/approval-gate-workflow.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/decision-log-rules.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/gate-types.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/stakeholder-review-rules.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/status-model.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/wordpress-project-gates.md +- skills/design-md-agent/lightspeed-change-request-router/SKILL.md +- skills/design-md-agent/lightspeed-change-request-router/assets/approval-checklist-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/artifact-update-notes-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/change-log-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/change-request-assessment-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/client-summary-template.md +- skills/design-md-agent/lightspeed-change-request-router/references/approval-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/artifact-update-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/change-request-workflow.md +- skills/design-md-agent/lightspeed-change-request-router/references/classification-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/impact-analysis-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/report-template.md +- skills/design-md-agent/lightspeed-change-request-router/references/specialist-routing.md +- skills/design-md-agent/lightspeed-claim-register-auditor/SKILL.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/approved-wording-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/claim-register-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/evidence-needed-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/page-location-map-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/publication-summary-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/rejected-wording-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/review-owner-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/approved-wording-rules.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/chatbot-claim-rules.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/claim-audit-workflow.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/claim-types.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/classification-rules.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/evidence-standards.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/report-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/SKILL.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/chatbot-safe-faq-register-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/company-faq-page-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/duplicate-faq-report-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/escalation-questions-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/page-level-faq-map-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/schema-ready-faq-answers-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/unsupported-questions-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/chatbot-safe-source-rules.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/escalation-and-unsupported-rules.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/faq-curation-workflow.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/faq-taxonomy.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/report-templates.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/schema-ready-faq-rules.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/SKILL.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/accessibility-state-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/component-block-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/issue-register-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/light-dark-mode-qa-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/parity-audit-report-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/pattern-section-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/responsive-qa-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/token-parity-table-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/accessibility-state-qa.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/component-block-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/issue-severity-model.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/light-dark-mode-qa.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/parity-audit-workflow.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/pattern-section-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/responsive-state-qa.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/theme-json-token-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/SKILL.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/block-plugin-requirements-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/component-block-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/github-issue-seeds-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/open-questions-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/technical-brief-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/template-pattern-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/token-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/block-plugin-requirements.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/block-theme-requirements.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/component-to-block-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/editor-experience.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/figma-evidence-intake.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/pattern-template-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/qa-handoff.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/technical-brief-workflow.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/theme-json-token-mapping.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/SKILL.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/chatbot-handoff-events-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/consultation-cta-tracking-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/form-tracking-plan-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/ga4-event-plan-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/gtm-trigger-notes-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/launch-baseline-report-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/lead-magnet-tracking-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/looker-studio-dashboard-brief-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/measurement-qa-checklist-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/chatbot-handoff-events.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/event-naming-and-parameters.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/form-and-lead-tracking.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/gtm-trigger-notes.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/launch-baseline-report.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/looker-studio-dashboard.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/measurement-workflow.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/privacy-and-consent-notes.md +- skills/design-md-agent/lightspeed-github-issue-drafter/SKILL.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/epic-issue-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/issue-index-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/issue-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/launch-qa-issue-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/review-checklist-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/acceptance-criteria-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/dependency-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/issue-drafting-workflow.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/issue-templates.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/label-and-milestone-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/qa-and-review-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/wordpress-issue-rules.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/SKILL.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/branch-pr-strategy-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/dependency-map-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/handoff-notes-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/implementation-plan-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/risk-register-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/wave-plan-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/workstream-plan-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/branch-pr-strategy.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/implementation-workflow.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/risk-and-decision-rules.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/testing-and-qa.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/wave-planning.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/wordpress-implementation-rules.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/workstream-model.md +- skills/design-md-agent/lightspeed-launch-qa-planner/SKILL.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/block-plugin-qa-matrix-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/go-no-go-summary-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/launch-gate-checklist-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/launch-qa-plan-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/page-template-qa-matrix-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/pattern-qa-matrix-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/qa-workstream-table-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/accessibility-responsive-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/block-plugin-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/block-theme-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/conversion-and-tracking-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/figma-to-wordpress-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/launch-gate-model.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/launch-qa-planning-workflow.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/pattern-and-template-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/specialist-skill-routing.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/SKILL.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/accessibility-testing-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/analytics-tagging-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/broken-link-checklist-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/form-testing-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/go-no-go-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/launch-checklist-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/mobile-responsive-qa-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/page-qa-table-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/performance-notes-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/go-no-go-rules.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/issue-severity-model.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/launch-readiness-workflow.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/qa-checklists.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/report-templates.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/wordpress-launch-notes.md +- skills/design-md-agent/lightspeed-launch-task-router/SKILL.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/go-no-go-routing-summary-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/launch-router-checklist-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/routing-report-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/specialist-prompt-starters-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/workstream-routing-template.md +- skills/design-md-agent/lightspeed-launch-task-router/references/approval-gates.md +- skills/design-md-agent/lightspeed-launch-task-router/references/dependency-sequencing.md +- skills/design-md-agent/lightspeed-launch-task-router/references/launch-task-routing-workflow.md +- skills/design-md-agent/lightspeed-launch-task-router/references/launch-workstreams.md +- skills/design-md-agent/lightspeed-launch-task-router/references/specialist-skill-routing.md +- skills/design-md-agent/lightspeed-policy-page-generator/SKILL.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/accessibility-statement-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/ai-governance-page-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/chatbot-disclosure-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/cookie-policy-brief-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/data-log-retention-decision-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/privacy-policy-brief-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/accessibility-statement.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/ai-governance-page.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/chatbot-disclosure.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/cookie-policy-brief.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/data-log-retention.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/policy-workflow.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/privacy-policy-brief.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/review-and-approval.md +- skills/design-md-agent/lightspeed-prd-generator/SKILL.md +- skills/design-md-agent/lightspeed-prd-generator/assets/discovery-summary-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/open-questions-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/persona-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/prd-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/requirements-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/success-metrics-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/user-story-template.md +- skills/design-md-agent/lightspeed-prd-generator/references/acceptance-criteria-rules.md +- skills/design-md-agent/lightspeed-prd-generator/references/approval-gates.md +- skills/design-md-agent/lightspeed-prd-generator/references/figma-design-system-rules.md +- skills/design-md-agent/lightspeed-prd-generator/references/prd-workflow.md +- skills/design-md-agent/lightspeed-prd-generator/references/project-types.md +- skills/design-md-agent/lightspeed-prd-generator/references/success-metrics.md +- skills/design-md-agent/lightspeed-prd-generator/references/wordpress-prd-rules.md +- skills/design-md-agent/lightspeed-prd-task-manager/SKILL.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/full-project-pack-structure.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/issue-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/prd-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/task-plan-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/technical-brief-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/acceptance-criteria.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/agent-spec.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/figma-wordpress-technical-brief.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/github-issue-drafts.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/memory-bank.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/prd-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/qa-and-launch-routing.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/task-breakdown-rules.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/wordpress-standards.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/SKILL.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/README-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/file-index-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/next-actions-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/pack-status-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/review-checklist-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/source-inventory-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/file-naming-rules.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/pack-quality-checklist.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/pack-workflow.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/source-classification.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/SKILL.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/gap-register-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/go-no-go-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/issue-quality-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/review-report-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/issue-review-rules.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/prd-review-rules.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/readiness-scoring.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/report-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/review-workflow.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/task-review-rules.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/technical-brief-review-rules.md +- skills/design-md-agent/lightspeed-project-intake-router/SKILL.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/kickoff-pack-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/missing-inputs-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/prompt-starters-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/source-inventory-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/workflow-route-template.md +- skills/design-md-agent/lightspeed-project-intake-router/references/approval-gates.md +- skills/design-md-agent/lightspeed-project-intake-router/references/clarifying-questions.md +- skills/design-md-agent/lightspeed-project-intake-router/references/intake-workflow.md +- skills/design-md-agent/lightspeed-project-intake-router/references/project-type-classification.md +- skills/design-md-agent/lightspeed-project-intake-router/references/source-inventory-rules.md +- skills/design-md-agent/lightspeed-project-intake-router/references/specialist-routing.md +- skills/design-md-agent/lightspeed-project-memory-manager/SKILL.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/README-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/activeContext-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/assumptions-risks-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/decision-log-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/handoff-summary-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/productContext-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/progress-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/projectbrief-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/systemPatterns-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/task-index-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/techContext-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/file-definitions.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/handoff-rules.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/memory-bank-workflow.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/status-and-decision-rules.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/task-index-rules.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/wordpress-project-memory.md +- skills/design-md-agent/lightspeed-project-researcher/SKILL.md +- skills/design-md-agent/lightspeed-project-researcher/assets/decision-blockers-template.md +- skills/design-md-agent/lightspeed-project-researcher/assets/open-questions-template.md +- skills/design-md-agent/lightspeed-project-researcher/assets/research-report-template.md +- skills/design-md-agent/lightspeed-project-researcher/assets/source-inventory-template.md +- skills/design-md-agent/lightspeed-project-researcher/references/evidence-classification.md +- skills/design-md-agent/lightspeed-project-researcher/references/figma-research.md +- skills/design-md-agent/lightspeed-project-researcher/references/github-research.md +- skills/design-md-agent/lightspeed-project-researcher/references/prd-handoff.md +- skills/design-md-agent/lightspeed-project-researcher/references/research-workflow.md +- skills/design-md-agent/lightspeed-project-researcher/references/source-inventory.md +- skills/design-md-agent/lightspeed-project-researcher/references/wordpress-site-research.md +- skills/design-md-agent/lightspeed-project-status-reporter/SKILL.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/client-update-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/decision-update-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/internal-delivery-report-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/launch-readiness-snapshot-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/weekly-status-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/audience-rules.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/report-templates.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/status-model.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/status-report-workflow.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/update-examples.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/workstream-model.md +- skills/design-md-agent/lightspeed-qa-findings-router/SKILL.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/client-summary-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/github-issue-draft-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/launch-blocker-list-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/qa-findings-register-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/retest-checklist-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/workstream-routing-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/github-issue-drafting.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/qa-findings-workflow.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/report-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/retest-rules.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/severity-and-launch-status.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/workstream-routing.md +- skills/design-md-agent/lightspeed-redirect-map-planner/SKILL.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/404-risk-list-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/current-url-inventory-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/launch-day-checklist-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/new-url-map-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/redirect-status-table-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/seo-migration-summary-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/redirect-planning-workflow.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/redirect-status-model.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/report-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/seo-migration-notes.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/wordpress-redirect-notes.md +- skills/design-md-agent/lightspeed-release-handoff-generator/SKILL.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/client-handoff-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/internal-handoff-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/known-issues-register-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/post-launch-monitoring-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/release-notes-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/support-transition-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/client-handoff-rules.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/known-issues-rules.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/post-launch-monitoring.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/release-handoff-workflow.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/release-notes-rules.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/support-transition-rules.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/SKILL.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/coverage-summary-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/gap-register-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/orphan-task-report-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/requirement-register-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/traceability-matrix-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/coverage-rules.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/qa-coverage-rules.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/report-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/requirement-classification.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/traceability-workflow.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/wordpress-traceability.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/SKILL.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/ai-visibility-baseline-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/claim-safe-wording-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/faq-schema-map-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/internal-linking-plan-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/page-schema-recommendation-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/schema-launch-checklist-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/ai-visibility-baseline.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/answer-engine-optimisation.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/claim-safe-wording.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/faq-schema-map.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/internal-linking-rules.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/schema-types.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/schema-workflow.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/validation-and-monitoring.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/SKILL.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/acceptance-test-map-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/dependency-map-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/epic-map-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/github-issue-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/implementation-waves-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/task-plan-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/acceptance-criteria.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/dependency-and-wave-planning.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/estimation-models.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/issue-draft-rules.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/qa-mapping.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/task-breakdown-workflow.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/wordpress-task-rules.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/workstream-model.md +- skills/design-md-agent/lightspeed-website-content-generator/SKILL.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/case-study-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/content-pack-readme-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/faq-page-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/page-brief-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/service-page-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/solution-page-template.md +- skills/design-md-agent/lightspeed-website-content-generator/references/chatbot-safe-content-rules.md +- skills/design-md-agent/lightspeed-website-content-generator/references/claim-handling-rules.md +- skills/design-md-agent/lightspeed-website-content-generator/references/content-generation-workflow.md +- skills/design-md-agent/lightspeed-website-content-generator/references/lightspeed-style-guide.md +- skills/design-md-agent/lightspeed-website-content-generator/references/page-output-templates.md +- skills/design-md-agent/lightspeed-website-content-generator/references/review-status-labels.md +- skills/design-md-agent/lightspeed-website-content-generator/references/seo-and-schema-rules.md +- skills/design-md-agent/lightspeed-website-content-generator/references/source-inputs.md +- skills/design-md-agent/linear/SKILL.md - skills/design-md-agent/markdown-content-validator/README.md +- skills/design-md-agent/markdown-content-validator/SKILL.md +- skills/design-md-agent/markdown-content-validator/references/example-validation-report.md +- skills/design-md-agent/markdown-content-validator/references/markdown-validation-rules.md +- skills/design-md-agent/markdown-content-validator/references/schema-customisation.md +- skills/design-md-agent/markdown-content-validator/references/semver-versioning-rules.md +- skills/design-md-agent/markdown-content-validator/tests/invalid-version.md +- skills/design-md-agent/markdown-content-validator/tests/markdown-content-validation-report.md +- skills/design-md-agent/markdown-content-validator/tests/markdown-issues.md +- skills/design-md-agent/markdown-content-validator/tests/missing-frontmatter.md +- skills/design-md-agent/markdown-content-validator/tests/report.md +- skills/design-md-agent/markdown-content-validator/tests/valid-example.md +- skills/design-md-agent/markdown-content-validator/tests/valid-report.md +- skills/design-md-agent/pdfs/SKILL.md +- skills/design-md-agent/pdfs/examples/smoke_test.md +- skills/design-md-agent/pdfs/tasks/batch.md +- skills/design-md-agent/pdfs/tasks/compare.md +- skills/design-md-agent/pdfs/tasks/convert.md +- skills/design-md-agent/pdfs/tasks/coords.md +- skills/design-md-agent/pdfs/tasks/create.md +- skills/design-md-agent/pdfs/tasks/edit.md +- skills/design-md-agent/pdfs/tasks/extract.md +- skills/design-md-agent/pdfs/tasks/forms_annotations.md +- skills/design-md-agent/pdfs/tasks/forms_debugging.md +- skills/design-md-agent/pdfs/tasks/forms_nonfillable.md +- skills/design-md-agent/pdfs/tasks/js_tools.md +- skills/design-md-agent/pdfs/tasks/ocr.md +- skills/design-md-agent/pdfs/tasks/parity.md +- skills/design-md-agent/pdfs/tasks/preflight.md +- skills/design-md-agent/pdfs/tasks/read_review.md +- skills/design-md-agent/pdfs/tasks/redact.md +- skills/design-md-agent/pdfs/troubleshooting/common.md +- skills/design-md-agent/skill-creator/SKILL.md +- skills/design-md-agent/skill-creator/references/output-patterns.md +- skills/design-md-agent/skill-creator/references/sample-prompts.md +- skills/design-md-agent/skill-creator/references/workflows.md +- skills/design-md-agent/slides/SKILL.md - skills/design-md-agent/slides/artifact_tool/README.md +- skills/design-md-agent/slides/artifact_tool/auto-layout.spec.md +- skills/design-md-agent/slides/artifact_tool/charts.spec.md +- skills/design-md-agent/slides/artifact_tool/fill.spec.md +- skills/design-md-agent/slides/artifact_tool/images.spec.md +- skills/design-md-agent/slides/artifact_tool/inspect.spec.md +- skills/design-md-agent/slides/artifact_tool/layout.spec.md +- skills/design-md-agent/slides/artifact_tool/master.spec.md +- skills/design-md-agent/slides/artifact_tool/presentation.spec.md +- skills/design-md-agent/slides/artifact_tool/rich-text.spec.md +- skills/design-md-agent/slides/artifact_tool/shapes.spec.md +- skills/design-md-agent/slides/artifact_tool/slide.spec.md +- skills/design-md-agent/slides/artifact_tool/speaker-notes.spec.md +- skills/design-md-agent/slides/artifact_tool/styles.spec.md +- skills/design-md-agent/slides/artifact_tool/tables.spec.md +- skills/design-md-agent/slides/artifact_tool/theme.spec.md +- skills/design-md-agent/spreadsheets/API_QUICK_START.md +- skills/design-md-agent/spreadsheets/SKILL.md +- skills/design-md-agent/spreadsheets/templates/financial_models.md +- skills/design-md-agent/sync-figma-token/SKILL.md +- skills/design-md-agent/theme-color-token-enforcer/SKILL.md +- skills/design-md-agent/themejson-extractor-orchestrator/SKILL.md +- skills/design-md-agent/themejson-extractor-orchestrator/references/lightspeed-themejson-example.md +- skills/design-md-agent/wordpress-asset-parameter-generator/SKILL.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/output-templates.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/workflow.md +- skills/design-md-agent/wordpress-block-asset-validator/SKILL.md +- skills/design-md-agent/wordpress-block-asset-validator/references/output-templates.md +- skills/design-md-agent/wordpress-block-asset-validator/references/qa-rubric.md +- skills/design-md-agent/wordpress-block-asset-validator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-block-asset-validator/references/workflow.md +- skills/design-md-agent/wordpress-block-style-generator/SKILL.md +- skills/design-md-agent/wordpress-block-style-generator/references/output-templates.md +- skills/design-md-agent/wordpress-block-style-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-block-style-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-block-style-generator/references/workflow.md +- skills/design-md-agent/wordpress-block-theme-router/SKILL.md +- skills/design-md-agent/wordpress-block-theme-router/references/output-templates.md +- skills/design-md-agent/wordpress-block-theme-router/references/qa-rubric.md +- skills/design-md-agent/wordpress-block-theme-router/references/routing-matrix.md +- skills/design-md-agent/wordpress-block-theme-router/references/wordpress-rules.md +- skills/design-md-agent/wordpress-block-theme-router/references/workflow.md +- skills/design-md-agent/wordpress-custom-template-generator/SKILL.md +- skills/design-md-agent/wordpress-custom-template-generator/references/output-templates.md +- skills/design-md-agent/wordpress-custom-template-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-custom-template-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-custom-template-generator/references/workflow.md +- skills/design-md-agent/wordpress-design-system-intake-onboarding/SKILL.md +- skills/design-md-agent/wordpress-pattern-generator/SKILL.md +- skills/design-md-agent/wordpress-pattern-generator/references/output-templates.md +- skills/design-md-agent/wordpress-pattern-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-pattern-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-pattern-generator/references/workflow.md +- skills/design-md-agent/wordpress-plugin-extension-audit/SKILL.md +- skills/design-md-agent/wordpress-plugin-extension-audit/references/plugin-audit-checklist.md +- skills/design-md-agent/wordpress-plugin-packaging-review/SKILL.md +- skills/design-md-agent/wordpress-plugin-packaging-review/references/output-templates.md +- skills/design-md-agent/wordpress-plugin-packaging-review/references/qa-rubric.md +- skills/design-md-agent/wordpress-plugin-packaging-review/references/workflow.md +- skills/design-md-agent/wordpress-section-style-generator/SKILL.md +- skills/design-md-agent/wordpress-section-style-generator/references/output-templates.md +- skills/design-md-agent/wordpress-section-style-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-section-style-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-section-style-generator/references/workflow.md +- skills/design-md-agent/wordpress-template-generator/SKILL.md +- skills/design-md-agent/wordpress-template-generator/references/output-templates.md +- skills/design-md-agent/wordpress-template-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-template-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-template-generator/references/workflow.md +- skills/design-md-agent/wordpress-template-part-generator/SKILL.md +- skills/design-md-agent/wordpress-template-part-generator/references/output-templates.md +- skills/design-md-agent/wordpress-template-part-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-template-part-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-template-part-generator/references/workflow.md +- skills/design-md-agent/wordpress-theme-validation/SKILL.md +- skills/design-md-agent/wordpress-theme-validation/references/figma-traceability.md +- skills/design-md-agent/wordpress-theme-validation/references/validation-checklist.md +- skills/lightspeed-frontmatter-audit/SKILL.md +- skills/lightspeed-label-governance/SKILL.md +- skills/lightspeed-pr-review/SKILL.md - tests/README.md - website/README.md +- website/src/content/agents/claude.md - workflows/README.md - workflows/memory/README.md +- workflows/portable-ai-plugin-restructure.md +- workflows/release-readiness-validation.md +- workflows/weekly-governance-sync.md +- workflows/wordpress-project-onboarding.md +- workflows/wordpress-spec-to-implementation.md ## Compliance Criteria All diagrams must include: - - โœ… **accTitle attribute** โ€” Brief accessible title for screen readers - โœ… **accDescr attribute** โ€” Detailed accessible description of diagram content Supported formats: - - Single-line: `accTitle Title text` or `accDescr: "Description text"` - Block format: `accDescr { ... }` diff --git a/.github/reports/mermaid-diagram-accessibility-spreadsheet.csv b/.github/reports/mermaid-diagram-accessibility-spreadsheet.csv index ab70061ea..bccd98267 100644 --- a/.github/reports/mermaid-diagram-accessibility-spreadsheet.csv +++ b/.github/reports/mermaid-diagram-accessibility-spreadsheet.csv @@ -1,10 +1,20 @@ -README,Diagram Number,Diagram Type,Has accTitle,Has accDescr,Missing Attributes,Compliance Status +File,Diagram Number,Diagram Type,Has accTitle,Has accDescr,Missing Attributes,Compliance Status .github/ISSUE_TEMPLATE/README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible .github/README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible .github/README.md,2,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible .github/README.md,3,graph,Yes,Yes,"โ€”",โœ… Accessible .github/README.md,4,flowchart,Yes,Yes,"โ€”",โœ… Accessible +.github/instructions/.archive/frontmatter.instructions.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible +.github/instructions/.archive/tests.instructions.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible +.github/instructions/.archive/tests.instructions.md,2,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible +.github/instructions/.archive/tests.instructions.md,3,graph,Yes,Yes,"โ€”",โœ… Accessible +.github/reports/audits/2026-06-03-file-organisation-migration-plan-673.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +.github/reports/audits/2026-06-03-file-organisation-migration-plan-673.md,2,gantt,Yes,Yes,"โ€”",โœ… Accessible +.github/reports/audits/readme-audit-2026-05-31.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +.github/reports/mermaid/diagram-validation-2025-12-11.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +.github/reports/wave-5-completion-summary.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible .vscode/README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +CONTRIBUTING.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible README.md,2,flowchart,Yes,Yes,"โ€”",โœ… Accessible README.md,3,flowchart,Yes,Yes,"โ€”",โœ… Accessible @@ -12,11 +22,38 @@ README.md,4,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible README.md,5,flowchart,Yes,Yes,"โ€”",โœ… Accessible README.md,6,stateDiagram,Yes,Yes,"โ€”",โœ… Accessible README.md,7,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,2,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,3,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,4,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,5,mindmap,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,6,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,7,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/AGENT_CREATION.md,8,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/CANONICAL_CONFIGS_GUIDE.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +docs/CANONICAL_CONFIGS_GUIDE.md,2,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible +docs/HUSKY_PRECOMMITS.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +instructions/automation.instructions.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible +instructions/automation.instructions.md,2,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,2,graph,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,3,graph,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,4,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,5,stateDiagram,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,6,flowchart,Yes,Yes,"โ€”",โœ… Accessible +instructions/documentation-formats.instructions.md,7,stateDiagram,Yes,Yes,"โ€”",โœ… Accessible +instructions/linting.instructions.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible +instructions/linting.instructions.md,2,graph,Yes,Yes,"โ€”",โœ… Accessible +instructions/mermaid.instructions.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +instructions/mermaid.instructions.md,2,Multi,Yes,Yes,"โ€”",โœ… Accessible +instructions/mermaid.instructions.md,3,flowchart,Yes,Yes,"โ€”",โœ… Accessible +instructions/quality-assurance.instructions.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible +instructions/quality-assurance.instructions.md,2,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible profile/README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible profile/README.md,2,flowchart,Yes,Yes,"โ€”",โœ… Accessible -profile/README.md,3,flowchart,Yes,Yes,"โ€”",โœ… Accessible +profile/README.md,3,graph,Yes,Yes,"โ€”",โœ… Accessible profile/README.md,4,stateDiagram,Yes,Yes,"โ€”",โœ… Accessible -scripts/README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible +scripts/README.md,1,graph,Yes,Yes,"โ€”",โœ… Accessible scripts/README.md,2,sequenceDiagram,Yes,Yes,"โ€”",โœ… Accessible scripts/README.md,3,flowchart,Yes,Yes,"โ€”",โœ… Accessible tests/README.md,1,flowchart,Yes,Yes,"โ€”",โœ… Accessible diff --git a/.github/reports/mermaid-validation-report.md b/.github/reports/mermaid-validation-report.md index 6ddc40dc2..bc8ec07d2 100644 --- a/.github/reports/mermaid-validation-report.md +++ b/.github/reports/mermaid-validation-report.md @@ -1,6 +1,7 @@ +--- title: Mermaid Diagram Syntax Validation Report description: Mermaid diagram syntax validation results for repository README files -version: "1.1.0" +version: "1.0.0" created_date: "2026-06-18" last_updated: "2026-06-18" file_type: documentation @@ -10,62 +11,921 @@ status: active stability: stable --- -Mermaid Diagram Syntax Validation Report -======================================== +# Mermaid Diagram Syntax Validation Report -**Generated**: 2026-06-18T12:07:27.486Z +**Generated**: 2026-06-18T15:35:13.796Z -Summary -------- +## Summary -- **Total diagrams**: 17 -- **Valid diagrams**: 17 +- **Total diagrams**: 45 +- **Valid diagrams**: 45 - **Error diagrams**: 0 - **Success rate**: 100.0% +## Files Analyzed -Files Analyzed --------------- - +- AGENTS.md +- CHANGELOG.md +- CLAUDE.md +- CODE_OF_CONDUCT.md +- CONTRIBUTING.md +- DEVELOPMENT.md +- GOVERNANCE.md - README.md +- SECURITY.md +- SUPPORT.md - agents/README.md +- agents/adr.agent.md +- agents/agent.md +- agents/issues.agent.md +- agents/labeling.agent.md +- agents/linting.agent.md +- agents/meta.agent.md +- agents/metrics.agent.md +- agents/mode-demonstrate-understanding.agent.md +- agents/mode-document-reviewer.agent.md +- agents/mode-prd.agent.md +- agents/mode-thinking.agent.md +- agents/project-meta-sync.agent.md +- agents/prompt-engineer.agent.md +- agents/release.agent.md +- agents/reporting.agent.md +- agents/reviewer.agent.md +- agents/task-planner.agent.md +- agents/task-researcher.agent.md +- agents/template.agent.md +- agents/testing.agent.md +- ai/AUDIT-SUMMARY.md +- ai/Claude.md +- ai/Gemini.md - ai/README.md +- ai/RUNNERS.md +- ai/agents.md +- ai/audit-planner-reviewer-agents.md +- ai/improvement-plan-planner-reviewer.md - cookbook/README.md +- cookbook/project-planning-and-prd-playbook.md +- cookbook/spec-driven-workflow-example.md +- cookbook/wordpress-plugin-checklist.md +- docs/AGENT_CREATION.md +- docs/ARCHITECTURE.md +- docs/AUDIT_PR_DOCS_663.md +- docs/AUTOMATION.md +- docs/AWESOME_ALIGNMENT.md +- docs/AWESOME_GITHUB_MAPPING_STRATEGY.md +- docs/BRANCHING_STRATEGY.md +- docs/BRANDING_AGENT_USAGE.md +- docs/BRANDING_CONFIG_SPEC.md +- docs/CANONICAL_CONFIGS_GUIDE.md +- docs/CONFIGS.md +- docs/CROSS_PLATFORM_SKILL_YAML_SPEC.md +- docs/DECISIONS.md +- docs/DEPLOY.md +- docs/DISCUSSIONS.md +- docs/FOOTER_REMEDIATION_GUIDE.md +- docs/FRONTMATTER_SCHEMA.md +- docs/GITHUB_PROJECT_OPERATIONS_SPEC.md +- docs/GOVERNANCE_REVISION_LOG.md +- docs/HUSKY_PRECOMMITS.md +- docs/ISSUE_CREATION_GUIDE.md +- docs/ISSUE_FIELDS.md +- docs/ISSUE_TYPES.md +- docs/LABELING.md +- docs/LABEL_COLOR_STRATEGY.md +- docs/LABEL_INVENTORY.md +- docs/LABEL_STRATEGY.md +- docs/LINTING.md +- docs/METRICS.md +- docs/MIGRATION.md +- docs/MIGRATION_GUIDE.md +- docs/ORGANIZATION.md +- docs/OVERRIDE_POLICY.md +- docs/PLUGIN_INSTALLATION_GUIDE.md +- docs/PLUGIN_PACK_ROADMAP.md +- docs/PR_CREATION_PROCESS.md - docs/README.md +- docs/RELEASE_PROCESS.md +- docs/ROADMAP.md +- docs/SHARED_GITHUB_ADOPTION_GUIDE.md +- docs/TESTING.md +- docs/VERSIONING.md +- docs/WORKFLOW_COORDINATION.md +- docs/agents/AGENT_ARCHITECTURE.md +- docs/agents/PLANNER_RUNBOOK.md +- docs/agents/REVIEWER_RUNBOOK.md +- docs/downstream/tour-operator-adoption.md +- docs/index.md - hooks/README.md - hooks/secrets-scanner/README.md - hooks/session-logger/README.md - hooks/tool-guardian/README.md +- instructions/DEPRECATED.md - instructions/README.md +- instructions/a11y.instructions.md +- instructions/agent-spec.instructions.md +- instructions/automation.instructions.md +- instructions/coding-standards.instructions.md +- instructions/community-standards.instructions.md +- instructions/copilot-operations.instructions.md +- instructions/docs.instructions.md +- instructions/documentation-formats.instructions.md +- instructions/file-organisation.instructions.md +- instructions/hooks.instructions.md +- instructions/instructions.instructions.md +- instructions/issue-templates.instructions.md +- instructions/issues.instructions.md +- instructions/languages.instructions.md +- instructions/linting.instructions.md +- instructions/mermaid.instructions.md +- instructions/meta.instructions.md +- instructions/metrics.instructions.md +- instructions/multi-platform-skill-manifests.instructions.md +- instructions/planner.instructions.md +- instructions/plugin-structure.instructions.md +- instructions/pr-templates.instructions.md +- instructions/project-meta-sync.instructions.md +- instructions/prompt.instructions.md +- instructions/pull-requests.instructions.md +- instructions/quality-assurance.instructions.md +- instructions/readme.instructions.md +- instructions/release.instructions.md +- instructions/reporting.instructions.md +- instructions/self-explanatory-code-commenting.instructions.md +- instructions/spec-driven-workflow.instructions.md +- instructions/task-implementation.instructions.md +- instructions/tasksync.instructions.md +- instructions/template.instructions.md +- instructions/tools.instructions.md +- instructions/wordpress-project-planning.instructions.md +- instructions/workflows.instructions.md - plugins/README.md +- plugins/lightspeed-github-ops/INSTALL.md - plugins/lightspeed-github-ops/README.md +- plugins/lightspeed-github-ops/agents/reviewer.agent.md - plugins/lightspeed-github-ops/hooks/README.md +- plugins/lightspeed-github-ops/skills/lightspeed-frontmatter-audit/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-issue-template-compliance/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-issue-triage-automation/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-label-governance/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-pr-review/SKILL.md +- plugins/lightspeed-github-ops/skills/lightspeed-pr-template-compliance/SKILL.md - plugins/lightspeed-metrics-and-reporting/README.md +- plugins/lightspeed-metrics-and-reporting/agents/metrics-reporting-orchestrator.agent.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-issue-response-time-report/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-labeling-metrics-report/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-metrics-reporting/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-pr-cycle-time-report/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-repository-health-summary/SKILL.md +- plugins/lightspeed-metrics-and-reporting/skills/lightspeed-review-latency-report/SKILL.md - plugins/lightspeed-quality-assurance/README.md +- plugins/lightspeed-quality-assurance/agents/qa-orchestrator.agent.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-flaky-test-triage/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-qa-signoff-summary/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-quality-gate/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-regression-risk-assessment/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-test-failure-triage/SKILL.md +- plugins/lightspeed-quality-assurance/skills/lightspeed-test-matrix-planner/SKILL.md - plugins/lightspeed-release-ops/README.md +- plugins/lightspeed-release-ops/agents/release-ops-orchestrator.agent.md +- plugins/lightspeed-release-ops/skills/lightspeed-changelog-compliance/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-notes-generator/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-readiness/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-risk-assessment/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-release-rollout-checklist/SKILL.md +- plugins/lightspeed-release-ops/skills/lightspeed-version-bump-planner/SKILL.md - plugins/lightspeed-wordpress-governance/README.md +- plugins/lightspeed-wordpress-governance/agents/wordpress-governance-reviewer.agent.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-accessibility-governance/SKILL.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-governance-checks/SKILL.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-release-hygiene-check/SKILL.md +- plugins/lightspeed-wordpress-governance/skills/lightspeed-wordpress-security-governance/SKILL.md - plugins/lightspeed-wordpress-planning/README.md +- plugins/lightspeed-wordpress-planning/agents/project-spec-orchestrator.agent.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-capacity-planner/SKILL.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-milestone-planner/SKILL.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-spec-planning/SKILL.md +- plugins/lightspeed-wordpress-planning/skills/lightspeed-wordpress-sprint-roadmap/SKILL.md - profile/README.md - prompts/README.md - schema/README.md +- schema/agent-config.example.md - scripts/README.md -- scripts/agents/**tests**/README.md +- scripts/agents/__tests__/README.md - scripts/agents/includes/README.md -- scripts/agents/includes/**tests**/README.md +- scripts/agents/includes/__tests__/README.md - scripts/validation/README.md - skills/README.md +- skills/design-md-agent/INDEX.md +- skills/design-md-agent/agent-creator/SKILL.md +- skills/design-md-agent/agent-creator/references/agent-requirements-template.md +- skills/design-md-agent/agent-creator/references/agent-system-prompt-template.md +- skills/design-md-agent/agent-creator/references/example-pre-call-researcher.md +- skills/design-md-agent/agent-creator/references/output-template-library.md +- skills/design-md-agent/agent-creator/references/quality-checklist.md +- skills/design-md-agent/agent-creator/references/skill-package-template.md +- skills/design-md-agent/agent-creator/references/tool-permission-matrix-template.md +- skills/design-md-agent/ai-chatbot-planner/SKILL.md +- skills/design-md-agent/ai-chatbot-planner/references/ai-engine-implementation-notes.md +- skills/design-md-agent/ai-chatbot-planner/references/chatbot-brief-template.md +- skills/design-md-agent/ai-chatbot-planner/references/launch-gates.md +- skills/design-md-agent/ai-chatbot-planner/references/privacy-log-retention.md +- skills/design-md-agent/ai-chatbot-planner/references/test-scripts.md +- skills/design-md-agent/ai-governance-documentor/SKILL.md +- skills/design-md-agent/ai-governance-documentor/references/governance-guide-template.md +- skills/design-md-agent/ai-governance-documentor/references/high-risk-interactive-mode.md +- skills/design-md-agent/ai-governance-documentor/references/minimum-client-inputs.md +- skills/design-md-agent/ai-governance-documentor/references/prompt-templates.md +- skills/design-md-agent/ai-governance-documentor/references/role-map.md +- skills/design-md-agent/ai-readiness-assessor/SKILL.md +- skills/design-md-agent/ai-readiness-assessor/references/red-flags.md +- skills/design-md-agent/ai-readiness-assessor/references/report-template.md +- skills/design-md-agent/ai-readiness-assessor/references/scoring-model.md +- skills/design-md-agent/ai-readiness-assessor/references/tool-checks.md +- skills/design-md-agent/apply-design-system/SKILL.md +- skills/design-md-agent/audit-design-system/SKILL.md +- skills/design-md-agent/cc-figma-component/SKILL.md +- skills/design-md-agent/chatgpt-apps/SKILL.md +- skills/design-md-agent/chatgpt-apps/references/app-archetypes.md +- skills/design-md-agent/chatgpt-apps/references/apps-sdk-docs-workflow.md +- skills/design-md-agent/chatgpt-apps/references/interactive-state-sync-patterns.md +- skills/design-md-agent/chatgpt-apps/references/repo-contract-and-validation.md +- skills/design-md-agent/chatgpt-apps/references/search-fetch-standard.md +- skills/design-md-agent/chatgpt-apps/references/upstream-example-workflow.md +- skills/design-md-agent/chatgpt-apps/references/window-openai-patterns.md +- skills/design-md-agent/content-collection-planner/SKILL.md +- skills/design-md-agent/content-collection-planner/references/client-email-template.md +- skills/design-md-agent/content-collection-planner/references/content-gap-report-template.md +- skills/design-md-agent/content-collection-planner/references/folder-structure.md +- skills/design-md-agent/content-collection-planner/references/generic-website-content-checklist.md +- skills/design-md-agent/content-collection-planner/references/sector-addons.md +- skills/design-md-agent/design-md-evidence-gatherer/SKILL.md +- skills/design-md-agent/design-md-format-enforcer/SKILL.md +- skills/design-md-agent/design-md-generator/SKILL.md +- skills/design-md-agent/design-md-generator/references/design-md-cli-and-portability.md +- skills/design-md-agent/design-md-generator/references/design-md-workflow.md +- skills/design-md-agent/design-md-generator/references/figma-to-design-md-mapping.md +- skills/design-md-agent/design-md-generator/references/output-templates.md +- skills/design-md-agent/design-md-generator/references/qa-rubric.md +- skills/design-md-agent/design-md-generator/references/wordpress-ci-integration.md +- skills/design-md-agent/design-md-generator/references/wordpress-theme-json-mapping.md +- skills/design-md-agent/design-md-intake-triage/SKILL.md +- skills/design-md-agent/design-md-standards-validator/SKILL.md +- skills/design-md-agent/design-md-user-defaults-onboarding/SKILL.md +- skills/design-md-agent/docx/SKILL.md +- skills/design-md-agent/docx/examples/end_to_end_smoke_test.md +- skills/design-md-agent/docx/ooxml/comments.md +- skills/design-md-agent/docx/ooxml/hyperlinks_and_fields.md +- skills/design-md-agent/docx/ooxml/rels_and_content_types.md +- skills/design-md-agent/docx/ooxml/tracked_changes.md +- skills/design-md-agent/docx/tasks/accessibility_a11y.md +- skills/design-md-agent/docx/tasks/captions_crossrefs.md +- skills/design-md-agent/docx/tasks/clean_tracked_changes.md +- skills/design-md-agent/docx/tasks/comments_manage.md +- skills/design-md-agent/docx/tasks/compare_diff.md +- skills/design-md-agent/docx/tasks/create_edit.md +- skills/design-md-agent/docx/tasks/fields_update.md +- skills/design-md-agent/docx/tasks/fixtures_edge_cases.md +- skills/design-md-agent/docx/tasks/footnotes_endnotes.md +- skills/design-md-agent/docx/tasks/forms_content_controls.md +- skills/design-md-agent/docx/tasks/headings_numbering.md +- skills/design-md-agent/docx/tasks/images_figures.md +- skills/design-md-agent/docx/tasks/multi_doc_merge.md +- skills/design-md-agent/docx/tasks/navigation_internal_links.md +- skills/design-md-agent/docx/tasks/privacy_scrub_metadata.md +- skills/design-md-agent/docx/tasks/protection_restrict_editing.md +- skills/design-md-agent/docx/tasks/read_review.md +- skills/design-md-agent/docx/tasks/redaction_anonymization.md +- skills/design-md-agent/docx/tasks/sections_layout.md +- skills/design-md-agent/docx/tasks/style_lint_normalize.md +- skills/design-md-agent/docx/tasks/tables_spreadsheets.md +- skills/design-md-agent/docx/tasks/templates_style_packs.md +- skills/design-md-agent/docx/tasks/toc_workflow.md +- skills/design-md-agent/docx/tasks/verify_render.md +- skills/design-md-agent/docx/tasks/watermarks_background.md +- skills/design-md-agent/docx/troubleshooting/libreoffice_headless.md +- skills/design-md-agent/docx/troubleshooting/run_splitting.md +- skills/design-md-agent/edit-figma-design/SKILL.md +- skills/design-md-agent/figma-code-connect/SKILL.md +- skills/design-md-agent/figma-code-connect/references/advanced-patterns.md +- skills/design-md-agent/figma-code-connect/references/api.md +- skills/design-md-agent/figma-create-design-system-rules/SKILL.md +- skills/design-md-agent/figma-implement-design/SKILL.md +- skills/design-md-agent/figma-themejson-custom-color-tokens/SKILL.md +- skills/design-md-agent/figma-themejson-palette/SKILL.md +- skills/design-md-agent/figma-themejson-radius/SKILL.md +- skills/design-md-agent/figma-themejson-shadow/SKILL.md +- skills/design-md-agent/figma-themejson-spacing/SKILL.md +- skills/design-md-agent/figma-themejson-style-variations/SKILL.md +- skills/design-md-agent/figma-themejson-typography/SKILL.md +- skills/design-md-agent/figma-use/SKILL.md +- skills/design-md-agent/figma-use/references/api-reference.md +- skills/design-md-agent/figma-use/references/common-patterns.md +- skills/design-md-agent/figma-use/references/component-patterns.md +- skills/design-md-agent/figma-use/references/effect-style-patterns.md +- skills/design-md-agent/figma-use/references/gotchas.md +- skills/design-md-agent/figma-use/references/plugin-api-patterns.md +- skills/design-md-agent/figma-use/references/plugin-api-standalone.index.md +- skills/design-md-agent/figma-use/references/text-style-patterns.md +- skills/design-md-agent/figma-use/references/validation-and-recovery.md +- skills/design-md-agent/figma-use/references/variable-patterns.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-components--creating.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-components--using.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-components.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-effect-styles.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-text-styles.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-variables--creating.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-variables--using.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds-variables.md +- skills/design-md-agent/figma-use/references/working-with-design-systems/wwds.md +- skills/design-md-agent/figma-wordpress-skill-creator/SKILL.md +- skills/design-md-agent/figma-wordpress-skill-creator/references/eval-and-trigger-rubric.md +- skills/design-md-agent/figma-wordpress-skill-creator/references/figma-wordpress-patterns.md +- skills/design-md-agent/figma-wordpress-skill-creator/references/output-templates.md +- skills/design-md-agent/fix-design-system-finding/SKILL.md +- skills/design-md-agent/generate-project-plan/SKILL.md +- skills/design-md-agent/generate-project-plan/references/blocks/diagram-section.md +- skills/design-md-agent/generate-project-plan/references/blocks/intro-callout.md +- skills/design-md-agent/generate-project-plan/references/blocks/metadata-strip.md +- skills/design-md-agent/generate-project-plan/references/blocks/multi-column-text.md +- skills/design-md-agent/generate-project-plan/references/blocks/nested-section.md +- skills/design-md-agent/generate-project-plan/references/blocks/section.md +- skills/design-md-agent/generate-project-plan/references/blocks/sticky-column.md +- skills/design-md-agent/generate-project-plan/references/blocks/table.md +- skills/design-md-agent/generate-project-plan/references/blocks/text-primitives.md +- skills/design-md-agent/generate-project-plan/references/foundation/codebase-grounding.md +- skills/design-md-agent/generate-project-plan/references/foundation/layout.md +- skills/design-md-agent/generate-project-plan/references/foundation/palette.md +- skills/design-md-agent/generate-project-plan/references/foundation/plugin-api-traps.md +- skills/design-md-agent/generate-project-plan/references/section-catalog.md +- skills/design-md-agent/gh-fix-ci/SKILL.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/SKILL.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/acceptance-test-plan-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/go-no-go-acceptance-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/issue-test-matrix-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/requirement-test-matrix-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/assets/test-script-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/acceptance-test-workflow.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/accessibility-responsive-tests.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/block-plugin-tests.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/figma-parity-tests.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/report-template.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/test-scenario-types.md +- skills/design-md-agent/lightspeed-acceptance-test-planner/references/wordpress-block-theme-tests.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/SKILL.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/client-project-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/lightspeed-service-positioning.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/output-standards.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/red-flags.md +- skills/design-md-agent/lightspeed-ai-readiness-orchestrator/references/skill-routing-rules.md +- skills/design-md-agent/lightspeed-ai-readiness-router/SKILL.md +- skills/design-md-agent/lightspeed-ai-readiness-router/references/client-project-pack-outputs.md +- skills/design-md-agent/lightspeed-ai-readiness-router/references/proposal-line-items.md +- skills/design-md-agent/lightspeed-ai-readiness-router/references/workflow-router.md +- skills/design-md-agent/lightspeed-ai-readiness/SKILL.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/chatbot-planning-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/content-collection-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/governance-discovery-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/readiness-assessment-wizard.md +- skills/design-md-agent/lightspeed-ai-readiness/assets/universal-client-project-kickoff.md +- skills/design-md-agent/lightspeed-ai-readiness/references/ai-chatbot-planner.md +- skills/design-md-agent/lightspeed-ai-readiness/references/ai-governance-documentor.md +- skills/design-md-agent/lightspeed-ai-readiness/references/ai-readiness-assessor.md +- skills/design-md-agent/lightspeed-ai-readiness/references/client-output-standards.md +- skills/design-md-agent/lightspeed-ai-readiness/references/content-collection-planner.md +- skills/design-md-agent/lightspeed-ai-readiness/references/lightspeed-style-guide.md +- skills/design-md-agent/lightspeed-ai-readiness/references/router-and-project-pack.md +- skills/design-md-agent/lightspeed-ai-readiness/references/source-frameworks.md +- skills/design-md-agent/lightspeed-approval-gate-manager/SKILL.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/approval-summary-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/decision-log-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/gate-checklist-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/risk-register-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/assets/stakeholder-review-pack-template.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/approval-gate-workflow.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/decision-log-rules.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/gate-types.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/stakeholder-review-rules.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/status-model.md +- skills/design-md-agent/lightspeed-approval-gate-manager/references/wordpress-project-gates.md +- skills/design-md-agent/lightspeed-change-request-router/SKILL.md +- skills/design-md-agent/lightspeed-change-request-router/assets/approval-checklist-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/artifact-update-notes-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/change-log-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/change-request-assessment-template.md +- skills/design-md-agent/lightspeed-change-request-router/assets/client-summary-template.md +- skills/design-md-agent/lightspeed-change-request-router/references/approval-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/artifact-update-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/change-request-workflow.md +- skills/design-md-agent/lightspeed-change-request-router/references/classification-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/impact-analysis-rules.md +- skills/design-md-agent/lightspeed-change-request-router/references/report-template.md +- skills/design-md-agent/lightspeed-change-request-router/references/specialist-routing.md +- skills/design-md-agent/lightspeed-claim-register-auditor/SKILL.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/approved-wording-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/claim-register-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/evidence-needed-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/page-location-map-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/publication-summary-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/rejected-wording-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/assets/review-owner-template.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/approved-wording-rules.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/chatbot-claim-rules.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/claim-audit-workflow.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/claim-types.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/classification-rules.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/evidence-standards.md +- skills/design-md-agent/lightspeed-claim-register-auditor/references/report-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/SKILL.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/chatbot-safe-faq-register-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/company-faq-page-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/duplicate-faq-report-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/escalation-questions-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/page-level-faq-map-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/schema-ready-faq-answers-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/assets/unsupported-questions-template.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/chatbot-safe-source-rules.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/escalation-and-unsupported-rules.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/faq-curation-workflow.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/faq-taxonomy.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/report-templates.md +- skills/design-md-agent/lightspeed-faq-and-chatbot-source-curator/references/schema-ready-faq-rules.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/SKILL.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/accessibility-state-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/component-block-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/issue-register-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/light-dark-mode-qa-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/parity-audit-report-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/pattern-section-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/responsive-qa-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/assets/token-parity-table-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/accessibility-state-qa.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/component-block-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/issue-severity-model.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/light-dark-mode-qa.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/parity-audit-workflow.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/pattern-section-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/responsive-state-qa.md +- skills/design-md-agent/lightspeed-figma-wordpress-parity-auditor/references/theme-json-token-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/SKILL.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/block-plugin-requirements-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/component-block-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/github-issue-seeds-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/open-questions-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/technical-brief-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/template-pattern-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/assets/token-map-template.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/block-plugin-requirements.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/block-theme-requirements.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/component-to-block-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/editor-experience.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/figma-evidence-intake.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/pattern-template-mapping.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/qa-handoff.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/technical-brief-workflow.md +- skills/design-md-agent/lightspeed-figma-wordpress-technical-brief/references/theme-json-token-mapping.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/SKILL.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/chatbot-handoff-events-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/consultation-cta-tracking-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/form-tracking-plan-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/ga4-event-plan-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/gtm-trigger-notes-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/launch-baseline-report-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/lead-magnet-tracking-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/looker-studio-dashboard-brief-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/assets/measurement-qa-checklist-template.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/chatbot-handoff-events.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/event-naming-and-parameters.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/form-and-lead-tracking.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/gtm-trigger-notes.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/launch-baseline-report.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/looker-studio-dashboard.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/measurement-workflow.md +- skills/design-md-agent/lightspeed-ga4-conversion-tracking-planner/references/privacy-and-consent-notes.md +- skills/design-md-agent/lightspeed-github-issue-drafter/SKILL.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/epic-issue-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/issue-index-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/issue-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/launch-qa-issue-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/assets/review-checklist-template.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/acceptance-criteria-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/dependency-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/issue-drafting-workflow.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/issue-templates.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/label-and-milestone-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/qa-and-review-rules.md +- skills/design-md-agent/lightspeed-github-issue-drafter/references/wordpress-issue-rules.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/SKILL.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/branch-pr-strategy-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/dependency-map-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/handoff-notes-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/implementation-plan-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/risk-register-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/wave-plan-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/assets/workstream-plan-template.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/branch-pr-strategy.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/implementation-workflow.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/risk-and-decision-rules.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/testing-and-qa.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/wave-planning.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/wordpress-implementation-rules.md +- skills/design-md-agent/lightspeed-implementation-plan-generator/references/workstream-model.md +- skills/design-md-agent/lightspeed-launch-qa-planner/SKILL.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/block-plugin-qa-matrix-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/go-no-go-summary-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/launch-gate-checklist-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/launch-qa-plan-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/page-template-qa-matrix-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/pattern-qa-matrix-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/assets/qa-workstream-table-template.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/accessibility-responsive-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/block-plugin-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/block-theme-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/conversion-and-tracking-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/figma-to-wordpress-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/launch-gate-model.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/launch-qa-planning-workflow.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/pattern-and-template-qa.md +- skills/design-md-agent/lightspeed-launch-qa-planner/references/specialist-skill-routing.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/SKILL.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/accessibility-testing-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/analytics-tagging-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/broken-link-checklist-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/form-testing-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/go-no-go-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/launch-checklist-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/mobile-responsive-qa-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/page-qa-table-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/assets/performance-notes-template.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/go-no-go-rules.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/issue-severity-model.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/launch-readiness-workflow.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/qa-checklists.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/report-templates.md +- skills/design-md-agent/lightspeed-launch-readiness-auditor/references/wordpress-launch-notes.md +- skills/design-md-agent/lightspeed-launch-task-router/SKILL.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/go-no-go-routing-summary-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/launch-router-checklist-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/routing-report-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/specialist-prompt-starters-template.md +- skills/design-md-agent/lightspeed-launch-task-router/assets/workstream-routing-template.md +- skills/design-md-agent/lightspeed-launch-task-router/references/approval-gates.md +- skills/design-md-agent/lightspeed-launch-task-router/references/dependency-sequencing.md +- skills/design-md-agent/lightspeed-launch-task-router/references/launch-task-routing-workflow.md +- skills/design-md-agent/lightspeed-launch-task-router/references/launch-workstreams.md +- skills/design-md-agent/lightspeed-launch-task-router/references/specialist-skill-routing.md +- skills/design-md-agent/lightspeed-policy-page-generator/SKILL.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/accessibility-statement-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/ai-governance-page-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/chatbot-disclosure-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/cookie-policy-brief-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/data-log-retention-decision-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/assets/privacy-policy-brief-template.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/accessibility-statement.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/ai-governance-page.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/chatbot-disclosure.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/cookie-policy-brief.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/data-log-retention.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/policy-workflow.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/privacy-policy-brief.md +- skills/design-md-agent/lightspeed-policy-page-generator/references/review-and-approval.md +- skills/design-md-agent/lightspeed-prd-generator/SKILL.md +- skills/design-md-agent/lightspeed-prd-generator/assets/discovery-summary-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/open-questions-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/persona-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/prd-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/requirements-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/success-metrics-template.md +- skills/design-md-agent/lightspeed-prd-generator/assets/user-story-template.md +- skills/design-md-agent/lightspeed-prd-generator/references/acceptance-criteria-rules.md +- skills/design-md-agent/lightspeed-prd-generator/references/approval-gates.md +- skills/design-md-agent/lightspeed-prd-generator/references/figma-design-system-rules.md +- skills/design-md-agent/lightspeed-prd-generator/references/prd-workflow.md +- skills/design-md-agent/lightspeed-prd-generator/references/project-types.md +- skills/design-md-agent/lightspeed-prd-generator/references/success-metrics.md +- skills/design-md-agent/lightspeed-prd-generator/references/wordpress-prd-rules.md +- skills/design-md-agent/lightspeed-prd-task-manager/SKILL.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/full-project-pack-structure.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/issue-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/prd-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/task-plan-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/assets/technical-brief-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/acceptance-criteria.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/agent-spec.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/figma-wordpress-technical-brief.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/github-issue-drafts.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/memory-bank.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/prd-template.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/qa-and-launch-routing.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/task-breakdown-rules.md +- skills/design-md-agent/lightspeed-prd-task-manager/references/wordpress-standards.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/SKILL.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/README-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/file-index-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/next-actions-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/pack-status-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/review-checklist-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/assets/source-inventory-template.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/file-naming-rules.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/pack-quality-checklist.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/pack-workflow.md +- skills/design-md-agent/lightspeed-prd-task-pack-exporter/references/source-classification.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/SKILL.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/gap-register-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/go-no-go-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/issue-quality-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/assets/review-report-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/issue-review-rules.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/prd-review-rules.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/readiness-scoring.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/report-template.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/review-workflow.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/task-review-rules.md +- skills/design-md-agent/lightspeed-prd-task-reviewer/references/technical-brief-review-rules.md +- skills/design-md-agent/lightspeed-project-intake-router/SKILL.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/kickoff-pack-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/missing-inputs-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/prompt-starters-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/source-inventory-template.md +- skills/design-md-agent/lightspeed-project-intake-router/assets/workflow-route-template.md +- skills/design-md-agent/lightspeed-project-intake-router/references/approval-gates.md +- skills/design-md-agent/lightspeed-project-intake-router/references/clarifying-questions.md +- skills/design-md-agent/lightspeed-project-intake-router/references/intake-workflow.md +- skills/design-md-agent/lightspeed-project-intake-router/references/project-type-classification.md +- skills/design-md-agent/lightspeed-project-intake-router/references/source-inventory-rules.md +- skills/design-md-agent/lightspeed-project-intake-router/references/specialist-routing.md +- skills/design-md-agent/lightspeed-project-memory-manager/SKILL.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/README-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/activeContext-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/assumptions-risks-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/decision-log-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/handoff-summary-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/productContext-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/progress-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/projectbrief-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/systemPatterns-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/task-index-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/assets/techContext-template.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/file-definitions.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/handoff-rules.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/memory-bank-workflow.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/status-and-decision-rules.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/task-index-rules.md +- skills/design-md-agent/lightspeed-project-memory-manager/references/wordpress-project-memory.md +- skills/design-md-agent/lightspeed-project-researcher/SKILL.md +- skills/design-md-agent/lightspeed-project-researcher/assets/decision-blockers-template.md +- skills/design-md-agent/lightspeed-project-researcher/assets/open-questions-template.md +- skills/design-md-agent/lightspeed-project-researcher/assets/research-report-template.md +- skills/design-md-agent/lightspeed-project-researcher/assets/source-inventory-template.md +- skills/design-md-agent/lightspeed-project-researcher/references/evidence-classification.md +- skills/design-md-agent/lightspeed-project-researcher/references/figma-research.md +- skills/design-md-agent/lightspeed-project-researcher/references/github-research.md +- skills/design-md-agent/lightspeed-project-researcher/references/prd-handoff.md +- skills/design-md-agent/lightspeed-project-researcher/references/research-workflow.md +- skills/design-md-agent/lightspeed-project-researcher/references/source-inventory.md +- skills/design-md-agent/lightspeed-project-researcher/references/wordpress-site-research.md +- skills/design-md-agent/lightspeed-project-status-reporter/SKILL.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/client-update-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/decision-update-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/internal-delivery-report-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/launch-readiness-snapshot-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/assets/weekly-status-template.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/audience-rules.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/report-templates.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/status-model.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/status-report-workflow.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/update-examples.md +- skills/design-md-agent/lightspeed-project-status-reporter/references/workstream-model.md +- skills/design-md-agent/lightspeed-qa-findings-router/SKILL.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/client-summary-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/github-issue-draft-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/launch-blocker-list-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/qa-findings-register-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/retest-checklist-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/assets/workstream-routing-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/github-issue-drafting.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/qa-findings-workflow.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/report-template.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/retest-rules.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/severity-and-launch-status.md +- skills/design-md-agent/lightspeed-qa-findings-router/references/workstream-routing.md +- skills/design-md-agent/lightspeed-redirect-map-planner/SKILL.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/404-risk-list-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/current-url-inventory-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/launch-day-checklist-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/new-url-map-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/redirect-status-table-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/assets/seo-migration-summary-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/redirect-planning-workflow.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/redirect-status-model.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/report-template.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/seo-migration-notes.md +- skills/design-md-agent/lightspeed-redirect-map-planner/references/wordpress-redirect-notes.md +- skills/design-md-agent/lightspeed-release-handoff-generator/SKILL.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/client-handoff-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/internal-handoff-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/known-issues-register-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/post-launch-monitoring-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/release-notes-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/assets/support-transition-template.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/client-handoff-rules.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/known-issues-rules.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/post-launch-monitoring.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/release-handoff-workflow.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/release-notes-rules.md +- skills/design-md-agent/lightspeed-release-handoff-generator/references/support-transition-rules.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/SKILL.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/coverage-summary-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/gap-register-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/orphan-task-report-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/requirement-register-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/assets/traceability-matrix-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/coverage-rules.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/qa-coverage-rules.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/report-template.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/requirement-classification.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/traceability-workflow.md +- skills/design-md-agent/lightspeed-requirements-traceability-mapper/references/wordpress-traceability.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/SKILL.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/ai-visibility-baseline-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/claim-safe-wording-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/faq-schema-map-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/internal-linking-plan-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/page-schema-recommendation-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/assets/schema-launch-checklist-template.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/ai-visibility-baseline.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/answer-engine-optimisation.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/claim-safe-wording.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/faq-schema-map.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/internal-linking-rules.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/schema-types.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/schema-workflow.md +- skills/design-md-agent/lightspeed-schema-and-ai-discoverability-planner/references/validation-and-monitoring.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/SKILL.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/acceptance-test-map-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/dependency-map-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/epic-map-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/github-issue-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/implementation-waves-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/assets/task-plan-template.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/acceptance-criteria.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/dependency-and-wave-planning.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/estimation-models.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/issue-draft-rules.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/qa-mapping.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/task-breakdown-workflow.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/wordpress-task-rules.md +- skills/design-md-agent/lightspeed-task-breakdown-planner/references/workstream-model.md +- skills/design-md-agent/lightspeed-website-content-generator/SKILL.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/case-study-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/content-pack-readme-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/faq-page-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/page-brief-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/service-page-template.md +- skills/design-md-agent/lightspeed-website-content-generator/assets/solution-page-template.md +- skills/design-md-agent/lightspeed-website-content-generator/references/chatbot-safe-content-rules.md +- skills/design-md-agent/lightspeed-website-content-generator/references/claim-handling-rules.md +- skills/design-md-agent/lightspeed-website-content-generator/references/content-generation-workflow.md +- skills/design-md-agent/lightspeed-website-content-generator/references/lightspeed-style-guide.md +- skills/design-md-agent/lightspeed-website-content-generator/references/page-output-templates.md +- skills/design-md-agent/lightspeed-website-content-generator/references/review-status-labels.md +- skills/design-md-agent/lightspeed-website-content-generator/references/seo-and-schema-rules.md +- skills/design-md-agent/lightspeed-website-content-generator/references/source-inputs.md +- skills/design-md-agent/linear/SKILL.md - skills/design-md-agent/markdown-content-validator/README.md +- skills/design-md-agent/markdown-content-validator/SKILL.md +- skills/design-md-agent/markdown-content-validator/references/example-validation-report.md +- skills/design-md-agent/markdown-content-validator/references/markdown-validation-rules.md +- skills/design-md-agent/markdown-content-validator/references/schema-customisation.md +- skills/design-md-agent/markdown-content-validator/references/semver-versioning-rules.md +- skills/design-md-agent/markdown-content-validator/tests/invalid-version.md +- skills/design-md-agent/markdown-content-validator/tests/markdown-content-validation-report.md +- skills/design-md-agent/markdown-content-validator/tests/markdown-issues.md +- skills/design-md-agent/markdown-content-validator/tests/missing-frontmatter.md +- skills/design-md-agent/markdown-content-validator/tests/report.md +- skills/design-md-agent/markdown-content-validator/tests/valid-example.md +- skills/design-md-agent/markdown-content-validator/tests/valid-report.md +- skills/design-md-agent/pdfs/SKILL.md +- skills/design-md-agent/pdfs/examples/smoke_test.md +- skills/design-md-agent/pdfs/tasks/batch.md +- skills/design-md-agent/pdfs/tasks/compare.md +- skills/design-md-agent/pdfs/tasks/convert.md +- skills/design-md-agent/pdfs/tasks/coords.md +- skills/design-md-agent/pdfs/tasks/create.md +- skills/design-md-agent/pdfs/tasks/edit.md +- skills/design-md-agent/pdfs/tasks/extract.md +- skills/design-md-agent/pdfs/tasks/forms_annotations.md +- skills/design-md-agent/pdfs/tasks/forms_debugging.md +- skills/design-md-agent/pdfs/tasks/forms_nonfillable.md +- skills/design-md-agent/pdfs/tasks/js_tools.md +- skills/design-md-agent/pdfs/tasks/ocr.md +- skills/design-md-agent/pdfs/tasks/parity.md +- skills/design-md-agent/pdfs/tasks/preflight.md +- skills/design-md-agent/pdfs/tasks/read_review.md +- skills/design-md-agent/pdfs/tasks/redact.md +- skills/design-md-agent/pdfs/troubleshooting/common.md +- skills/design-md-agent/skill-creator/SKILL.md +- skills/design-md-agent/skill-creator/references/output-patterns.md +- skills/design-md-agent/skill-creator/references/sample-prompts.md +- skills/design-md-agent/skill-creator/references/workflows.md +- skills/design-md-agent/slides/SKILL.md - skills/design-md-agent/slides/artifact_tool/README.md +- skills/design-md-agent/slides/artifact_tool/auto-layout.spec.md +- skills/design-md-agent/slides/artifact_tool/charts.spec.md +- skills/design-md-agent/slides/artifact_tool/fill.spec.md +- skills/design-md-agent/slides/artifact_tool/images.spec.md +- skills/design-md-agent/slides/artifact_tool/inspect.spec.md +- skills/design-md-agent/slides/artifact_tool/layout.spec.md +- skills/design-md-agent/slides/artifact_tool/master.spec.md +- skills/design-md-agent/slides/artifact_tool/presentation.spec.md +- skills/design-md-agent/slides/artifact_tool/rich-text.spec.md +- skills/design-md-agent/slides/artifact_tool/shapes.spec.md +- skills/design-md-agent/slides/artifact_tool/slide.spec.md +- skills/design-md-agent/slides/artifact_tool/speaker-notes.spec.md +- skills/design-md-agent/slides/artifact_tool/styles.spec.md +- skills/design-md-agent/slides/artifact_tool/tables.spec.md +- skills/design-md-agent/slides/artifact_tool/theme.spec.md +- skills/design-md-agent/spreadsheets/API_QUICK_START.md +- skills/design-md-agent/spreadsheets/SKILL.md +- skills/design-md-agent/spreadsheets/templates/financial_models.md +- skills/design-md-agent/sync-figma-token/SKILL.md +- skills/design-md-agent/theme-color-token-enforcer/SKILL.md +- skills/design-md-agent/themejson-extractor-orchestrator/SKILL.md +- skills/design-md-agent/themejson-extractor-orchestrator/references/lightspeed-themejson-example.md +- skills/design-md-agent/wordpress-asset-parameter-generator/SKILL.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/output-templates.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-asset-parameter-generator/references/workflow.md +- skills/design-md-agent/wordpress-block-asset-validator/SKILL.md +- skills/design-md-agent/wordpress-block-asset-validator/references/output-templates.md +- skills/design-md-agent/wordpress-block-asset-validator/references/qa-rubric.md +- skills/design-md-agent/wordpress-block-asset-validator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-block-asset-validator/references/workflow.md +- skills/design-md-agent/wordpress-block-style-generator/SKILL.md +- skills/design-md-agent/wordpress-block-style-generator/references/output-templates.md +- skills/design-md-agent/wordpress-block-style-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-block-style-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-block-style-generator/references/workflow.md +- skills/design-md-agent/wordpress-block-theme-router/SKILL.md +- skills/design-md-agent/wordpress-block-theme-router/references/output-templates.md +- skills/design-md-agent/wordpress-block-theme-router/references/qa-rubric.md +- skills/design-md-agent/wordpress-block-theme-router/references/routing-matrix.md +- skills/design-md-agent/wordpress-block-theme-router/references/wordpress-rules.md +- skills/design-md-agent/wordpress-block-theme-router/references/workflow.md +- skills/design-md-agent/wordpress-custom-template-generator/SKILL.md +- skills/design-md-agent/wordpress-custom-template-generator/references/output-templates.md +- skills/design-md-agent/wordpress-custom-template-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-custom-template-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-custom-template-generator/references/workflow.md +- skills/design-md-agent/wordpress-design-system-intake-onboarding/SKILL.md +- skills/design-md-agent/wordpress-pattern-generator/SKILL.md +- skills/design-md-agent/wordpress-pattern-generator/references/output-templates.md +- skills/design-md-agent/wordpress-pattern-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-pattern-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-pattern-generator/references/workflow.md +- skills/design-md-agent/wordpress-plugin-extension-audit/SKILL.md +- skills/design-md-agent/wordpress-plugin-extension-audit/references/plugin-audit-checklist.md +- skills/design-md-agent/wordpress-plugin-packaging-review/SKILL.md +- skills/design-md-agent/wordpress-plugin-packaging-review/references/output-templates.md +- skills/design-md-agent/wordpress-plugin-packaging-review/references/qa-rubric.md +- skills/design-md-agent/wordpress-plugin-packaging-review/references/workflow.md +- skills/design-md-agent/wordpress-section-style-generator/SKILL.md +- skills/design-md-agent/wordpress-section-style-generator/references/output-templates.md +- skills/design-md-agent/wordpress-section-style-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-section-style-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-section-style-generator/references/workflow.md +- skills/design-md-agent/wordpress-template-generator/SKILL.md +- skills/design-md-agent/wordpress-template-generator/references/output-templates.md +- skills/design-md-agent/wordpress-template-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-template-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-template-generator/references/workflow.md +- skills/design-md-agent/wordpress-template-part-generator/SKILL.md +- skills/design-md-agent/wordpress-template-part-generator/references/output-templates.md +- skills/design-md-agent/wordpress-template-part-generator/references/qa-rubric.md +- skills/design-md-agent/wordpress-template-part-generator/references/wordpress-rules.md +- skills/design-md-agent/wordpress-template-part-generator/references/workflow.md +- skills/design-md-agent/wordpress-theme-validation/SKILL.md +- skills/design-md-agent/wordpress-theme-validation/references/figma-traceability.md +- skills/design-md-agent/wordpress-theme-validation/references/validation-checklist.md +- skills/lightspeed-frontmatter-audit/SKILL.md +- skills/lightspeed-label-governance/SKILL.md +- skills/lightspeed-pr-review/SKILL.md - tests/README.md - website/README.md +- website/src/content/agents/claude.md - workflows/README.md - workflows/memory/README.md +- workflows/portable-ai-plugin-restructure.md +- workflows/release-readiness-validation.md +- workflows/weekly-governance-sync.md +- workflows/wordpress-project-onboarding.md +- workflows/wordpress-spec-to-implementation.md -Detailed Results ----------------- +## Detailed Results โœ… All diagrams are syntactically valid! -Recommendations ---------------- + + +## Recommendations โœ… All Mermaid diagrams pass syntax validation. Proceed to accessibility compliance audit (#669). diff --git a/.github/reports/mermaid/colour-contrast-report-2026-06-18.md b/.github/reports/mermaid/colour-contrast-report-2026-06-18.md index f8e807fa7..3a2e2f11b 100644 --- a/.github/reports/mermaid/colour-contrast-report-2026-06-18.md +++ b/.github/reports/mermaid/colour-contrast-report-2026-06-18.md @@ -11,15 +11,15 @@ stability: stable # Mermaid Colour Contrast Report -**Generated**: 2026-06-18T12:07:28.136Z +**Generated**: 2026-06-18T15:35:14.324Z ## Summary | Metric | Value | |--------|-------| -| Files scanned | 13 | -| Diagrams scanned | 45 | -| Style declarations checked | 39 | +| Files scanned | 22 | +| Diagrams scanned | 60 | +| Declarations checked | 85 | | Errors (contrast failures) | 0 | | Warnings (missing explicit color) | 0 | diff --git a/.github/reports/mermaid/diagram-validation-2025-12-11.md b/.github/reports/mermaid/diagram-validation-2025-12-11.md index 208f20439..b8fd75932 100644 --- a/.github/reports/mermaid/diagram-validation-2025-12-11.md +++ b/.github/reports/mermaid/diagram-validation-2025-12-11.md @@ -280,6 +280,8 @@ tags: ["mermaid", "validation", "accessibility", "documentation", "diagrams"] - **Example**: ```mermaid + accTitle: Mermaid validation scope overview + accDescr: Shows how the validation report groups README files into a simple top-level flowchart for the scan scope. flowchart TB A[LightSpeed Org] --> B[Community Health] A --> C[Documentation] diff --git a/.github/workflows/readme-audit.yml b/.github/workflows/readme-audit.yml index ff491d4d9..b1166543b 100644 --- a/.github/workflows/readme-audit.yml +++ b/.github/workflows/readme-audit.yml @@ -11,6 +11,7 @@ on: - all - syntax - accessibility + - contrast - staleness output_format: description: "Output format" @@ -97,14 +98,7 @@ jobs: run: npm install -g @mermaid-js/mermaid-cli - name: Validate Mermaid diagrams - run: | - find . -name "*.md" -type f | while read file; do - grep -q '```mermaid' "$file" && { - echo "Validating diagrams in $file..." - # Extract Mermaid blocks and validate - # This is a placeholder for actual validation logic - } - done + run: npm run validate:mermaid-syntax check-accessibility: name: Check WCAG Compliance @@ -122,12 +116,25 @@ jobs: cache: "npm" - name: Check accessibility attributes - run: | - echo "Checking for accessibility attributes in Mermaid diagrams..." - # Scan for accTitle and accDescr in diagrams - find . -name "*.md" -type f -exec grep -l '```mermaid' {} \; | while read file; do - echo "Checking $file for accessibility attributes..." - done + run: npm run validate:mermaid-accessibility + + check-contrast: + name: Check Mermaid Colour Contrast + runs-on: ubuntu-latest + if: contains(fromJson('["all", "contrast"]'), inputs.scope) + + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + - name: Set up Node.js + uses: actions/setup-node@v4 + with: + node-version: "18" + cache: "npm" + + - name: Check Mermaid colour contrast + run: npm run validate:mermaid-contrast check-staleness: name: Identify Stale Documents diff --git a/.github/workflows/readme-update.yml b/.github/workflows/readme-update.yml index 4006ca7e9..60aa290f0 100644 --- a/.github/workflows/readme-update.yml +++ b/.github/workflows/readme-update.yml @@ -64,12 +64,17 @@ jobs: - name: Run Mermaid diagram fixes if: ${{ env.UPDATE_SCOPE == 'all' || env.UPDATE_SCOPE == 'mermaid' }} - run: node .github/scripts/fix-mermaid-diagrams.js + run: node scripts/fix-mermaid-diagrams.js + continue-on-error: true + + - name: Validate Mermaid colour contrast + if: ${{ env.UPDATE_SCOPE == 'all' || env.UPDATE_SCOPE == 'mermaid' }} + run: npm run validate:mermaid-contrast continue-on-error: true - name: Run staleness updates if: ${{ env.UPDATE_SCOPE == 'all' || env.UPDATE_SCOPE == 'staleness' }} - run: node .github/scripts/fix-staleness-dates.js + run: node scripts/fix-staleness-dates.js continue-on-error: true - name: Generate update report @@ -84,7 +89,7 @@ jobs: ## Changes Summary - - Mermaid diagrams: Updated accessibility attributes (accTitle, accDescr) + - Mermaid diagrams: Updated accessibility attributes and colour-contrast-safe palette values - Staleness updates: Refreshed `last_updated` dates for files exceeding 6-month threshold ## Processing Mode @@ -114,7 +119,7 @@ jobs: git add -A git commit -m "docs: update READMEs with Mermaid accessibility and staleness fixes - - Update Mermaid diagrams with accTitle and accDescr attributes + - Update Mermaid diagrams with accTitle, accDescr, and approved palette values - Refresh last_updated dates for stale files (6+ months) - Scope: ${{ env.UPDATE_SCOPE }} - Generated by: readme-update.yml workflow" diff --git a/.vscode/README.md b/.vscode/README.md index 86abca5e2..56d5d54e4 100644 --- a/.vscode/README.md +++ b/.vscode/README.md @@ -55,10 +55,10 @@ flowchart TD S --> AD[Summary] T --> AE[Results] - style A fill:#e1f5fe - style B fill:#f3e5f5 - style C fill:#e8f5e8 - style D fill:#fff3e0 + style A fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + style B fill:#f3e8ff,color:#3b0764,stroke:#7e22ce + style C fill:#dcfce7,color:#14532d,stroke:#14532d + style D fill:#fef3c7,color:#4a2c00,stroke:#b45309 ``` --- diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9a3d8450b..260a65eeb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -30,6 +30,8 @@ For details, see the full guidelines below and the [Documentation Index](./docs/ --- ```mermaid +accTitle: Contribution workflow +accDescr: Shows the end-to-end contribution path from issue discussion through branch creation, implementation, validation, pull request review, and merge. flowchart TD A[Open Issue or Feature Request] --> B[Discuss & Plan] B --> C[Create Branch] diff --git a/README.md b/README.md index 8ef062983..2ea83c2d7 100644 --- a/README.md +++ b/README.md @@ -169,17 +169,17 @@ flowchart TD G --> Q[E2E Tests] G --> R[Coverage Reports] - classDef core fill:#e2e8f0,stroke:#0f172a,color:#0f172a - classDef docs fill:#d1fae5,stroke:#0f172a,color:#0f172a - classDef automation fill:#d9f2ff,stroke:#0f172a,color:#0f172a - classDef automation-sub fill:#c7d2fe,stroke:#0f172a,color:#0f172a - classDef label fill:#fee2e2,stroke:#0f172a,color:#0f172a - classDef label-sub fill:#ffe4e6,stroke:#0f172a,color:#0f172a - classDef ai fill:#f3e8ff,stroke:#0f172a,color:#0f172a - classDef ai-sub fill:#fef3c7,stroke:#0f172a,color:#0f172a - classDef docs-sub fill:#e0f2fe,stroke:#0f172a,color:#0f172a - classDef testing fill:#ecfccb,stroke:#0f172a,color:#0f172a - classDef testing-sub fill:#bae6fd,stroke:#0f172a,color:#0f172a + classDef core fill:#f1f5f9,color:#0f172a,stroke:#334155 + classDef docs fill:#dcfce7,color:#14532d,stroke:#14532d + classDef automation fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef automation-sub fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef label fill:#fee2e2,color:#7f1d1d,stroke:#b91c1c + classDef label-sub fill:#fee2e2,color:#7f1d1d,stroke:#b91c1c + classDef ai fill:#f3e8ff,color:#3b0764,stroke:#7e22ce + classDef ai-sub fill:#fef3c7,color:#4a2c00,stroke:#b45309 + classDef docs-sub fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef testing fill:#dcfce7,color:#14532d,stroke:#14532d + classDef testing-sub fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f class A core class B core @@ -251,11 +251,11 @@ flowchart LR M --> N[Quality Assurance] end - classDef repo fill:#e2e8f0,stroke:#0f172a,color:#0f172a - classDef automation fill:#d9f2ff,stroke:#0f172a,color:#0f172a - classDef ai fill:#f3e8ff,stroke:#0f172a,color:#0f172a - classDef development fill:#c7d2fe,stroke:#0f172a,color:#0f172a - classDef review fill:#fef3c7,stroke:#0f172a,color:#0f172a + classDef repo fill:#f1f5f9,color:#0f172a,stroke:#334155 + classDef automation fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef ai fill:#f3e8ff,color:#3b0764,stroke:#7e22ce + classDef development fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef review fill:#fef3c7,color:#4a2c00,stroke:#b45309 class A repo class B repo @@ -299,11 +299,11 @@ flowchart TD J --> K[๐Ÿš€ CI/CD Pipeline] K --> L[๐ŸŒ Deploy/Merge] - classDef change fill:#e2e8f0,stroke:#0f172a,color:#0f172a - classDef hook fill:#d9f2ff,stroke:#0f172a,color:#0f172a - classDef test fill:#d1fae5,stroke:#0f172a,color:#0f172a - classDef check fill:#c7d2fe,stroke:#0f172a,color:#0f172a - classDef deployment fill:#f3e8ff,stroke:#0f172a,color:#0f172a + classDef change fill:#f1f5f9,color:#0f172a,stroke:#334155 + classDef hook fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef test fill:#dcfce7,color:#14532d,stroke:#14532d + classDef check fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f + classDef deployment fill:#f3e8ff,color:#3b0764,stroke:#7e22ce class A change class B hook diff --git a/docs/AGENT_CREATION.md b/docs/AGENT_CREATION.md index 92af8e60b..8f0834819 100644 --- a/docs/AGENT_CREATION.md +++ b/docs/AGENT_CREATION.md @@ -3,9 +3,9 @@ file_type: documentation title: Agent Specification Authoring Guide description: Comprehensive guide for creating, documenting, and maintaining agent specification files following LightSpeed standards -version: 'v1.3' +version: 'v1.2' created_date: '2025-01-15' -last_updated: '2026-06-18' +last_updated: '2026-06-01' author: LightSpeed Team maintainer: LightSpeed Team license: GPL-3.0 @@ -108,11 +108,9 @@ agents/{agent-name}.agent.md ## Agent Specification Architecture ```mermaid ---- accTitle: Agent specification architecture -accDescr: Shows the three layers of agent specification โ€” the spec document with frontmatter and responsibilities, the implementation layer with code and tests, and the automation layer with workflows and validation. ---- -flowchart TD +accDescr: Shows the relationship between agent specifications, implementation code, tests, and the surrounding automation layer. +graph TB subgraph "๐Ÿ“ Agent Specification" A[YAML Frontmatter] B[Purpose & Overview] @@ -184,10 +182,8 @@ Create a new agent when: ### Mermaid: Should You Create a New Agent? ```mermaid ---- -accTitle: Should you create a new agent decision tree -accDescr: Decision flowchart for evaluating whether a new agent should be created, checking for determinism, existing coverage, guardrail feasibility, and maintainer commitment before proceeding with a spec draft. ---- +accTitle: New agent decision flow +accDescr: Shows the decision path for determining whether a new agent should be created, extended, or rejected based on determinism, scope overlap, guardrails, and ownership. flowchart TD A([New Workflow Identified]) --> B{Is it deterministic?} B -->|No| N1[Do NOT create agent] @@ -219,10 +215,8 @@ Before drafting a spec: ### Mermaid: Pre-Creation Review Path ```mermaid ---- -accTitle: Pre-creation review path for agent specifications -accDescr: Left-to-right checklist flow showing the pre-creation steps before writing an agent spec โ€” define problem, assess overlap, define tools and permissions, define guardrails, assign owner โ€” before the final decision to proceed or stop. ---- +accTitle: Agent pre-creation review path +accDescr: Shows the human review path for defining the problem, assessing overlap, documenting permissions, and assigning an owner before drafting the spec. flowchart LR Start([Start]) --> Check1[Define Problem] Check1 --> Check2[Assess Overlap] @@ -311,10 +305,8 @@ Frontmatter `owners:` must map to a team or individual who is responsible for: ### Mermaid: Approval Workflow ```mermaid ---- -accTitle: Agent specification approval workflow -accDescr: Approval workflow from spec draft through frontmatter validation, agent index entry, maintainer review, and governance review, with a decision gate that either returns the spec for revision or proceeds to merge and implementation. ---- +accTitle: Agent approval workflow +accDescr: Shows how a drafted agent spec moves through frontmatter validation, index updates, maintainer review, governance review, and publication. flowchart TD A([Spec Drafted]) --> B[Frontmatter Validation] B --> C[Add to Agent Index] @@ -358,10 +350,8 @@ Frontmatter is **machine-validated**. Errors break CI. ### Mermaid: Frontmatter Scope Map ```mermaid ---- -accTitle: Agent frontmatter scope map -accDescr: Mind map of all frontmatter fields grouped into required fields, recommended fields, agent-specific fields, and validation rules for agent specification files. ---- +accTitle: Frontmatter scope map +accDescr: Shows the frontmatter fields grouped into required, recommended, agent-specific, and validation categories for agent specification files. mindmap root((Frontmatter)) Required @@ -412,10 +402,8 @@ mindmap ### Mermaid: Full Publishing Pipeline ```mermaid ---- -accTitle: Full agent publishing pipeline -accDescr: Sequence diagram showing the full publishing pipeline from human author drafting the agent spec, running CI validation, committing and submitting a PR, through governance review and final merge with implementation and tests. ---- +accTitle: Agent publishing pipeline +accDescr: Shows the publishing sequence from drafting the spec through validation, implementation, testing, and readiness to merge. sequenceDiagram participant H as Human Author participant CI as CI Validation @@ -487,10 +475,8 @@ CI quality gates: To avoid premature complexity, agents evolve through stages: ```mermaid ---- accTitle: Agent lifecycle maturity model -accDescr: Simple left-to-right progression showing the five stages of agent maturity โ€” Draft, Prototype, Active, Mature, and Deprecated. ---- +accDescr: Shows the agent lifecycle from draft through prototype, active use, mature stability, and eventual deprecation. flowchart LR Draft --> Prototype --> Active --> Mature --> Deprecated ``` @@ -539,10 +525,8 @@ Example patterns: #### Mermaid: Handoff Example ```mermaid ---- -accTitle: Cross-agent handoff example -accDescr: Simple flowchart showing a labeling agent evaluating conditions and passing control to a reviewer agent when conditions are met, or ending with no handoff when conditions are not met. ---- +accTitle: Agent handoff example +accDescr: Shows how the labeling agent evaluates conditions before handing work to the reviewer agent or stopping the transfer. flowchart TD A[Labeling Agent] --> B{Conditions Met?} B -->|Yes| C[Reviewer Agent] diff --git a/docs/HUSKY_PRECOMMITS.md b/docs/HUSKY_PRECOMMITS.md index 5cac92511..131c36f65 100644 --- a/docs/HUSKY_PRECOMMITS.md +++ b/docs/HUSKY_PRECOMMITS.md @@ -116,6 +116,8 @@ If tests fail, the push is aborted and you must fix the issues before trying aga ## Workflow Overview ```mermaid +accTitle: Husky workflow overview +accDescr: Shows how staged files trigger lint-staged during pre-commit, then tests run during pre-push before code reaches the remote repository. flowchart LR A[Stage Files] --> B[git commit] B --> C{Pre-commit Hook} diff --git a/instructions/automation.instructions.md b/instructions/automation.instructions.md index 1cca23953..0a5feb7d9 100644 --- a/instructions/automation.instructions.md +++ b/instructions/automation.instructions.md @@ -78,6 +78,8 @@ Ensure consistent, reliable, and maintainable automation across GitHub repositor ### System Overview ```mermaid +accTitle: Automation architecture overview +accDescr: Shows how GitHub events trigger workflows, which invoke agents and produce labels, summaries, releases, and metrics. graph TB subgraph "GitHub Events" A[Issue Created] @@ -666,6 +668,8 @@ jobs: ### Automation Pipeline ```mermaid +accTitle: Automation pipeline sequence +accDescr: Shows the end-to-end automation sequence from a GitHub event through workflow execution, agent processing, API updates, and reporting. sequenceDiagram participant Event as GitHub Event participant Workflow as Workflow diff --git a/instructions/documentation-formats.instructions.md b/instructions/documentation-formats.instructions.md index 1448c46bd..a3ec5f435 100644 --- a/instructions/documentation-formats.instructions.md +++ b/instructions/documentation-formats.instructions.md @@ -401,6 +401,8 @@ Mermaid diagrams enhance documentation by visualizing complex relationships, pro #### **Flowchart (Most Common)** ```mermaid +accTitle: Flowchart diagram example +accDescr: Shows a simple decision flowchart with yes and no branches ending in separate actions. flowchart TD A[Start] --> B{Decision?} B -->|Yes| C[Action 1] @@ -414,6 +416,8 @@ flowchart TD #### **Graph (Relationships)** ```mermaid +accTitle: Graph diagram example +accDescr: Shows a relationship graph connecting issues, pull requests, discussions, and releases. graph TB A[Issues] --> B[Pull Requests] A --> C[Discussions] @@ -426,6 +430,8 @@ graph TB #### **Architecture Diagram** ```mermaid +accTitle: Architecture diagram example +accDescr: Shows a repository architecture split into internal repository components and external integration points. graph LR subgraph "Repository" A[Code] --> B[Tests] @@ -446,6 +452,8 @@ graph LR #### **Sequence Diagram** ```mermaid +accTitle: Sequence diagram example +accDescr: Shows a simple request flow from user through GitHub and CI to deployment and back to the user. sequenceDiagram participant User participant GitHub @@ -465,6 +473,8 @@ sequenceDiagram #### **State Diagram** ```mermaid +accTitle: State diagram example +accDescr: Shows a linear issue lifecycle from draft to review, approval, and merge. stateDiagram-v2 [*] --> Draft Draft --> Review: Submit @@ -489,15 +499,19 @@ stateDiagram-v2 **Color Coding:** +Use the approved Mermaid palette for any `style` or `classDef` declaration. Keep fill, text, and stroke colours together so GitHub light and dark rendering stay readable. + ```mermaid +accTitle: Mermaid colour coding example +accDescr: Shows the approved Mermaid palette with explicit fill, text, and stroke values applied to success and error classes. flowchart TD A[Input] --> B[Process] B --> C{Decision} C -->|Success| D[Output] C -->|Error| E[Error Handler] - classDef success fill:#e8f5e8 - classDef error fill:#ffebee + classDef success fill:#dcfce7,color:#14532d,stroke:#14532d + classDef error fill:#fee2e2,color:#7f1d1d,stroke:#b91c1c class D success class E error @@ -530,6 +544,8 @@ flowchart TD The following diagram shows the issue lifecycle: ```mermaid +accTitle: Issue lifecycle example +accDescr: Shows the issue lifecycle from open through in-progress, review, and closed states. stateDiagram-v2 [*] --> Open Open --> InProgress diff --git a/instructions/linting.instructions.md b/instructions/linting.instructions.md index 7643daa95..cc9595bc8 100644 --- a/instructions/linting.instructions.md +++ b/instructions/linting.instructions.md @@ -102,6 +102,8 @@ Validate and enforce linting standards for all supported file types (JS, TS, She ## ๐Ÿ”„ Linting Process Flow ```mermaid +accTitle: Linting process flow +accDescr: Shows the linting workflow from code change through pre-commit hooks, local linting, CI/CD pipeline checks, and merge approval. graph TD A[Code Change] --> B[Pre-commit Hooks] B --> C[Local Linting] @@ -136,6 +138,8 @@ graph TD ## ๐Ÿ› ๏ธ Linting Toolchain ```mermaid +accTitle: Linting toolchain overview +accDescr: Shows how source code feeds into ESLint, PHPCS, Prettier, Stylelint, and Markdownlint before reaching the CI/CD pipeline. graph LR A[Source Code] --> B[ESLint] A --> C[PHPCS] diff --git a/instructions/mermaid.instructions.md b/instructions/mermaid.instructions.md index e8113cba5..d0d3a90f8 100644 --- a/instructions/mermaid.instructions.md +++ b/instructions/mermaid.instructions.md @@ -1,25 +1,25 @@ --- file_type: "instructions" title: "Mermaid Diagram Instructions" -description: "Design, accessibility, colour contrast, and validation standards for all Mermaid diagrams across LightSpeed repositories" +description: "Design, accessibility, colour contrast, and validation standards for Mermaid diagrams across the repository" scope: "repo-local" version: "v2.0" last_updated: "2026-06-18" owners: ["LightSpeed Team"] tags: ["mermaid", "diagrams", "documentation", "a11y", "wcag", "colour-contrast", "visuals", "architecture"] -applyTo: ["**/*.md"] +applyTo: ["**/*.md", "**/*.mdx"] status: "active" --- # Mermaid Diagram Instructions -All Mermaid diagrams must be visually clear, accessible (WCAG 2.2 AA), and consistent. Follow every rule in this file. The validation workflow enforces them automatically on every PR. +All Mermaid diagrams must be clear, accessible, and WCAG 2.2 AA compliant. Follow every rule in this file. The validation workflow enforces the accessibility and syntax rules automatically, and the colour contrast validator enforces the approved palette. --- ## When to Include a Diagram -Include at least one Mermaid diagram in any README or documentation file that describes: +Include a Mermaid diagram when the documentation describes: - A multi-step process or workflow - Component relationships or architecture @@ -44,10 +44,9 @@ accDescr: Single-sentence description for simple diagrams flowchart LR ... ``` - ``` -For complex diagrams use the block form: +For complex diagrams, use the block form: ```text ```mermaid @@ -62,58 +61,57 @@ accDescr { flowchart TD ... ``` - ``` **Rules:** -- `accTitle` is mandatory on every diagram โ€” no exceptions. -- `accDescr` is mandatory on every diagram โ€” no exceptions. + +- `accTitle` is mandatory on every diagram. +- `accDescr` is mandatory on every diagram. - Place the `---` header block first, before `flowchart`, `graph`, `sequenceDiagram`, etc. -- Do not duplicate `accTitle` / `accDescr` as inline attributes after the diagram type line (older style). Use only the header block. +- Do not duplicate `accTitle` / `accDescr` as inline attributes after the diagram type line. --- -## Diagram Types โ€” When to Use Each - -| Type | Use for | Example | -|------|---------|---------| -| `flowchart LR` | Left-to-right pipelines, data flows | CI/CD pipeline, API request flow | -| `flowchart TD` | Top-down hierarchies, decision trees | Component tree, issue triage | -| `sequenceDiagram` | System interactions over time | Auth flow, webhook delivery | -| `stateDiagram-v2` | State machines, lifecycle transitions | Issue status, deployment states | -| `erDiagram` | Data relationships and schema | Database schema, data models | -| `gantt` | Timelines, release schedules | Sprint plan, milestone calendar | -| `pie` | Proportional composition | Label distribution, coverage breakdown | -| `mindmap` | Topic hierarchies and associations | Feature exploration, knowledge maps | +## Diagram Types -**Prefer `flowchart` over `graph`** โ€” `flowchart` is the current Mermaid standard and supports more styling features. Only use `graph` if you need legacy compatibility. +| Type | Use for | +|------|---------| +| `flowchart LR` | Left-to-right pipelines, data flows, and timelines | +| `flowchart TD` | Top-down hierarchies, decision trees, and branching flows | +| `sequenceDiagram` | System interactions over time | +| `stateDiagram-v2` | State machines and lifecycle transitions | +| `erDiagram` | Data relationships and schema | +| `gantt` | Timelines and release schedules | +| `pie` | Proportional composition | +| `mindmap` | Topic hierarchies and associations | -**Always specify direction** โ€” `flowchart LR`, `flowchart TD`, etc. Never leave the direction implicit. +- Prefer `flowchart` over `graph`. +- Always specify direction: `flowchart LR`, `flowchart TD`, etc. --- -## Colour Palette โ€” Approved WCAG AA Pairs +## Colour Palette -Every `style` declaration **must** set `fill`, `color`, and `stroke` together. Never set `fill` alone โ€” Mermaid's theme may override the text colour to white or another low-contrast value depending on the viewer's GitHub theme (light/dark mode). +Every `style` or `classDef` declaration that sets `fill:` **must** also set `color:` and `stroke:` together. -All pairs below are pre-verified to meet **WCAG 2.2 AA 4.5:1** normal-text contrast in every GitHub theme: +The approved palette is: -| Role | `fill` | `color` | `stroke` | Contrast | -|------|--------|---------|----------|----------| -| **Information** (primary, entry points) | `#dbeafe` | `#1e3a5f` | `#1e3a5f` | 9.1:1 | -| **Success** (outputs, completed states) | `#dcfce7` | `#14532d` | `#14532d` | 10.5:1 | -| **Warning** (external dependencies, caution) | `#fef3c7` | `#4a2c00` | `#b45309` | 8.3:1 | -| **Error / Alert** (failure states, blockers) | `#fee2e2` | `#7f1d1d` | `#b91c1c` | 8.7:1 | -| **Documentation** (specs, instructions, AI) | `#f3e8ff` | `#3b0764` | `#7e22ce` | 10.2:1 | -| **Neutral** (supporting nodes, connectors) | `#f1f5f9` | `#0f172a` | `#334155` | 14.7:1 | -| **Highlight** (key actions, automation) | `#ecfdf5` | `#064e3b` | `#059669` | 10.8:1 | +| Role | fill | color | stroke | +|------|------|-------|--------| +| Information | `#dbeafe` | `#1e3a5f` | `#1e3a5f` | +| Success | `#dcfce7` | `#14532d` | `#14532d` | +| Warning | `#fef3c7` | `#4a2c00` | `#b45309` | +| Error / Alert | `#fee2e2` | `#7f1d1d` | `#b91c1c` | +| Documentation | `#f3e8ff` | `#3b0764` | `#7e22ce` | +| Neutral | `#f1f5f9` | `#0f172a` | `#334155` | +| Highlight | `#ecfdf5` | `#064e3b` | `#059669` | -**Usage:** +Example: ```mermaid --- accTitle: Example colour usage -accDescr: Shows the correct way to apply the approved colour palette with explicit fill, color, and stroke. +accDescr: Shows the approved palette applied with explicit fill, color, and stroke values. --- flowchart LR A[Entry Point] --> B[Automation Step] --> C[Output] @@ -124,36 +122,33 @@ flowchart LR **Rules:** -- Only use colours from the approved palette above, or colours you have manually verified using `scripts/validation/validate-mermaid-colour-contrast.js`. -- Never use `fill:#e1f5fe` without `color:#1e3a5f` (the old single-property pattern fails in dark mode). -- Never use inline colour strings not from this palette without running the contrast validator first. -- Do not rely on colour alone to convey meaning โ€” use node shape and label text as the primary communicators. +- Only use colours from the approved palette above, or colours you have manually verified using the Mermaid contrast validator. +- Never use `fill:` without an explicit `color:`. +- Never use theme-specific dark mode values in diagram definitions. +- Do not rely on colour alone to convey meaning. --- ## Theme Initialisation -Include a theme init block only when you have a specific reason. The default theme is correct for nearly all cases: +Use a theme init block only when there is a specific reason. The default theme is correct for nearly all cases: ```text %%{init: {'theme': 'default'}}%% ``` -Do **not** use `theme: 'dark'` in diagram definitions โ€” this forces dark mode regardless of the viewer's system preference and creates contrast problems with the approved palette. - -For subgraph labels on dark backgrounds, prefer changing the subgraph border and title with inline styles rather than switching the whole theme. +- Do **not** use `theme: 'dark'`. +- If a diagram needs extra contrast tuning, keep the approved palette and adjust the node styles, not the viewer theme. --- ## Emoji in Node Labels -Phosphor Icons and other SVG icon sets **cannot** be used in GitHub-rendered Mermaid diagrams. GitHub's embedded renderer does not support the Mermaid v11 `@{ icon: }` syntax. - -Use the following canonical emoji vocabulary for node types. Apply consistently across all diagrams in the repository: +Use at most one emoji per node label. Place it at the start of the label, followed by a space. | Node type | Emoji | Example label | |-----------|-------|---------------| -| Entry / start | (none โ€” use a rounded node shape) | `([Start])` | +| Entry / start | none | `([Start])` | | User / developer | ๐Ÿ‘ค | `[๐Ÿ‘ค Developer]` | | Repository / storage | ๐Ÿ“ | `[๐Ÿ“ Repository]` | | Workflow / automation | โš™๏ธ | `[โš™๏ธ Automation]` | @@ -172,25 +167,17 @@ Use the following canonical emoji vocabulary for node types. Apply consistently | Tests | ๐Ÿงช | `[๐Ÿงช Test Suite]` | | Lock / protected | ๐Ÿ”’ | `[๐Ÿ”’ Protected]` | -**Rules:** - -- Use at most one emoji per node label. -- Place the emoji at the start of the label, followed by a space. -- Never use emoji as the entire label โ€” always include a text description. -- Do not use emoji in subgraph titles where they are not consistently supported. +Never use emoji as the entire label. Keep subgraph titles plain text. --- ## Layout and Clarity -- **One concept per diagram.** If a diagram needs more than ~12 nodes, split it. -- **Direction convention:** - - Left-to-right (`LR`) for linear pipelines, data flows, and timelines. - - Top-down (`TD`) for hierarchies, trees, and decision flows. -- **Label length:** Keep node labels to 3โ€“5 words maximum. -- **Subgraph titles:** Use plain text, no emoji, no special characters. -- **Arrow labels:** Use sparingly โ€” only when the relationship is not obvious from context. -- **Avoid crossing arrows** โ€” rearrange node order to keep flows readable. +- Keep one concept per diagram. +- Split diagrams that grow beyond roughly 12 nodes. +- Use left-to-right (`LR`) for linear flows and top-down (`TD`) for hierarchies and decisions. +- Keep node labels short and descriptive. +- Avoid crossing arrows where possible. --- @@ -199,57 +186,46 @@ Use the following canonical emoji vocabulary for node types. Apply consistently Run before every commit: ```bash -npm run validate:mermaid-syntax # Validates diagram type, direction, bracket matching -npm run validate:mermaid-accessibility # Checks for accTitle and accDescr -npm run validate:mermaid-contrast # WCAG 2.2 AA colour contrast check (new) +npm run validate:mermaid-syntax +npm run validate:mermaid-accessibility +npm run validate:mermaid-contrast ``` -The PR validation workflow (`.github/workflows/validate-mermaid-pr.yml`) runs all three checks automatically on every pull request that modifies `.md` files. A failing contrast check **blocks merge**. - To validate only changed files locally: ```bash -node scripts/validation/validate-mermaid-colour-contrast.js --changed-files=path/to/file.md +npm run validate:mermaid-contrast -- --changed-files=path/to/file.md ``` --- -## Repository-wide Update Process +## Repository-Wide Update Process -When diagrams across the repository need to be updated (new palette, new structural requirements): +When Mermaid diagrams across the repository need a standards refresh: -1. **Open a `chore/` or `docs/` branch** โ€” e.g., `docs/mermaid-colour-standards-v2`. -2. **Run the fixer script** to apply approved palette colours to all existing style declarations: +1. Open a `docs/` or `chore/` branch. +2. Run the fixer script: ```bash node scripts/fix-mermaid-diagrams.js ``` -3. **Run all three validators** to confirm no regressions: +3. Run the full Mermaid suite: ```bash npm run validate:mermaid-syntax && npm run validate:mermaid-accessibility && npm run validate:mermaid-contrast ``` -4. **Open a PR targeting `develop`** with a description that lists all files changed. -5. The CI workflow will re-validate on the PR โ€” review any residual findings. - ---- - -## Testing and Rendering - -- Test all diagrams in the [Mermaid Live Editor](https://mermaid.live/) before committing. -- Check both GitHub light mode and dark mode rendering in the GitHub preview. -- Confirm mobile rendering is readable (diagrams should not require horizontal scroll on a 375px viewport). -- Provide a plain-text alternative directly below any diagram that contains more than 7 nodes or represents a critical process. +4. Review the diff and keep content accurate to the current repository structure. +5. Open a PR targeting `develop`. --- ## Related Files -- [documentation-formats.instructions.md](./documentation-formats.instructions.md) โ€” Markdown and diagram standards -- [a11y.instructions.md](./a11y.instructions.md) โ€” WCAG 2.2 AA accessibility standards -- [scripts/validation/validate-mermaid-colour-contrast.js](../scripts/validation/validate-mermaid-colour-contrast.js) โ€” Colour contrast validator -- [scripts/validation/validate-mermaid-accessibility.js](../scripts/validation/validate-mermaid-accessibility.js) โ€” accTitle/accDescr validator -- [scripts/validation/validate-mermaid-syntax.js](../scripts/validation/validate-mermaid-syntax.js) โ€” Syntax validator -- [.github/workflows/validate-mermaid-pr.yml](../.github/workflows/validate-mermaid-pr.yml) โ€” PR validation workflow +- [documentation-formats.instructions.md](./documentation-formats.instructions.md) - Markdown, frontmatter, and Mermaid standards +- [a11y.instructions.md](./a11y.instructions.md) - Accessibility standards +- [scripts/validation/validate-mermaid-accessibility.js](../scripts/validation/validate-mermaid-accessibility.js) - accTitle / accDescr validator +- [scripts/validation/validate-mermaid-colour-contrast.js](../scripts/validation/validate-mermaid-colour-contrast.js) - Colour contrast validator +- [.github/workflows/readme-audit.yml](../.github/workflows/readme-audit.yml) - Audit workflow +- [.github/workflows/readme-update.yml](../.github/workflows/readme-update.yml) - Update workflow diff --git a/instructions/quality-assurance.instructions.md b/instructions/quality-assurance.instructions.md index 3727fe18e..f4cbffc48 100644 --- a/instructions/quality-assurance.instructions.md +++ b/instructions/quality-assurance.instructions.md @@ -74,16 +74,20 @@ Applies to testing and QA across code, automation, and workflows. Covers strateg ### Testing Pyramid +When you show the pyramid in Mermaid, use the approved Mermaid palette from `instructions/mermaid.instructions.md` and set `fill`, `color`, and `stroke` together in every `classDef`. + ```mermaid +accTitle: Testing pyramid diagram +accDescr: Shows the testing pyramid from end-to-end tests through integration and unit tests to static analysis. graph TD A[E2E Tests
User Workflows] --> B[Integration Tests
Component Interaction] B --> C[Unit Tests
Pure Functions & Logic] C --> D[Static Analysis
Linting & Type Checking] - classDef e2e fill:#ffebee - classDef integration fill:#fff3e0 - classDef unit fill:#e8f5e8 - classDef static fill:#e1f5fe + classDef e2e fill:#fee2e2,color:#7f1d1d,stroke:#b91c1c + classDef integration fill:#fef3c7,color:#4a2c00,stroke:#b45309 + classDef unit fill:#dcfce7,color:#14532d,stroke:#14532d + classDef static fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f class A e2e class B integration @@ -370,6 +374,8 @@ describe("Issue Lifecycle E2E", () => { ### Test Execution Flow ```mermaid +accTitle: Test execution flow +accDescr: Shows how a developer runs tests locally, pushes changes, and then CI executes linting, tests, coverage, and quality gate checks. sequenceDiagram participant Dev as Developer participant Local as Local Tests diff --git a/package.json b/package.json index ccc7b2aa4..616b4a37a 100644 --- a/package.json +++ b/package.json @@ -110,8 +110,7 @@ "validate:readme-links": "node scripts/validation/validate-readme-links.js", "validate:wceu:phase1": "node scripts/verify-wceu-readiness.js", "validate:wceu:phase2": "node scripts/validate-phase2-completion.js", - "validate:all": "npm run validate:branch-name && npm run validate:structure && npm run validate:skill-manifests && npm run validate:plugins && npm run validate:links && npm run validate:frontmatter && npm run validate:agents && npm run validate:issue-fields && npm run validate:workflows && npm run validate:memory && npm run validate:json:all", - "validate:all": "npm run validate:structure && npm run validate:skill-manifests && npm run validate:plugins && npm run validate:links && npm run validate:frontmatter && npm run validate:agents && npm run validate:labeling-configs && npm run validate:retired-doc-links && npm run validate:issue-fields && npm run validate:workflows && npm run validate:memory && npm run validate:json:all", + "validate:all": "npm run validate:branch-name && npm run validate:structure && npm run validate:skill-manifests && npm run validate:plugins && npm run validate:links && npm run validate:frontmatter && npm run validate:agents && npm run validate:issue-fields && npm run validate:workflows && npm run validate:memory && npm run validate:mermaid && npm run validate:json:all", "eslint:delta:wave-1": "node scripts/compute-eslint-delta-wave-1.js", "sync-version": "node scripts/sync-version.js", "metrics:run": "node metrics/frontmatter-metrics.js", diff --git a/profile/README.md b/profile/README.md index 7b54af6e7..43c682579 100644 --- a/profile/README.md +++ b/profile/README.md @@ -2,9 +2,9 @@ file_type: documentation title: LightSpeed WordPress Development Agency - GitHub Profile description: Welcome to LightSpeed's GitHub Organization - WordPress design and development agency creating powerful, open-source solutions for the WordPress ecosystem since 2003 -version: v2.2 +version: v2.1 created_date: '2025-10-20' -last_updated: '2026-06-18' +last_updated: '2026-05-29' maintainer: LightSpeed Team authors: - LightSpeed Team @@ -23,7 +23,7 @@ owners: [![Since 2003](https://img.shields.io/badge/Since-2003-blue)](https://lightspeedwp.agency/about) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Community](https://img.shields.io/badge/Community-Driven-success)](https://github.com/orgs/lightspeedwp/discussions) -[![AI Enhanced](https://img.shields.io/badge/AI-Enhanced-purple)](../.github/custom-instructions.md) +[![AI Enhanced](https://img.shields.io/badge/AI-Enhanced-purple)](./.github/custom-instructions.md) ## ๐Ÿ‘‹ Welcome to LightSpeed's GitHub Organization @@ -32,11 +32,9 @@ We're a **WordPress design and development agency** with a focus on creating pow ### ๐Ÿ›๏ธ Organization Overview ```mermaid ---- -accTitle: LightSpeed organization structure and products -accDescr: Organization overview showing LightSpeed agency team, core products including LSX Design theme and Tour Operator plugin, and open source commitment with community support and documentation. ---- flowchart LR +accTitle: "LightSpeed organization structure and products" +accDescr: "Organization overview showing LightSpeed agency team, core products including LSX Design theme and Tour Operator plugin, and open source commitment with community support and documentation." subgraph "๐Ÿข LightSpeed Agency" A[๐Ÿ‘ฅ Team Since 2003] B[๐ŸŽฏ WordPress Experts] @@ -95,11 +93,9 @@ We believe in the power of community and open-source collaboration! If you're pa ### ๐Ÿ”„ Contribution Process Flow ```mermaid ---- -accTitle: LightSpeed community contribution process -accDescr: Complete contribution workflow from starting point through issue submission, feature requests, code contributions, documentation improvements, team triage, code review, merge and deployment, with feedback loop for requested changes. ---- flowchart TD +accTitle: "LightSpeed community contribution process" +accDescr: "Complete contribution workflow from starting point through issue submission, feature requests, code contributions, documentation improvements, team triage, code review, merge and deployment, with feedback loop for requested changes." A[๐Ÿš€ Start Here] --> B{What do you want to do?} B -->|๐Ÿ› Report Issue| C[๐Ÿ“ Submit Issue] @@ -149,11 +145,9 @@ At LightSpeed, we believe in the power of open-source software. We contribute to ### ๐Ÿ—๏ธ Project Architecture & Integration ```mermaid ---- -accTitle: LightSpeed project architecture and ecosystem -accDescr: Comprehensive architecture showing frontend solutions with LSX Design and custom blocks, backend functionality including Tour Operator plugin and WooCommerce extensions, developer tools with CI/CD workflows, documentation and community support forums. ---- -flowchart TD +graph TB +accTitle: "LightSpeed project architecture and ecosystem" +accDescr: "Comprehensive architecture showing frontend solutions with LSX Design and custom blocks, backend functionality including Tour Operator plugin and WooCommerce extensions, developer tools with CI/CD workflows, documentation and community support forums." subgraph "๐ŸŽจ Frontend Solutions" A[LSX Design Theme] B[Block Patterns] @@ -204,7 +198,7 @@ flowchart TD style D fill:#f3e8ff,color:#3b0764,stroke:#7e22ce style G fill:#fef3c7,color:#4a2c00,stroke:#b45309 style J fill:#dcfce7,color:#14532d,stroke:#14532d - style M fill:#fee2e2,color:#7f1d1d,stroke:#b91c1c + style M fill:#f3e8ff,color:#3b0764,stroke:#7e22ce ``` ### [LSX Design](https://lsx.design) @@ -228,11 +222,9 @@ We welcome contributions from the community! If you're interested in collaborati ### ๐Ÿค Community Engagement Lifecycle ```mermaid ---- -accTitle: Community engagement and contribution lifecycle -accDescr: State machine showing the journey from discovering projects through exploration, engagement, contributions, collaboration, leadership, and mentorship with feedback loops for continuous community participation. ---- stateDiagram-v2 +accTitle: "Community engagement and contribution lifecycle" +accDescr: "State machine showing the journey from discovering projects through exploration, engagement, contributions, collaboration, leadership, and mentorship with feedback loops for continuous community participation." [*] --> Discover Discover --> Explore Explore --> Engage diff --git a/scripts/README.md b/scripts/README.md index d65c6bfea..508a18deb 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -2,8 +2,8 @@ title: "LightSpeedWP Scripts & Automation" description: "Comprehensive automation scripts, utilities, and maintenance tools for LightSpeedWP projects. Modular design with shared infrastructure and extensive testing." file_type: documentation -version: "2.7" -last_updated: "2026-06-18" +version: "2.6" +last_updated: "2026-06-01" created_date: "2025-12-04" owners: - LightSpeedWP Team @@ -29,11 +29,9 @@ This directory contains all automation, utility, and maintenance scripts for the ## Scripts Architecture ```mermaid ---- -accTitle: Scripts and automation directory architecture -accDescr: Shows the hierarchical structure of scripts directory including awesome-copilot, includes, validation, maintenance, and projects folders with their core utilities, test helpers, and integrations with GitHub Actions and CI/CD pipeline. ---- -flowchart TD +graph TB +accTitle: "Scripts and automation directory architecture" +accDescr: "Shows the hierarchical structure of scripts directory including awesome-copilot, includes, validation, maintenance, and projects folders with their core utilities, test helpers, and integrations with GitHub Actions and CI/CD pipeline." A[Scripts Directory] --> B[awesome-copilot/] A --> V[audit/] A --> C[includes/] @@ -68,11 +66,9 @@ flowchart TD ## Automation Workflow ```mermaid ---- -accTitle: Scripts and automation workflow sequence -accDescr: Sequential flow showing developer executing scripts, loading utilities, validating inputs, performing operations, running tests, triggering CI/CD workflows, and deployment with completion notification. ---- sequenceDiagram +accTitle: "Scripts and automation workflow sequence" +accDescr: "Sequential flow showing developer executing scripts, loading utilities, validating inputs, performing operations, running tests, triggering CI/CD workflows, and deployment with completion notification." participant Dev as Developer participant Scripts as Scripts System participant Tests as Test Suite @@ -403,11 +399,9 @@ Refer to `../CHANGELOG.md` for release context and automation evolution. ## Script Execution Flow ```mermaid ---- -accTitle: Script execution flow and lifecycle -accDescr: Detailed flowchart showing script execution lifecycle from dependency checking, includes loading, CLI argument parsing, input validation, main logic execution, test running, and exit handling with error and success paths. ---- flowchart TD +accTitle: "Script execution flow and lifecycle" +accDescr: "Detailed flowchart showing script execution lifecycle from dependency checking, includes loading, CLI argument parsing, input validation, main logic execution, test running, and exit handling with error and success paths." A[Script Execution] --> B{Check Dependencies} B -->|Missing| C[Install Dependencies] B -->|Available| D[Load Includes] @@ -426,7 +420,7 @@ flowchart TD style A fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f style I fill:#dcfce7,color:#14532d,stroke:#14532d - style O fill:#ecfdf5,color:#064e3b,stroke:#059669 + style O fill:#dcfce7,color:#14532d,stroke:#14532d style N fill:#fee2e2,color:#7f1d1d,stroke:#b91c1c ``` @@ -456,7 +450,7 @@ When contributing new scripts or modifications: - [GitHub Actions Workflows](../.github/workflows/) - [Schema Definitions](../schema/) -- [Test Coverage Reports](../tests/README.md) +- [Test Coverage Reports](../tests/TEST_COVERAGE_SUMMARY.md) - [Contributing Guidelines](../CONTRIBUTING.md) ## AI & Automation References diff --git a/scripts/fix-mermaid-diagrams.js b/scripts/fix-mermaid-diagrams.js index 50228d43c..ce973f17b 100644 --- a/scripts/fix-mermaid-diagrams.js +++ b/scripts/fix-mermaid-diagrams.js @@ -1,32 +1,146 @@ const fs = require("fs"); const path = require("path"); -function findReadmeFiles(dir = ".") { +const PALETTE = { + information: { + fill: "#dbeafe", + color: "#1e3a5f", + stroke: "#1e3a5f", + }, + success: { + fill: "#dcfce7", + color: "#14532d", + stroke: "#14532d", + }, + warning: { + fill: "#fef3c7", + color: "#4a2c00", + stroke: "#b45309", + }, + error: { + fill: "#fee2e2", + color: "#7f1d1d", + stroke: "#b91c1c", + }, + documentation: { + fill: "#f3e8ff", + color: "#3b0764", + stroke: "#7e22ce", + }, + neutral: { + fill: "#f1f5f9", + color: "#0f172a", + stroke: "#334155", + }, + highlight: { + fill: "#ecfdf5", + color: "#064e3b", + stroke: "#059669", + }, +}; + +const FILL_TO_ROLE = new Map([ + ["#dbeafe", "information"], + ["#e1f5fe", "information"], + ["#d9f2ff", "information"], + ["#e0f2fe", "information"], + ["#bae6fd", "information"], + ["#c7d2fe", "information"], + ["#dcfce7", "success"], + ["#e8f5e8", "success"], + ["#d1fae5", "success"], + ["#c8e6c9", "success"], + ["#ecfccb", "success"], + ["#fef3c7", "warning"], + ["#fff3e0", "warning"], + ["#fee2e2", "error"], + ["#ffebee", "error"], + ["#ffcdd2", "error"], + ["#ffe4e6", "error"], + ["#f3e8ff", "documentation"], + ["#f3e5f5", "documentation"], + ["#fce4ec", "documentation"], + ["#e2e8f0", "neutral"], + ["#f1f5f9", "neutral"], + ["#ecfdf5", "highlight"], +]); + +function findMarkdownFiles(dir = ".") { const files = []; const entries = fs.readdirSync(dir, { withFileTypes: true }); for (const entry of entries) { - if (entry.isDirectory() && !entry.name.startsWith(".")) { - files.push(...findReadmeFiles(path.join(dir, entry.name))); - } else if (entry.name === "README.md" && entry.isFile()) { + if (entry.isDirectory()) { + if (entry.name === "node_modules" || entry.name === ".git") continue; + files.push(...findMarkdownFiles(path.join(dir, entry.name))); + continue; + } + + if (entry.isFile() && /\.(md|mdx)$/i.test(entry.name)) { files.push(path.join(dir, entry.name)); } } + return files; } -const readmes = findReadmeFiles(); +function rewriteColourDeclaration(line) { + const match = line.match(/^(\s*)(style|classDef)\s+(\S+)\s+(.+)$/); + if (!match) return line; + + const [, indent, keyword, target, props] = match; + const fillMatch = props.match(/(? { +markdownFiles.forEach((file) => { let content = fs.readFileSync(file, "utf-8"); let modified = false; - // Fix Mermaid diagram formatting and add accessibility content = content.replace(/```mermaid([^]*?)```/g, (match, diagram) => { - // Add accTitle if missing - if (!diagram.includes("accTitle:") && diagram.trim()) { - const firstLine = diagram.trim().split("\n")[0]; + let nextDiagram = diagram.trim(); + if (!nextDiagram) return match; + + if (!nextDiagram.includes("accTitle:")) { + const firstLine = nextDiagram.split("\n")[0]; if (firstLine && !firstLine.startsWith("--")) { const diagType = firstLine.toLowerCase(); let title = "Diagram"; @@ -35,22 +149,26 @@ readmes.forEach((file) => { if (diagType.includes("sequence")) title = "Sequence Diagram"; if (diagType.includes("gantt")) title = "Gantt Chart"; + nextDiagram = `accTitle: ${title}\n${nextDiagram}`; modified = true; - return ( - "```mermaid\naccTitle: " + title + "\n" + diagram.trim() + "\n```" - ); } } - // Add accDescr if missing - if (!diagram.includes("accDescr:")) { + if (!nextDiagram.includes("accDescr:")) { + nextDiagram = `${nextDiagram}\naccDescr: Detailed diagram`; modified = true; - return ( - "```mermaid\n" + diagram.trim() + "\naccDescr: Detailed diagram\n```" - ); } - return match; + nextDiagram = nextDiagram + .split("\n") + .map((line) => { + const rewritten = rewriteColourDeclaration(line); + if (rewritten !== line) modified = true; + return rewritten; + }) + .join("\n"); + + return `\`\`\`mermaid\n${nextDiagram}\n\`\`\``; }); if (modified) { diff --git a/scripts/validation/validate-mermaid-accessibility.js b/scripts/validation/validate-mermaid-accessibility.js index 92b7b1d65..9470c1c7f 100644 --- a/scripts/validation/validate-mermaid-accessibility.js +++ b/scripts/validation/validate-mermaid-accessibility.js @@ -1,6 +1,6 @@ #!/usr/bin/env node /** - * Validate Mermaid diagram accessibility compliance in all README files + * Validate Mermaid diagram accessibility compliance in all markdown files * Checks for presence of accTitle and accDescr attributes * @module scripts/validation/validate-mermaid-accessibility.js */ @@ -13,9 +13,15 @@ import { globSync } from "glob"; const __dirname = path.dirname(fileURLToPath(import.meta.url)); const ROOT = path.join(__dirname, "../../"); -const README_FILES = globSync("**/README.md", { +const MARKDOWN_FILES = globSync("**/*.{md,mdx}", { cwd: ROOT, - ignore: ["**/node_modules/**", "**/.git/**", "**/coverage/**", "**/logs/**"], + ignore: [ + "**/node_modules/**", + "**/.git/**", + "**/coverage/**", + "**/logs/**", + "**/.github/projects/**", + ], dot: true, }).sort(); @@ -41,6 +47,7 @@ function getDiagramType(content) { "erDiagram", "gantt", "pie", + "mindmap", ]; const lines = content.split("\n"); @@ -126,10 +133,10 @@ async function main() { }; const csvRows = [ - "README,Diagram Number,Diagram Type,Has accTitle,Has accDescr,Missing Attributes,Compliance Status", + "File,Diagram Number,Diagram Type,Has accTitle,Has accDescr,Missing Attributes,Compliance Status", ]; - for (const file of README_FILES) { + for (const file of MARKDOWN_FILES) { const filePath = path.join(ROOT, file); if (!fs.existsSync(filePath)) { @@ -263,7 +270,7 @@ stability: stable ## Files Analyzed -${README_FILES.map((f) => `- ${f}`).join("\n")} +${MARKDOWN_FILES.map((f) => `- ${f}`).join("\n")} ## Compliance Criteria diff --git a/scripts/validation/validate-mermaid-colour-contrast.js b/scripts/validation/validate-mermaid-colour-contrast.js index cfcab5dbe..9a2e9578d 100644 --- a/scripts/validation/validate-mermaid-colour-contrast.js +++ b/scripts/validation/validate-mermaid-colour-contrast.js @@ -2,13 +2,14 @@ /** * Validate WCAG 2.2 AA colour contrast compliance in Mermaid diagrams. * - * Checks every `style X fill:#colour` declaration and verifies: + * Checks every `style X fill:#colour` and `classDef X fill:#colour` + * declaration and verifies: * 1. An explicit `color` (text colour) is set alongside each `fill`. - * 2. The fill/color pair meets the WCAG AA minimum contrast ratio of 4.5:1. + * 2. The fill / color pair meets the WCAG AA minimum contrast ratio of 4.5:1. * - * Scans all .md files (not just READMEs) to cover instructions, docs, etc. + * Scans all markdown files so repository-wide Mermaid diagrams are covered. * - * @module scripts/validation/validate-mermaid-colour-contrast + * @module scripts/validation/validate-mermaid-colour-contrast.js */ import fs from "fs"; @@ -20,21 +21,9 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url)); const ROOT = path.join(__dirname, "../../"); const WCAG_AA_NORMAL_TEXT = 4.5; -const WCAG_AA_LARGE_TEXT = 3.0; - -// Mermaid default text colours per theme (approximations). -// When no explicit `color` is set, the renderer uses these. -const MERMAID_THEME_TEXT_DEFAULTS = { - default: "#333333", - base: "#333333", - neutral: "#333333", - dark: "#ffffff", // dark mode renders white text โ€” this is the failure case - forest: "#333333", - "high-contrast": "#000000", -}; - -const getMarkdownFiles = () => { - return globSync("**/*.{md,mdx}", { + +const getMarkdownFiles = () => + globSync("**/*.{md,mdx}", { cwd: ROOT, ignore: [ "**/node_modules/**", @@ -43,18 +32,9 @@ const getMarkdownFiles = () => { "**/logs/**", "**/.github/projects/**", ], + dot: true, }).sort(); -}; - -// --------------------------------------------------------------------------- -// Colour utilities -// --------------------------------------------------------------------------- -/** - * Expand 3-digit hex to 6-digit. - * @param {string} hex - * @returns {string} 6-digit hex without leading # - */ function normaliseHex(hex) { const h = hex.replace(/^#/, ""); if (h.length === 3) { @@ -66,11 +46,6 @@ function normaliseHex(hex) { return h; } -/** - * Convert a hex colour to WCAG relative luminance. - * @param {string} hex e.g. "#e1f5fe" or "#fff" - * @returns {number} - */ function relativeLuminance(hex) { const h = normaliseHex(hex); const r = parseInt(h.slice(0, 2), 16) / 255; @@ -78,17 +53,11 @@ function relativeLuminance(hex) { const b = parseInt(h.slice(4, 6), 16) / 255; const linearise = (c) => - c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4); + c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4; return 0.2126 * linearise(r) + 0.7152 * linearise(g) + 0.0722 * linearise(b); } -/** - * WCAG contrast ratio between two hex colours. - * @param {string} hex1 - * @param {string} hex2 - * @returns {number} - */ function contrastRatio(hex1, hex2) { const l1 = relativeLuminance(hex1); const l2 = relativeLuminance(hex2); @@ -97,12 +66,6 @@ function contrastRatio(hex1, hex2) { return (lighter + 0.05) / (darker + 0.05); } -/** - * Attempt to resolve a named CSS colour to hex. Covers the subset most likely - * to appear in Mermaid style declarations. - * @param {string} name - * @returns {string|null} - */ function namedColourToHex(name) { const map = { black: "#000000", @@ -136,12 +99,6 @@ function namedColourToHex(name) { return map[name.toLowerCase()] ?? null; } -/** - * Parse a colour string (hex or named) to hex. - * Returns null when the colour cannot be resolved (e.g. CSS vars, gradients). - * @param {string} colour - * @returns {string|null} - */ function parseColour(colour) { if (!colour) return null; const trimmed = colour.trim().toLowerCase(); @@ -149,15 +106,6 @@ function parseColour(colour) { return namedColourToHex(trimmed); } -// --------------------------------------------------------------------------- -// Diagram extraction & parsing -// --------------------------------------------------------------------------- - -/** - * Extract raw mermaid diagram blocks from markdown content. - * @param {string} content - * @returns {Array<{raw: string, startLine: number}>} - */ function extractDiagrams(content) { const diagrams = []; const lines = content.split("\n"); @@ -183,11 +131,6 @@ function extractDiagrams(content) { return diagrams; } -/** - * Detect the active theme from a diagram's %%{init:...}%% block. - * @param {string} diagramRaw - * @returns {string} - */ function detectTheme(diagramRaw) { const match = diagramRaw.match(/%%\{.*?'theme'\s*:\s*'([^']+)'/); if (match) return match[1].toLowerCase(); @@ -196,85 +139,60 @@ function detectTheme(diagramRaw) { return "default"; } -/** - * Parse all style declarations from a diagram. - * Handles: - * style NodeId fill:#colour - * style NodeId fill:#colour,color:#colour,stroke:#colour - * style NodeId fill:#colour,color:#colour - * - * @param {string} diagramRaw - * @returns {Array<{nodeId: string, fill: string|null, color: string|null, raw: string, line: number}>} - */ -function parseStyleDeclarations(diagramRaw) { +function parseDeclarations(diagramRaw) { const results = []; const lines = diagramRaw.split("\n"); for (let i = 0; i < lines.length; i++) { const line = lines[i]; - // Match `style ` - const styleMatch = line.match(/^\s*style\s+(\S+)\s+(.+)/); - if (!styleMatch) continue; + const match = line.match(/^\s*(style|classDef)\s+(\S+)\s+(.+)/); + if (!match) continue; - const nodeId = styleMatch[1]; - const props = styleMatch[2]; - - // Extract fill colour โ€” negative lookbehind avoids matching stop-fill or similar + const kind = match[1]; + const nodeId = match[2]; + const props = match[3]; const fillMatch = props.match(/(?} - */ -function validateStyleContrast(styleDecl, theme) { +function validateDeclaration(styleDecl) { const issues = []; - const { nodeId, fill, color } = styleDecl; + const { kind, nodeId, fill, color } = styleDecl; if (!fill) return issues; const fillHex = parseColour(fill); - if (!fillHex) { - // Cannot validate non-hex / CSS variable fills โ€” skip silently - return issues; - } + if (!fillHex) return issues; if (!color) { - // Check both Mermaid light default (#333333) and dark mode (white #ffffff) const lightRatio = contrastRatio(fillHex, "#333333"); const darkRatio = contrastRatio(fillHex, "#ffffff"); const failsLight = lightRatio < WCAG_AA_NORMAL_TEXT; const failsDark = darkRatio < WCAG_AA_NORMAL_TEXT; if (failsLight || failsDark) { - let failMode; - if (failsLight && failsDark) { - failMode = "both light and dark modes"; - } else if (failsLight) { - failMode = "light mode (dark text)"; - } else { - failMode = "dark mode (white text)"; - } + const failMode = + failsLight && failsDark + ? "both light and dark modes" + : failsLight + ? "light mode (dark text)" + : "dark mode (white text)"; issues.push({ level: "error", message: - `Node "${nodeId}": fill ${fill} without explicit color FAILS in ${failMode} ` + + `${kind} "${nodeId}": fill ${fill} without explicit color FAILS in ${failMode} ` + `(light contrast: ${lightRatio.toFixed(2)}:1, dark contrast: ${darkRatio.toFixed(2)}:1). ` + `Add an explicit color: to guarantee contrast.`, }); @@ -282,7 +200,7 @@ function validateStyleContrast(styleDecl, theme) { issues.push({ level: "warning", message: - `Node "${nodeId}": fill ${fill} has no explicit color. ` + + `${kind} "${nodeId}": fill ${fill} has no explicit color. ` + `Passes contrast in both modes (light: ${lightRatio.toFixed(2)}:1, dark: ${darkRatio.toFixed(2)}:1) ` + `but adding an explicit color: is strongly recommended.`, }); @@ -299,7 +217,7 @@ function validateStyleContrast(styleDecl, theme) { issues.push({ level: "error", message: - `Node "${nodeId}": fill ${fill} / color ${color} contrast ratio is ${ratio.toFixed(2)}:1 โ€” ` + + `${kind} "${nodeId}": fill ${fill} / color ${color} contrast ratio is ${ratio.toFixed(2)}:1 โ€” ` + `FAILS WCAG AA 2.2 (${WCAG_AA_NORMAL_TEXT}:1 required for normal text).`, }); } @@ -307,10 +225,6 @@ function validateStyleContrast(styleDecl, theme) { return issues; } -// --------------------------------------------------------------------------- -// Main -// --------------------------------------------------------------------------- - async function main() { const args = process.argv.slice(2); const changedFilesArg = args.find((a) => a.startsWith("--changed-files=")); @@ -324,7 +238,7 @@ async function main() { const report = { filesScanned: 0, diagramsScanned: 0, - stylesChecked: 0, + declarationsChecked: 0, errors: 0, warnings: 0, findings: [], @@ -348,17 +262,17 @@ async function main() { report.diagramsScanned++; const theme = detectTheme(diagram.raw); - const styles = parseStyleDeclarations(diagram.raw); + const declarations = parseDeclarations(diagram.raw); - for (const style of styles) { - report.stylesChecked++; - const issues = validateStyleContrast(style, theme); + for (const decl of declarations) { + report.declarationsChecked++; + const issues = validateDeclaration(decl); for (const issue of issues) { if (issue.level === "error") report.errors++; else report.warnings++; - const fileLine = diagram.startLine + style.line + 1; + const fileLine = diagram.startLine + decl.line + 1; report.findings.push({ file: relPath, diagramIndex: di + 1, @@ -366,7 +280,7 @@ async function main() { theme, level: issue.level, message: issue.message, - rawStyle: style.raw, + rawDeclaration: decl.raw, }); if (!fileHasIssues) { @@ -383,29 +297,27 @@ async function main() { } if (!fileHasIssues && diagrams.length > 0) { - console.log( - `โœ… ${relPath} โ€” ${diagrams.length} diagram(s), all styles pass`, - ); + console.log(`โœ… ${relPath} โ€” ${diagrams.length} diagram(s), all styles pass`); } } console.log("\n" + "=".repeat(70)); console.log("๐ŸŽจ COLOUR CONTRAST SUMMARY"); console.log("=".repeat(70)); - console.log(`Files scanned: ${report.filesScanned}`); - console.log(`Diagrams scanned: ${report.diagramsScanned}`); - console.log(`Styles checked: ${report.stylesChecked}`); - console.log(`Errors: ${report.errors}`); - console.log(`Warnings: ${report.warnings}`); + console.log(`Files scanned: ${report.filesScanned}`); + console.log(`Diagrams scanned: ${report.diagramsScanned}`); + console.log(`Declarations checked: ${report.declarationsChecked}`); + console.log(`Errors: ${report.errors}`); + console.log(`Warnings: ${report.warnings}`); if (report.findings.length > 0) { console.log("\n๐Ÿ“‹ FINDINGS:"); - for (const f of report.findings) { + for (const finding of report.findings) { console.log( - `\n ${f.level.toUpperCase()} in ${f.file} (Diagram #${f.diagramIndex}, theme: ${f.theme})`, + `\n ${finding.level.toUpperCase()} in ${finding.file} (Diagram #${finding.diagramIndex}, theme: ${finding.theme})`, ); - console.log(` Style: ${f.rawStyle}`); - console.log(` Issue: ${f.message}`); + console.log(` Declaration: ${finding.rawDeclaration}`); + console.log(` Issue: ${finding.message}`); } } @@ -418,12 +330,9 @@ async function main() { `\nโš ๏ธ ${report.warnings} warning(s). Add explicit color: to every fill: declaration to guarantee contrast in all themes.`, ); } else { - console.log( - "\nโœ… All style declarations meet WCAG 2.2 AA contrast requirements.", - ); + console.log("\nโœ… All style declarations meet WCAG 2.2 AA contrast requirements."); } - // Write report const reportDir = path.join(ROOT, ".github/reports/mermaid"); fs.mkdirSync(reportDir, { recursive: true }); const today = new Date().toISOString().slice(0, 10); @@ -450,7 +359,7 @@ stability: stable |--------|-------| | Files scanned | ${report.filesScanned} | | Diagrams scanned | ${report.diagramsScanned} | -| Style declarations checked | ${report.stylesChecked} | +| Declarations checked | ${report.declarationsChecked} | | Errors (contrast failures) | ${report.errors} | | Warnings (missing explicit color) | ${report.warnings} | @@ -461,11 +370,11 @@ ${ ? "โœ… All style declarations meet WCAG 2.2 AA requirements." : report.findings .map( - (f) => - `### ${f.level.toUpperCase()}: \`${f.file}\` โ€” Diagram #${f.diagramIndex} (line ${f.line})\n\n` + - `- **Theme**: ${f.theme}\n` + - `- **Style**: \`${f.rawStyle}\`\n` + - `- **Issue**: ${f.message}\n`, + (finding) => + `### ${finding.level.toUpperCase()}: \`${finding.file}\` โ€” Diagram #${finding.diagramIndex} (line ${finding.line})\n\n` + + `- **Theme**: ${finding.theme}\n` + + `- **Declaration**: \`${finding.rawDeclaration}\`\n` + + `- **Issue**: ${finding.message}\n`, ) .join("\n") } diff --git a/scripts/validation/validate-mermaid-syntax.js b/scripts/validation/validate-mermaid-syntax.js index 54c577bdd..b80508294 100644 --- a/scripts/validation/validate-mermaid-syntax.js +++ b/scripts/validation/validate-mermaid-syntax.js @@ -1,6 +1,6 @@ #!/usr/bin/env node /** - * Validate Mermaid diagram syntax in all README files + * Validate Mermaid diagram syntax in all markdown files * Using pattern-based validation (no DOM required) * @module scripts/validation/validate-mermaid-syntax.js */ @@ -13,9 +13,15 @@ import { globSync } from "glob"; const __dirname = path.dirname(fileURLToPath(import.meta.url)); const ROOT = path.join(__dirname, "../../"); -const README_FILES = globSync("**/README.md", { +const MARKDOWN_FILES = globSync("**/*.{md,mdx}", { cwd: ROOT, - ignore: ["**/node_modules/**", "**/.git/**", "**/coverage/**", "**/logs/**"], + ignore: [ + "**/node_modules/**", + "**/.git/**", + "**/coverage/**", + "**/logs/**", + "**/.github/projects/**", + ], }).sort(); // Mermaid syntax validation patterns @@ -27,6 +33,7 @@ const DIAGRAM_TYPES = { erDiagram: /^\s*erDiagram\b/m, gantt: /^\s*gantt\b/m, pie: /^\s*pie\b/m, + mindmap: /^\s*mindmap\b/m, }; function extractMermaidDiagrams(content) { @@ -51,6 +58,7 @@ function getDiagramType(content) { "erDiagram", "gantt", "pie", + "mindmap", ]; const lines = content.split("\n"); @@ -179,7 +187,7 @@ async function main() { errors: [], }; - for (const file of README_FILES) { + for (const file of MARKDOWN_FILES) { const filePath = path.join(ROOT, file); if (!fs.existsSync(filePath)) { @@ -269,7 +277,7 @@ stability: stable - **Success rate**: ${(report.totalDiagrams === 0 ? 100 : (report.validDiagrams / report.totalDiagrams) * 100).toFixed(1)}% ## Files Analyzed -${README_FILES.map((f) => `- ${f}`).join("\n")} +${MARKDOWN_FILES.map((f) => `- ${f}`).join("\n")} ## Detailed Results From 52fbc6a3d3cd5e34f7bdbcc58a16cecbdd14cdf6 Mon Sep 17 00:00:00 2001 From: Ash Shaw Date: Thu, 18 Jun 2026 17:37:00 +0200 Subject: [PATCH 2/5] docs: add mermaid sweep changelog --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index b692a9119..f2bffca2c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -33,6 +33,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Fixed +- **Repository-wide Mermaid accessibility and contrast coverage** โ€” Added `accTitle` and `accDescr` to every Mermaid diagram in the repository, updated the Mermaid prompt/instructions/workflows to enforce the approved contrast-safe palette, and added repository-wide syntax, accessibility, and colour-contrast validators. Closes [#986](https://github.com/lightspeedwp/.github/issues/986). ([#987](https://github.com/lightspeedwp/.github/pull/987)) + - **Repository-wide Mermaid diagram WCAG 2.2 AA colour-contrast sweep** โ€” Applied the approved 7-role semantic palette (`fill`/`color`/`stroke` triples, all โ‰ฅ 4.5:1 in light and dark mode) to all Mermaid diagrams across 47 Markdown files. Eliminates the dark-mode white-text-on-pastel contrast failures identified by the new `validate-mermaid-colour-contrast` validator introduced in [#977](https://github.com/lightspeedwp/.github/pull/977). ([#982](https://github.com/lightspeedwp/.github/pull/982)) - **Template enforcement now skips Dependabot merged PRs** โ€” Updated the push-side template guardrail so Dependabot-authored merged pull requests are not blocked by standard PR template enforcement, matching the PR-side skip already in place. ([#972](https://github.com/lightspeedwp/.github/pull/972)) From 4def9d76882450bda8fa68c173cd9ecd45ee2db4 Mon Sep 17 00:00:00 2001 From: Ash Shaw Date: Thu, 18 Jun 2026 17:39:54 +0200 Subject: [PATCH 3/5] docs: fix mermaid lint fallout --- .github/reports/mermaid-validation-report.md | 2 +- .../reports/mermaid/colour-contrast-report-2026-06-18.md | 2 +- instructions/mermaid.instructions.md | 8 ++++---- package.json | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/.github/reports/mermaid-validation-report.md b/.github/reports/mermaid-validation-report.md index bc8ec07d2..2a847b5b3 100644 --- a/.github/reports/mermaid-validation-report.md +++ b/.github/reports/mermaid-validation-report.md @@ -13,7 +13,7 @@ stability: stable # Mermaid Diagram Syntax Validation Report -**Generated**: 2026-06-18T15:35:13.796Z +**Generated**: 2026-06-18T15:39:39.460Z ## Summary diff --git a/.github/reports/mermaid/colour-contrast-report-2026-06-18.md b/.github/reports/mermaid/colour-contrast-report-2026-06-18.md index 3a2e2f11b..296a79bb0 100644 --- a/.github/reports/mermaid/colour-contrast-report-2026-06-18.md +++ b/.github/reports/mermaid/colour-contrast-report-2026-06-18.md @@ -11,7 +11,7 @@ stability: stable # Mermaid Colour Contrast Report -**Generated**: 2026-06-18T15:35:14.324Z +**Generated**: 2026-06-18T15:39:39.965Z ## Summary diff --git a/instructions/mermaid.instructions.md b/instructions/mermaid.instructions.md index d0d3a90f8..c5e8f4daf 100644 --- a/instructions/mermaid.instructions.md +++ b/instructions/mermaid.instructions.md @@ -35,7 +35,7 @@ Do **not** force a diagram into a file where a simple list or paragraph is clear Every Mermaid block **must** include an accessibility header block placed immediately after the opening ` ```mermaid ` fence and before the diagram type declaration: -```text +````text ```mermaid --- accTitle: Short accessible title (max 80 chars) @@ -44,11 +44,11 @@ accDescr: Single-sentence description for simple diagrams flowchart LR ... ``` -``` +```` For complex diagrams, use the block form: -```text +````text ```mermaid --- accTitle: Complex workflow title @@ -61,7 +61,7 @@ accDescr { flowchart TD ... ``` -``` +```` **Rules:** diff --git a/package.json b/package.json index 616b4a37a..b5823d45e 100644 --- a/package.json +++ b/package.json @@ -76,7 +76,7 @@ "lint": "npm run lint:js && npm run lint:yaml && npm run lint:pkg-json", "lint:all": "npm run lint && npm run lint:workflows && npm run lint:md && npm run lint:json", "lint:js": "eslint '**/*.{js,jsx,ts,tsx}' --ignore-pattern 'design_handoff_awesome_github/**' --ignore-pattern 'website/**' --fix", - "lint:md": "markdownlint-cli2 \"**/*.{md,mdx}\" \"!node_modules\" \"!website/**\" \"!wceu-2026/**\" \"!.github/projects/**\" \"!AWESOME_GITHUB_MAPPING_STRATEGY.md\" \"!docs/MIGRATION.md\"", + "lint:md": "markdownlint-cli2 \"**/*.{md,mdx}\" \"!node_modules\" \"!website/**\" \"!wceu-2026/**\" \"!.github/projects/**\" \"!.github/reports/**\" \"!AWESOME_GITHUB_MAPPING_STRATEGY.md\" \"!docs/MIGRATION.md\"", "lint:md:fix": "markdownlint-cli2 --fix \"**/*.{md,mdx}\" \"!node_modules\" \"!wceu-2026/**\" \"!.github/projects/**\" \"!AWESOME_GITHUB_MAPPING_STRATEGY.md\" \"!docs/MIGRATION.md\"", "format:js": "prettier '**/*.{js,jsx,ts,tsx}' --write && eslint '**/*.{js,jsx,ts,tsx}' --fix --format", "format:md": "prettier '**/*.md' --write && markdownlint-cli2 --fix \"**/*.{md,mdx}\" \"!node_modules\"", From d165e1b41ff9454d9a246792abee2114b714d345 Mon Sep 17 00:00:00 2001 From: Ash Shaw Date: Thu, 18 Jun 2026 17:44:58 +0200 Subject: [PATCH 4/5] docs: align mermaid metadata freshness --- .github/README.md | 2 +- .github/reports/mermaid-accessibility-report.md | 4 ++-- .github/reports/mermaid-validation-report.md | 2 +- .github/reports/mermaid/diagram-validation-2025-12-11.md | 4 ++-- .github/workflows/meta.yml | 1 + .vscode/README.md | 4 ++-- CONTRIBUTING.md | 4 ++-- README.md | 2 +- docs/AGENT_CREATION.md | 4 ++-- docs/HUSKY_PRECOMMITS.md | 4 ++-- instructions/automation.instructions.md | 2 +- instructions/documentation-formats.instructions.md | 4 ++-- instructions/linting.instructions.md | 4 ++-- instructions/mermaid.instructions.md | 2 +- instructions/quality-assurance.instructions.md | 4 ++-- profile/README.md | 4 ++-- scripts/README.md | 4 ++-- 17 files changed, 28 insertions(+), 27 deletions(-) diff --git a/.github/README.md b/.github/README.md index c60162346..9a6cc7e94 100644 --- a/.github/README.md +++ b/.github/README.md @@ -4,7 +4,7 @@ title: LightSpeed .github Community Health Repository description: Central hub for all shared GitHub templates, Copilot instructions, workflow automation, labeling systems, and community health files across the LightSpeed WordPress organisation -version: '3.5' +version: '3.6' created_date: '2025-01-15' last_updated: '2026-06-18' authors: diff --git a/.github/reports/mermaid-accessibility-report.md b/.github/reports/mermaid-accessibility-report.md index 754788e28..c359effa9 100644 --- a/.github/reports/mermaid-accessibility-report.md +++ b/.github/reports/mermaid-accessibility-report.md @@ -1,9 +1,9 @@ --- title: Mermaid Diagram Accessibility Compliance Report โ€” Issue #669 description: Accessibility compliance audit of all 24 Mermaid diagrams for accTitle and accDescr attributes -version: 1.0.0 +version: 1.0.1 created_date: "2026-05-31" -last_updated: "2026-05-31" +last_updated: "2026-06-18" file_type: documentation maintainer: Claude Code owners: diff --git a/.github/reports/mermaid-validation-report.md b/.github/reports/mermaid-validation-report.md index 2a847b5b3..33e375a15 100644 --- a/.github/reports/mermaid-validation-report.md +++ b/.github/reports/mermaid-validation-report.md @@ -1,7 +1,7 @@ --- title: Mermaid Diagram Syntax Validation Report description: Mermaid diagram syntax validation results for repository README files -version: "1.0.0" +version: "1.1.0" created_date: "2026-06-18" last_updated: "2026-06-18" file_type: documentation diff --git a/.github/reports/mermaid/diagram-validation-2025-12-11.md b/.github/reports/mermaid/diagram-validation-2025-12-11.md index b8fd75932..027d2b6e2 100644 --- a/.github/reports/mermaid/diagram-validation-2025-12-11.md +++ b/.github/reports/mermaid/diagram-validation-2025-12-11.md @@ -2,9 +2,9 @@ file_type: "documentation" title: "Mermaid Diagram Validation Report" description: "Comprehensive validation of all Mermaid diagrams across top-level folders with WCAG AA accessibility and structural checks" -version: "1.0" +version: "1.1" created_date: "2025-12-11" -last_updated: "2025-12-11" +last_updated: "2026-06-18" author: "GitHub Copilot" maintainer: "LightSpeed Team" category: "mermaid" diff --git a/.github/workflows/meta.yml b/.github/workflows/meta.yml index 87f3b0f03..782d038a9 100644 --- a/.github/workflows/meta.yml +++ b/.github/workflows/meta.yml @@ -93,6 +93,7 @@ jobs: FILES=$(git diff --name-only "$BASE_SHA" "$HEAD_SHA" -- '*.md' '*.mdx' | \ sed '/^AWESOME_GITHUB_MAPPING_STRATEGY\.md$/d' | \ sed '/^docs\/MIGRATION\.md$/d' | \ + sed '/^\.github\/reports\//d' | \ tr '\n' ' ') if [ -z "$FILES" ]; then diff --git a/.vscode/README.md b/.vscode/README.md index 56d5d54e4..0351daddc 100644 --- a/.vscode/README.md +++ b/.vscode/README.md @@ -1,8 +1,8 @@ --- title: "VS Code Workspace Configuration" description: "Visual Studio Code workspace settings, tasks, extensions, and AI integration for LightSpeedWP development environment" -version: "v1.2" -last_updated: '2026-06-01' +version: "v1.3" +last_updated: '2026-06-18' maintainer: "LightSpeed Engineering" tags: ["vscode", "configuration", "extensions", "tasks", "ai", "development"] file_type: "configuration" diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 260a65eeb..eea8c32d3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,8 +2,8 @@ file_type: "documentation" title: "Contributing Guidelines" description: "Comprehensive contribution guidelines for LightSpeed community health repository including setup, standards, and workflow" -version: '1.4' -last_updated: '2026-06-01' +version: '1.5' +last_updated: '2026-06-18' owners: ["LightSpeed Team"] tags: ["contributing", "guidelines", "workflow", "standards", "pull-requests"] --- diff --git a/README.md b/README.md index 2ea83c2d7..729983cf8 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ file_type: documentation title: LightSpeed Community Health & Automation Repository description: Central hub for LightSpeed organization's community health files, automation standards, label management, governance documentation, and org-wide resources for GitHub usage and contribution. -version: '3.0' +version: '3.1' last_updated: '2026-06-18' owners: - LightSpeed Team diff --git a/docs/AGENT_CREATION.md b/docs/AGENT_CREATION.md index 8f0834819..52fc25ddf 100644 --- a/docs/AGENT_CREATION.md +++ b/docs/AGENT_CREATION.md @@ -3,9 +3,9 @@ file_type: documentation title: Agent Specification Authoring Guide description: Comprehensive guide for creating, documenting, and maintaining agent specification files following LightSpeed standards -version: 'v1.2' +version: 'v1.4' created_date: '2025-01-15' -last_updated: '2026-06-01' +last_updated: '2026-06-18' author: LightSpeed Team maintainer: LightSpeed Team license: GPL-3.0 diff --git a/docs/HUSKY_PRECOMMITS.md b/docs/HUSKY_PRECOMMITS.md index 131c36f65..8f41458ea 100644 --- a/docs/HUSKY_PRECOMMITS.md +++ b/docs/HUSKY_PRECOMMITS.md @@ -2,8 +2,8 @@ file_type: documentation title: Husky Pre-commit Hooks description: Using Husky to enforce quality gates (linting/tests) before commits -version: 1.0.1 -last_updated: '2026-05-29' +version: 1.0.2 +last_updated: '2026-06-18' owners: - LightSpeed DevOps tags: diff --git a/instructions/automation.instructions.md b/instructions/automation.instructions.md index 0a5feb7d9..53a828fbd 100644 --- a/instructions/automation.instructions.md +++ b/instructions/automation.instructions.md @@ -4,7 +4,7 @@ title: Automation Standards description: Comprehensive standards for GitHub automation agents, workflows, and repository health management scope: repo-local -version: v1.1.1 +version: v1.1.2 last_updated: '2026-06-18' owners: - GitHub Community Health Team diff --git a/instructions/documentation-formats.instructions.md b/instructions/documentation-formats.instructions.md index a3ec5f435..1e2e2a710 100644 --- a/instructions/documentation-formats.instructions.md +++ b/instructions/documentation-formats.instructions.md @@ -3,8 +3,8 @@ file_type: "instructions" title: "Documentation Formats Standards" description: "Unified standards for Markdown, YAML frontmatter, and Mermaid diagrams across all GitHub community health documentation" scope: "organization-wide" -version: "v1.1.1" -last_updated: "2026-05-29" +version: "v1.1.2" +last_updated: "2026-06-18" owners: ["GitHub Community Health Team"] tags: - markdown diff --git a/instructions/linting.instructions.md b/instructions/linting.instructions.md index cc9595bc8..cc535a906 100644 --- a/instructions/linting.instructions.md +++ b/instructions/linting.instructions.md @@ -5,8 +5,8 @@ description: Master index for all linting instructions in the LightSpeed organis Lists and cross-references all linting instructions, config, and coding standards. scope: organization-wide applyTo: '**/*.{js,ts,php,css,scss,sass,html,json,md,yml,yaml,py,sh}' -version: v2.1 -last_updated: '2026-05-29' +version: v2.2 +last_updated: '2026-06-18' owners: - LightSpeedWP Team tags: diff --git a/instructions/mermaid.instructions.md b/instructions/mermaid.instructions.md index c5e8f4daf..e02ece817 100644 --- a/instructions/mermaid.instructions.md +++ b/instructions/mermaid.instructions.md @@ -3,7 +3,7 @@ file_type: "instructions" title: "Mermaid Diagram Instructions" description: "Design, accessibility, colour contrast, and validation standards for Mermaid diagrams across the repository" scope: "repo-local" -version: "v2.0" +version: "v2.1" last_updated: "2026-06-18" owners: ["LightSpeed Team"] tags: ["mermaid", "diagrams", "documentation", "a11y", "wcag", "colour-contrast", "visuals", "architecture"] diff --git a/instructions/quality-assurance.instructions.md b/instructions/quality-assurance.instructions.md index f4cbffc48..928e19ea7 100644 --- a/instructions/quality-assurance.instructions.md +++ b/instructions/quality-assurance.instructions.md @@ -4,8 +4,8 @@ title: Quality Assurance Standards description: Comprehensive testing, validation, and quality assurance standards for all GitHub repository code and automation scope: organization-wide -version: v1.1 -last_updated: '2026-05-29' +version: v1.1.1 +last_updated: '2026-06-18' owners: - GitHub Community Health Team tags: diff --git a/profile/README.md b/profile/README.md index 43c682579..c7cd4cbb4 100644 --- a/profile/README.md +++ b/profile/README.md @@ -2,9 +2,9 @@ file_type: documentation title: LightSpeed WordPress Development Agency - GitHub Profile description: Welcome to LightSpeed's GitHub Organization - WordPress design and development agency creating powerful, open-source solutions for the WordPress ecosystem since 2003 -version: v2.1 +version: v2.3 created_date: '2025-10-20' -last_updated: '2026-05-29' +last_updated: '2026-06-18' maintainer: LightSpeed Team authors: - LightSpeed Team diff --git a/scripts/README.md b/scripts/README.md index 508a18deb..dbe7a1d30 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -2,8 +2,8 @@ title: "LightSpeedWP Scripts & Automation" description: "Comprehensive automation scripts, utilities, and maintenance tools for LightSpeedWP projects. Modular design with shared infrastructure and extensive testing." file_type: documentation -version: "2.6" -last_updated: "2026-06-01" +version: "2.8" +last_updated: "2026-06-18" created_date: "2025-12-04" owners: - LightSpeedWP Team From b0ad01485ae5174e48fd791f891106578e783e71 Mon Sep 17 00:00:00 2001 From: Ash Shaw Date: Thu, 18 Jun 2026 17:49:38 +0200 Subject: [PATCH 5/5] docs: fix mermaid link hygiene --- .github/workflows/meta.yml | 4 +++- CONTRIBUTING.md | 13 ++++++------- instructions/linting.instructions.md | 2 +- instructions/quality-assurance.instructions.md | 2 +- profile/README.md | 2 +- scripts/README.md | 2 +- 6 files changed, 13 insertions(+), 12 deletions(-) diff --git a/.github/workflows/meta.yml b/.github/workflows/meta.yml index 782d038a9..b7a04bcaa 100644 --- a/.github/workflows/meta.yml +++ b/.github/workflows/meta.yml @@ -118,7 +118,9 @@ jobs: exit 0 fi - CHANGED_FILES=$(git diff --name-only "$BASE_SHA" "$HEAD_SHA" -- '*.md' '*.mdx') + CHANGED_FILES=$(git diff --name-only "$BASE_SHA" "$HEAD_SHA" -- '*.md' '*.mdx' | \ + grep -v '^\.github/instructions/\.archive/' | \ + grep -v '^\.github/reports/') if [ -z "$CHANGED_FILES" ]; then echo "files=" >> "$GITHUB_OUTPUT" exit 0 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index eea8c32d3..d6b18f916 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -94,7 +94,7 @@ To maintain a consistent, high-quality codebase and community, please follow the - **Select the correct PR template:** Bugfix, Feature, Chore, Docs, Build/CI, Dependencies/Maintenance, Hotfix, Release, Refactor, or General PR template. - Your branch prefix should match the PR template (e.g., `fix/` โ†’ Bugfix PR, `feat/` โ†’ Feature PR). - - See [PR_LABELS.md](./docs/PR_LABELS.md) for template-to-label mapping and automation. + - See [Labeling Strategy & Governance](./docs/LABELING.md) for template-to-label mapping and automation. - **Required PR details:** - Accurate, up-to-date description. - Link to the related GitHub Issue. @@ -128,9 +128,9 @@ Refer to `.vscode/extensions.json` and `.vscode/settings.json` for the authorita - **Saved Replies:** Use [SAVED_REPLIES/README.md](.github/SAVED_REPLIES/README.md) for common responses and efficient communication. - **Documentation:** Update relevant docs (README, instructions) for any user-facing change. -- **Automation & Labels:** Ensure your issue/PR complies with [AUTOMATION_GOVERNANCE.md](./docs/AUTOMATION_GOVERNANCE.md), [ISSUE_LABELS.md](docs/ISSUE_LABELS.md), and [ISSUE_TYPES.md](./docs/ISSUE_TYPES.md). +- **Automation & Labels:** Ensure your issue/PR complies with [Automation & Workflows](./docs/AUTOMATION.md), [Labeling Strategy & Governance](./docs/LABELING.md), and [ISSUE_TYPES.md](./docs/ISSUE_TYPES.md). - **Governance process updates:** If your change modifies governance policy or contributor workflow expectations, add an entry to [GOVERNANCE_REVISION_LOG.md](./docs/GOVERNANCE_REVISION_LOG.md). -- **Downstream overrides:** If you are adopting org defaults in another repository, follow [Downstream Override Policy](./docs/override-policy.md) and link any approved exception. +- **Downstream overrides:** If you are adopting org defaults in another repository, follow [Downstream Override Policy](./docs/OVERRIDE_POLICY.md) and link any approved exception. - **Changelog:** All user-facing changes, fixes, and features must be entered in [CHANGELOG.md](./CHANGELOG.md) in Keep a Changelog format. See example sections in the changelog for proper grouping and linking. --- @@ -139,12 +139,11 @@ Refer to `.vscode/extensions.json` and `.vscode/settings.json` for the authorita - [BRANCHING_STRATEGY.md](./docs/BRANCHING_STRATEGY.md): Org-wide branch naming, merge discipline, and automation mapping. - [CHANGELOG.md](./CHANGELOG.md): Changelog format, release notes, and versioning. -- [AUTOMATION_GOVERNANCE.md](./docs/AUTOMATION_GOVERNANCE.md): Org-wide automation, branching, label, and release strategy. +- [Automation & Workflows](./docs/AUTOMATION.md): Org-wide automation, branching, label, and release strategy. - [GOVERNANCE_REVISION_LOG.md](./docs/GOVERNANCE_REVISION_LOG.md): Lightweight audit trail for governance/process changes. -- [override-policy.md](./docs/override-policy.md): Mandatory versus optional org defaults, exception handling, and promotion model. +- [Downstream Override Policy](./docs/OVERRIDE_POLICY.md): Mandatory versus optional org defaults, exception handling, and promotion model. - [ISSUE_TYPES.md](./docs/ISSUE_TYPES.md): Issue type mapping and usage. -- [ISSUE_LABELS.md](./docs/ISSUE_LABELS.md): Label families, triage, and workflow. -- [PR_LABELS.md](./docs/PR_LABELS.md): PR labelling, templates, and automation. +- [Labeling Strategy & Governance](./docs/LABELING.md): Label families, triage, and workflow. - [Coding Standards](instructions/coding-standards.instructions.md) - [Documentation Formats](instructions/documentation-formats.instructions.md) - [Community Standards](instructions/community-standards.instructions.md) diff --git a/instructions/linting.instructions.md b/instructions/linting.instructions.md index cc535a906..4911629de 100644 --- a/instructions/linting.instructions.md +++ b/instructions/linting.instructions.md @@ -129,7 +129,7 @@ graph TD ### โš™๏ธ Tool Integration -- **[Lint Workflow](../.github/workflows/lint.yml)** - GitHub Actions linting +- **[Lint Workflow](../.github/workflows/linting.yml)** - GitHub Actions linting - **[Linting Agent](agent-spec.instructions.md)** - Automated code review - **Pre-commit Hooks** - Local validation setup diff --git a/instructions/quality-assurance.instructions.md b/instructions/quality-assurance.instructions.md index 928e19ea7..268aef9b7 100644 --- a/instructions/quality-assurance.instructions.md +++ b/instructions/quality-assurance.instructions.md @@ -121,7 +121,7 @@ graph TD **Config Files:** -- Main config: [`jest.config.js`](../jest.config.js) or [`jest.config.cjs`](../jest.config.cjs) +- Main config: `jest.config.js` or `jest.config.cjs` - Setup: `jest.setup.js` for global test setup - Helpers: `tests/test-helpers.js` for shared utilities diff --git a/profile/README.md b/profile/README.md index c7cd4cbb4..36e75f7f0 100644 --- a/profile/README.md +++ b/profile/README.md @@ -23,7 +23,7 @@ owners: [![Since 2003](https://img.shields.io/badge/Since-2003-blue)](https://lightspeedwp.agency/about) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Community](https://img.shields.io/badge/Community-Driven-success)](https://github.com/orgs/lightspeedwp/discussions) -[![AI Enhanced](https://img.shields.io/badge/AI-Enhanced-purple)](./.github/custom-instructions.md) +[![AI Enhanced](https://img.shields.io/badge/AI-Enhanced-purple)](../.github/custom-instructions.md) ## ๐Ÿ‘‹ Welcome to LightSpeed's GitHub Organization diff --git a/scripts/README.md b/scripts/README.md index dbe7a1d30..e8ba38d36 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -450,7 +450,7 @@ When contributing new scripts or modifications: - [GitHub Actions Workflows](../.github/workflows/) - [Schema Definitions](../schema/) -- [Test Coverage Reports](../tests/TEST_COVERAGE_SUMMARY.md) +- [Test Coverage Reports](../docs/TESTING.md#coverage-requirements) - [Contributing Guidelines](../CONTRIBUTING.md) ## AI & Automation References