ensure tactical context is indexed

Author: velles

lead-dev-os/skills/init/examples/readme-filled.md

@@ -7,6 +7,11 @@ This directory contains modular knowledge files that document Active Snap AI's c
 - **Version-controlled** - Track evolution of ideas over time
 - **AI-friendly** - Agents can load specific concepts as context
 
+## Product
+
+- **[product-mission.md](product/product-mission.md)** — Product mission, vision, target users, and technology stack
+- **[product-roadmap.md](product/product-roadmap.md)** — Prioritized feature roadmap with phased milestones
+
 ## Available Concepts
 
 ### Core Concepts

lead-dev-os/skills/init/templates/readme.md

@@ -7,6 +7,15 @@ This directory contains modular knowledge files that document {Project Name}'s c
 - **Version-controlled** - Track evolution of ideas over time
 - **AI-friendly** - Agents can load specific concepts as context
 
+## Product
+
+> Strategic product documents created by `/lead-dev-os:plan-product` and `/lead-dev-os:plan-roadmap`.
+
+<!-- Entries are added automatically by the skills that create these files:
+- **[product-mission.md](product/product-mission.md)** — Product mission, vision, target users, and technology stack
+- **[product-roadmap.md](product/product-roadmap.md)** — Prioritized feature roadmap with phased milestones
+-->
+
 ## Available Concepts
 
 > This section is populated as you build your project. Add entries here when creating new concept files.

lead-dev-os/skills/plan-product/SKILL.md

@@ -40,6 +40,17 @@ For a filled-in example, see [examples/saas-project-tracker.md](examples/saas-pr
 
 Save the document to `agents-context/product/product-mission.md`.
 
+### Phase 4: Update README
+
+Read `agents-context/README.md`. Under the `## Product` section, ensure there is an uncommented entry for `product-mission.md`. If the entry is inside an HTML comment block, uncomment it. If no entry exists, add one:
+
+```markdown
+- **[product-mission.md](product/product-mission.md)** — Product mission, vision, target users, and technology stack
+```
+
+### Phase 5: Summary
+
 Tell the user:
 - "Product mission saved to `agents-context/product/product-mission.md`"
+- "Updated `agents-context/README.md` index"
 - Suggest running `/lead-dev-os:plan-roadmap` next to create a feature roadmap based on this mission.

lead-dev-os/skills/plan-roadmap/SKILL.md

@@ -31,6 +31,17 @@ For a filled-in example, see [examples/saas-project-tracker.md](examples/saas-pr
 
 Save the document to `agents-context/product/product-roadmap.md`.
 
+### Phase 4: Update README
+
+Read `agents-context/README.md`. Under the `## Product` section, ensure there is an uncommented entry for `product-roadmap.md`. If the entry is inside an HTML comment block, uncomment it. If no entry exists, add one:
+
+```markdown
+- **[product-roadmap.md](product/product-roadmap.md)** — Prioritized feature roadmap with phased milestones
+```
+
+### Phase 5: Summary
+
 Tell the user:
 - "Roadmap saved to `agents-context/product/product-roadmap.md`"
+- "Updated `agents-context/README.md` index"
 - Suggest picking a feature from Phase 1 and running `/lead-dev-os:step1-write-spec` to begin speccing it out.