# 📅 Q4 2025 Headless WordPress Toolkit & Faust Refactor Roadmap

This roadmap reflects updated priorities for Q4 2025, emphasizing QA and GA release of the `wpgraphql-logging` plugin, exposure of existing documentation to the Docs site, and focused development on key Headless WordPress Toolkit packages.

---

## 🧭 Strategic Priorities

1. **QA and GA release of `wpgraphql-logging` plugin**  
   - Validate and release the plugin before end of November.  
   - Ensure it meets pre-GA QA standards and integrates cleanly with the Toolkit.

2. **Developer documentation for the Headless WordPress Toolkit**  
   - Expose existing `.md` files for the Logging Plugin to the Docs site.  
   - Improve overall Docs structure to support Toolkit content.

3. **Focused Toolkit package development**  
   - Prioritize `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`.  
   - Defer additional package work to Q1 2026.

---

## 🗓 Sprint Breakdown

| Sprint | Dates           | Focus Areas                           | Key Deliverables |
|--------|----------------|---------------------------------------|-----------------|
| **1** | Oct 7 – Oct 20  | 🛤 Planning + Initial Scaffolds         | - Publish updated roadmap (internal + OSS)<br>- Scaffold `@wpengine/hwp-toolbar` (carryover)<br>- Demo app updated for internal testing<br>- Prepare QA environment for `wpgraphql-logging` plugin |
| **2** | Oct 21 – Nov 3  | ✅ **QA & Validation** | - **Pre-GA testing and validation of `wpgraphql-logging` plugin**<br>- Track QA results and fix issues for GA<br>- Integrate initial developer docs for Headless WP Toolkit<br>- *(Stretch goal)* Validate Toolkit examples function as expected |
| **3** | Nov 4 – Nov 17  | 📘 **Docs Integration & Exposure**       | - **Expose existing `wpgraphql-logging` plugin `.md` docs to the public Docs site**<br>- Continue improving developer docs for the Headless WP Toolkit<br>- Ensure Docs site structure supports Toolkit and Logging content<br>- Plan GA release logistics for `wpgraphql-logging` |
| **4** | Nov 18 – Dec 1  | 🚀 **Final QA + GA Release**             | - **Final QA pass and GA release of `wpgraphql-logging` plugin** 🎉<br>- Begin focused development on `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth` packages<br>- Internal validation and documentation for these packages |
| **5** | Dec 2 – Dec 15  | 🧩 **Toolkit Package Development**       | - Continue iteration on `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`<br>- Internal beta testing of both packages<br>- Refine Toolkit + Faust integration notes<br>- Update roadmap and documentation accordingly |
| **6** | Dec 16 – Dec 23 | 🎉 **Release Prep & OSS Launch**         | - OSS publication of Toolkit-related packages and docs<br>- Publish Next.js adapter alignment roadmap<br>- Internal & OSS communication (GA recap + next steps)<br>- Plan Q1 2026: Astro + SvelteKit adapter expansion |

---

## 🎯 End of Quarter Outcomes

- ✅ **`wpgraphql-logging` plugin GA release completed**  
- 📘 **Toolkit developer docs published and integrated into Docs site**  
- 🧩 **`@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth` packages in beta**  
- 🌐 **Improved developer experience with validated Toolkit integration flow**  
- 🗺 **Q1 2026 roadmap prepared for adapter expansion (Astro, SvelteKit)**

---

## 👉 By Dec 23, 2025, Developers Can

- Use the **GA version of the `wpgraphql-logging` plugin**  
- Access **Toolkit documentation directly on the Docs site**  
- Integrate **`@wpengine/hwp-template-hierarchy`** and **`@wpengine/hwp-auth`** in projects  
- Test and contribute to the growing **Faust + Toolkit ecosystem**

---

## 🧾 GA Readiness Checklist (Logging Plugin)

| Area | Criteria | Owner | Status |
|------|-----------|--------|--------|
| QA Testing | All test cases pass across supported WP + GraphQL versions | QA | 🔄 In progress |
| Docs | `.md` files exposed and verified on Docs site | Docs | ✅ Ready |
| Compatibility | Verified with latest WPGraphQL + Toolkit packages | Eng | 🔄 In progress |
| Release | Tagged on GitHub + WP Updater | Eng | ⏳ Planned (Sprint 4) |
| Announcement | GA summary and migration notes published | Comms | ⏳ Planned (Sprint 6) |

---

## 🔮 Looking Ahead (Q1 2026 Preview)

- Expand Headless WordPress Toolkit with **Astro** and **SvelteKit** adapters.  
- Continue improving `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`.  
- Broaden Toolkit integration with Faust Core and community examples.  

---

_Last updated: Oct 21, 2025_