Skip to content

Document official extensions and add selective investigation skills - #3015

Open
RabbiIslamRony wants to merge 2 commits into
sovware:developmentfrom
RabbiIslamRony:improve/official-extension-docs-skills
Open

RabbiIslamRony wants to merge 2 commits into
sovware:developmentfrom
RabbiIslamRony:improve/official-extension-docs-skills

Conversation

@RabbiIslamRony

@RabbiIslamRony RabbiIslamRony commented Sep 13, 2026

Copy link
Copy Markdown
Member

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Security fix
  • Improvement
  • New Feature
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • Text changes
  • Other... Please describe:

Description

Extension investigations currently require repeatedly identifying the owning product and relevant source, with a risk of treating the default branch or version number as authoritative. This adds source-backed documentation for the 40 verified official catalog products and selective investigation skills that route a request to the relevant product and topic.

The change contains 40 product skills plus one router, 88 short topic pages, 89 inspected source snapshots, searchable evidence ledgers, Core contract references, and routing, coverage, drift-validation and safe-install tooling. AGENTS.md and CLAUDE.md link to the selective router. Large evidence ledgers account for most of the 578 changed files and generated line count; start review with docs/extensions/README.md, ROUTER.md, WORKFLOW.md and VALIDATION.md. No plugin runtime behavior changes.

How to reproduce the issue or how to test the changes

  1. Run python3 docs/extensions/scripts/test_routing.py. Verified 80/80 exact product/repository routes and 29/29 symptom/integration cases, including 12 English symptom paraphrases. Fresh and identical skill installations pass; differing existing skills are refused and preserved.
  2. Run python3 docs/extensions/scripts/validate.py with the inspected source checkouts available. Verified 55,199 documentation/source references and line references in 8,056 source files, with zero errors. All 41 repository skills also passed the official skill-creator validator.
  3. Run php -l docs/extensions/scripts/scan_php.php and git diff --check; both passed. Review the documented focused functional/browser recipes before applying this mapping to a runtime issue; those recipes have not been executed as part of this documentation change.

Snapshot provenance includes absolute local source paths. Full source-line and drift validation requires the recorded source checkouts or refreshed path mappings. Structural source mapping and deterministic routing tests do not establish runtime compatibility, exhaustive semantic review, or new-session AI skill discovery.

Any linked issues

None — documentation and skill tooling task.

Checklist

PHPCS has not been run locally. The added standalone PHP source scanner passed PHP syntax validation; no WordPress runtime PHP was changed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant