Refactor agentic-docs plugin: remove platform-docs skill

Platform documentation in openshift/enhancements/ai-docs/ already exists
and was created using this skill. Remove the /platform-docs skill that was designed
to create it from scratch - it's no longer needed.

Changes:
- Remove entire skills/platform/ directory
- Keep /update-platform-docs for incremental updates to existing platform docs
- Keep /component-docs for creating component-level documentation
- Update README to clarify platform docs "already exist"
- Simplify tier architecture description (tier-1/tier-2 → platform/component)
- Update component skill templates to reference "platform docs" consistently
- Update validation scripts to remove platform-specific checks
- Remove platform-docs from marketplace registration

This simplifies the plugin to focus on its two active use cases:
1. Creating new component documentation (/component-docs)
2. Updating existing platform documentation (/update-platform-docs)

Author: Prashanth684

docs/data.json

@@ -1831,15 +1831,10 @@
       "name": "agentic-docs",
       "skills": [
         {
-          "description": "Create lean tier-2 component documentation for OpenShift repositories",
-          "id": "component",
+          "description": "Create lean component documentation for OpenShift repositories",
+          "id": "component-docs",
           "name": "component-docs"
         },
-        {
-          "description": "Create AI-optimized platform documentation for openshift/enhancements",
-          "id": "platform",
-          "name": "platform-docs"
-        },
         {
           "description": "Update existing platform documentation with automatic gap detection in openshift/enhancements",
           "id": "update-platform-docs",
@@ -1849,4 +1844,4 @@
       "version": "1.0.0"
     }
   ]
-}
+}

plugins/agentic-docs/OWNERS

@@ -0,0 +1,10 @@
+approvers:
+- Prashanth684
+- kenjpais
+- jatinsu
+- andymcc
+reviewers:
+- Prashanth684
+- kenjpais
+- jatinsu
+- andymcc

plugins/agentic-docs/README.md

@@ -4,46 +4,36 @@ AI-optimized OpenShift documentation with progressive disclosure, reference styl
 
 ## Two-Tier Architecture
 
-**Tier 1: Platform Hub** (`openshift/enhancements/ai-docs/`)  
+**Platform Docs** (`openshift/enhancements/ai-docs/`) - **Already exists**  
 Generic patterns, testing, security, K8s/OpenShift fundamentals, cross-repo ADRs. ~34 files, 4.4k lines.
 
-**Tier 2: Component Repos** (`{component}/ai-docs/`)  
-Component CRDs, architecture, local ADRs, exec-plans. Links to Tier 1. ~15 files, 2.5k lines (58% leaner).
+**Component Docs** (`{component}/ai-docs/`)  
+Component CRDs, architecture, local ADRs, exec-plans. Links to platform docs. ~15 files, 2.5k lines (58% leaner).
 
 ## Skills
 
-### `/platform-docs`
-Creates Tier 1 platform documentation in `openshift/enhancements/ai-docs/`.
-
-```bash
-cd /path/to/openshift/enhancements
-/platform-docs
-```
-
-Creates AGENTS.md (navigation) + ai-docs/ with: platform patterns (controller-runtime, webhooks, finalizers, RBAC, must-gather), domain concepts (K8s/OpenShift APIs), practices (testing, security, reliability), cross-repo ADRs, workflows (exec-plans, enhancement process), and references (repo-index, glossary, API pointers).
-
 ### `/update-platform-docs`
-Incrementally update Tier 1 docs with automatic gap detection.
+Incrementally update platform docs with automatic gap detection.
 
 ```bash
 cd /path/to/openshift/enhancements
 /update-platform-docs
 ```
 
-Scans ai-docs/, reports missing files, lets you fill gaps or add custom content. Auto-updates indexes/navigation and validates conventions. Use for incremental changes when ai-docs/ exists (otherwise use `/platform-docs`).
+Scans ai-docs/, reports missing files, lets you fill gaps or add custom content. Auto-updates indexes/navigation and validates conventions. Use for incremental changes to existing platform documentation.
 
 ### `/component-docs`
-Creates Tier 2 lean docs in component repositories.
+Creates lean component docs in component repositories.
 
 ```bash
 cd /path/to/component-repository
 /component-docs
 ```
 
-Creates AGENTS.md + ai-docs/ with: component CRDs only, architecture, component ADRs, exec-plans, ecosystem links to Tier 1, development/testing guides. Excludes generic patterns (lives in Tier 1). Example: [machine-config-operator/ai-docs](https://github.com/openshift/machine-config-operator/tree/master/ai-docs).
+Creates AGENTS.md + ai-docs/ with: component CRDs only, architecture, component ADRs, exec-plans, ecosystem links to platform docs, development/testing guides. Excludes generic patterns (lives in platform docs). Example: [machine-config-operator/ai-docs](https://github.com/openshift/machine-config-operator/tree/master/ai-docs).
 
 ## Development
 
-Skills live under `skills/{platform,update-platform-docs,component}/` with SKILL.md, scripts, and templates.
+Skills live under `skills/{update-platform-docs,component-docs}/` with SKILL.md, scripts, and templates.
 
 **License:** Apache 2.0