{"id":31829288,"url":"https://github.com/lightspeedwp/wp-docs","last_synced_at":"2026-02-16T07:33:14.707Z","repository":{"id":312648761,"uuid":"1048193543","full_name":"lightspeedwp/wp-docs","owner":"lightspeedwp","description":null,"archived":false,"fork":false,"pushed_at":"2025-10-24T06:36:02.000Z","size":2997,"stargazers_count":1,"open_issues_count":14,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T23:08:59.578Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lightspeedwp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-01T04:40:47.000Z","updated_at":"2025-10-24T06:35:33.000Z","dependencies_parsed_at":"2025-09-01T07:04:50.022Z","dependency_job_id":"47b16d77-2ae9-40b0-813a-4af62dc24049","html_url":"https://github.com/lightspeedwp/wp-docs","commit_stats":null,"previous_names":["lightspeedwp/wp-docs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lightspeedwp/wp-docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightspeedwp%2Fwp-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightspeedwp%2Fwp-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightspeedwp%2Fwp-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightspeedwp%2Fwp-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lightspeedwp","download_url":"https://codeload.github.com/lightspeedwp/wp-docs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightspeedwp%2Fwp-docs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29502934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T05:57:17.024Z","status":"ssl_error","status_checked_at":"2026-02-16T05:56:49.929Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-11T20:01:27.963Z","updated_at":"2026-02-16T07:33:14.702Z","avatar_url":"https://github.com/lightspeedwp.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- lightspeedwp root documentation --\u003e\n\n# lightspeedwp – WordPress Engineering \u0026 AI Assistant Docs\n\nAccelerating high‑quality WordPress development with reusable AI building blocks (prompts, instructions, chat modes, agent governance) and domain handbooks (block themes, coding standards, Gutenberg guides). Everything is tuned to produce fast, secure, accessible, internationalised, and maintainable solutions (themes, plugins, blocks, patterns).\n\n## Mission\n\nEmpower WordPress developers to deliver production‑ready features at lightspeed while upholding coding standards, accessibility (WCAG 2.2), performance, security (OWASP), and sustainable long‑term maintainability.\n\n## Repository Structure (Primary Areas)\n\n| Area                 | Path                     | Summary                                                             |\n| -------------------- | ------------------------ | ------------------------------------------------------------------- |\n| Documentation Hub    | `docs/`                  | Master index \u0026 cross-cutting conventions (see `docs/README.md`).    |\n| Copilot / AI Assets  | `docs/copilot-space/`    | Prompts, instructions, chat modes, agent schemas \u0026 authoring rules. |\n| Block Theme Guidance | `docs/block-themes/`     | Fluid spacing, typography scales, global styles, naming, patterns.  |\n| Coding Standards     | `docs/coding-standards/` | WordPress coding standards overlays, inline docs, research notes.   |\n| Gutenberg Guides     | `docs/gutenberg/`        | Getting started, how‑tos, reference, schemas.                       |\n| Frontmatter Schemas  | `docs/frontmatter/`      | YAML frontmatter conventions \u0026 schemas.                             |\n| Agent Governance     | `AGENTS.md`              | Behavioural contract for AI assistants \u0026 personas.                  |\n| Automation Scripts   | `.github/scripts/`       | Generators, validators, normalisation tooling.                      |\n\nSee also: `CHANGELOG.md` for historical evolution.\n\n## Why Keep Cross‑Technology Assets?\n\nMany engineering concerns (testing discipline, performance, security, accessibility, structured planning) transcend platform boundaries. We intentionally retain high‑quality “generic” or multi‑stack assets because they:\n\n1. Provide architectural clarity applicable to large WordPress installations (headless, API integrations, infrastructure).\n2. Reduce reinvention—reuse vetted language/framework guidance where analogous (e.g. performance patterns informing PHP + JS code paths).\n3. Enable mixed‑stack teams (WP + services) to align on shared standards.\n\nFuture refinement: lightweight tagging (e.g. `wp-core`, `block-dev`, `generic`, `infra`) to improve discoverability without deleting value.\n\n## Quick Start (Using AI Assets)\n\n1. Install desired Copilot assets (Prompts / Chat Modes / Instructions) via VS Code badges in each catalog.\n2. Copy any custom instruction you want permanently into `.github/instructions/` (or merge into a project‑level `copilot-instructions.md`).\n3. Open Copilot Chat and select a lightspeedwp chat mode (or paste a prompt) to accelerate tasks.\n4. Iterate: refine instructions with project specifics (naming conventions, text domain, PHPCS rules).\n\n### Example: Generate a Block Scaffold\n\n1. Open your plugin or theme workspace.\n2. Use the “Implementation Plan” prompt to outline the block (attributes, render strategy, style variants, i18n extraction).\n3. Apply “Accessibility Review” prompt / chat mode to validate ARIA \u0026 keyboard flows.\n4. Use performance \u0026 security instructions to audit dynamic rendering and REST endpoints.\n\n### Example: Harden a Custom REST Endpoint\n\n1. Invoke security instructions (OWASP) + performance optimization guidelines.\n2. Provide the endpoint handler code to a “Security \u0026 Code Quality” chat mode.\n3. Request: “Suggest nonce, capability checks, caching \u0026 schema validation improvements.”\n\n## WordPress Development Focus Areas\n\n-   Block Themes: design tokens → `theme.json` → fluid scale alignment.\n-   Gutenberg Blocks: React component patterns, server render callbacks, context \u0026 attributes hygiene.\n-   Performance: asset enqueue strategy, script loading strategy, avoiding layout shift, caching layers.\n-   Accessibility: semantic markup, focus management, ARIA correctness, color contrast.\n-   Internationalization: text domains, `__()/_x()` usage, extraction workflow.\n-   Testing: Playwright for editor flows, PHPUnit / WP-CLI tests, Jest for block UI logic.\n\n## Contributing (Overview)\n\nSee `CONTRIBUTING.md` for full process. Summary:\n\n1. Fork \u0026 branch.\n2. Add or update a prompt / instruction / chat mode (include frontmatter) or improve a WordPress guide.\n3. Keep scope tight; ensure examples are WP‑relevant where applicable.\n4. Run any validation/update scripts (if present) before PR.\n5. Provide rationale + before/after (if refactoring docs).\n\n### Quality Checklist (Abbreviated)\n\n-   Clear purpose \u0026 actionable steps\n-   WordPress alignment (or clearly marked cross‑tech)\n-   Accessibility \u0026 security consciousness\n-   No hard‑coded secrets / unsafe patterns\n-   Consistent naming \u0026 formatting\n\n## Roadmap Snapshot\n\nHigh‑level items (see `CHANGELOG.md` for canonical history \u0026 upcoming):\n\n-   Tagging taxonomy for AI assets \u0026 docs.\n-   WordPress‑specialised chat modes (Theme JSON Refiner, Block Accessibility Auditor, Hook Strategy Advisor).\n-   Collections curation once tagging lands.\n-   Domain surfacing (stability, domain) in generated README tables.\n-   Automated link \u0026 frontmatter validator.\n\n## Namespace \u0026 Badges\n\nAny legacy install badges still referencing upstream sources are intentionally preserved during transition; they will migrate once tagging + mirroring strategy finalises.\n\n## License\n\nThis repository is licensed under the **GNU GPL v3** (see `LICENSE`). Documentation and AI asset text are distributed under the same license for simplicity. If you require alternative terms for specific reuse scenarios, open an issue to discuss.\n\n## Feedback \u0026 Improvements\n\nOpen an issue with: context, goal, current friction, desired outcome. Evidence (snippets, diffs) speeds triage.\n\n---\n\nCrafted with accessibility, security, performance, and internationalisation in mind—manual review \u0026 testing still required.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightspeedwp%2Fwp-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flightspeedwp%2Fwp-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightspeedwp%2Fwp-docs/lists"}