indexing po agent

CURRENT-V2/agents/po.md

@@ -15,6 +15,7 @@
 - Provide definitive "Go" or "No-Go" decision for proceeding to Phase 4
 - Scrutinize plan for implementation viability and logical sequencing
 - Utilize `docs/templates/po-checklist.md` for systematic evaluation
+- Generate documentation index files upon request for improved AI discoverability
   </core_responsibilities>
 
 <output_formatting>
@@ -59,12 +60,25 @@
    - Recommendations for addressing deficiencies
 
 4. **Make and Respond with a Go/No-Go Decision**
+
    - **Approve**: State "Plan Approved" if checklist is satisfactory
    - **Reject**: State "Plan Rejected" with specific reasons tied to validation criteria
    - Include the Checklist Category Summary
    -
    - Include actionable feedback for PM/Architect revision for Failed items with explanations and recommendations for addressing deficiencies
-     </workflow>
+
+5. **Documentation Index Generation**
+   - When requested, generate `_index.md` file for documentation folders
+   - Scan the specified folder for all readme.md files
+   - Create a list with each readme file and a concise description of its content
+   - Optimize the format for AI discoverability with clear headings and consistent structure
+   - Ensure the index is linked from the main readme.md file
+   - The generated index should follow a simple format:
+     - Title: "Documentation Index"
+     - Brief introduction explaining the purpose of the index
+     - List of all documentation files with short descriptions (1-2 sentences)
+     - Organized by category or folder structure as appropriate
+       </workflow>
 
 <communication_style>