Roadmap
The build is phased so the local workflow is proven on one site before API automation or multi-site rollout.
Phases
| Phase | Name | Deliverables | Status |
|---|---|---|---|
| A | Local workflow | v0.2 schema; research folders; brief gate; links.csv; decision fields; gos_tier; tests | Implemented |
| B | WordPress read bridge | scs wp inspect; scs qa pull; scs qa check; scs publish --dry-run | Implemented |
| C | Draft publish | Idempotent draft create/update; ACF mapping; Gutenberg conversion; internal pid: links; article-half slicing | Implemented (pilot) |
| D | QA gate | Portable wpstrategist-review-gate ACF plugin; status/scope/checklist; SCS enforcement | Implemented on opshell.dev |
| D2 | Terminal publishing state | scs publish --to draft|pending|future|publish; date guard; QA guard | Contract — in progress |
| E | Measurement | GSC import; 30/90-day report; refresh queue; cannibalization report | Planned |
| F | Multi-site | Site-specific ACF/taxonomy adapters; rollout beyond opshell | Planned |
| G | Tool ingestion | Manual exports are the supported path; optional automated ingestion is out of scope | Not planned |
Pilot status
- Pilot site: opshell.dev (
GC-SG-M8,/home/wp_opshell_dev/sites/opshell.dev). - ACF Pro active; SEO Architecture, Author Profile, and Technical Review groups verified.
wpstrategist-review-gateinstalled and active.- Draft publish, QA pull, QA check, and advance-to-Scheduled tested end to end.
- Test draft deleted after verification.
Decision log
| Date | Decision | Rationale |
|---|---|---|
| 2026-10-15 | SCS is a standalone repo at server-side-program/scs | Reusable across owned and client sites. |
| 2026-10-15 | Data split into linked CSVs sharing pid/title/keyword | Each stage usable alone. |
| 2026-10-15 | GOS computed by the system, not typed | CSV has no live formulas; consistency. |
| 2026-10-23 | GOS is supporting; priority renamed gos_tier | Human decision is the verdict; cluster strategy can override GOS. |
| 2026-10-23 | Research is a per-PID folder, not a CSV | Evidence and AI collaboration need files, not columns. |
| 2026-10-23 | Brief is Markdown with front matter and fixed sections | Readable, diffable, AI-friendly, machine-checkable. |
| 2026-10-23 | QA lives in WordPress/ACF | The review surface already exists; SCS should not duplicate it. |
| 2026-10-23 | Publishing is draft-only | Human review is mandatory. |
| 2026-11-01 | Brief and article share one Markdown file | Keeps the audit trail and the draft together; <!-- scs:brief --> / <!-- scs:article --> separate them. |
| 2026-11-01 | Front matter keeps content_type | It means article format; renaming it would touch 16k files and the doc tooling. ACF content_type is mapped from kc_type. |
| 2026-11-01 | XML sitemaps stay plugin-owned (SEOPress); SCS does not generate XML | Avoids a second competing sitemap and reimplementing WordPress permalink/taxonomy logic. SCS may verify sitemap presence later; see XML Sitemaps. |
| 2026-10-23 | Pilot one site before multi-site rollout | ACF and taxonomy contracts differ per site. |
Related work
- PlanWil — source of the board/generator/keybinding pattern.
- SEO content method docs — sections 01–12 of this site.
- seowriting — the writing layer used by the brief and draft gates.
- seo3 — the SEO method and quality reference.