Publish roadmap (#10)

Add ROADMAP.md (near-term / planned / exploratory / non-goals) as the
canonical forward-looking doc, linked from a new README "Roadmap" section
and the Documentation list.

Migrate the forward-looking items out of the non-standard "Planned"
subsection under the 1.2.0 changelog entry into ROADMAP.md, and move the
validate Check 6 bullet from [Unreleased] into [1.3.0] (that code already
ships in the v1.3.0 tag).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: developzoneio

CHANGELOG.md

@@ -9,11 +9,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Changed
-- `scripts/validate.{ps1,sh}` Check 6 now treats an empty `[Unreleased]` section as passing when the
-  section immediately below it is a dated `[x.y.z] - <date>` release heading (the freshly cut version),
-  so a clean post-release CHANGELOG no longer fails CI. A non-release-state empty `[Unreleased]` still
-  fails, preserving the "every PR adds a changelog line" invariant.
+### Added
+- `ROADMAP.md` - published roadmap of near-term, planned, and exploratory work, linked from
+  `README.md` (new `## Roadmap` section + Documentation entry). Migrated the forward-looking items
+  out of the non-standard `### Planned` subsection that sat under the `1.2.0` changelog entry into
+  this dedicated file.
 
 ---
 
@@ -42,6 +42,10 @@ validator with a Windows + Ubuntu CI matrix, an uninstaller, and a batch of comm
   per-project cleanup reminders (`.claude/settings.json` hook wiring, `.claude/.hookstate/`).
 
 ### Changed
+- `scripts/validate.{ps1,sh}` Check 6 now treats an empty `[Unreleased]` section as passing when the
+  section immediately below it is a dated `[x.y.z] - <date>` release heading (the freshly cut version),
+  so a clean post-release CHANGELOG no longer fails CI. A non-release-state empty `[Unreleased]` still
+  fails, preserving the "every PR adds a changelog line" invariant.
 - `/sd:perf` Gate 6 now structurally refuses a no-measurable-gain "keep" instead of merely warning about
   it in prose. The gate branches on the noise check: a measurable improvement still offers `keep` /
   `revert`, but a within-noise result defaults to `revert` and allows `keep` only as an explicit logged
@@ -110,12 +114,7 @@ Pattern conformance release. Introduces `sd-pattern-discipline` (the 6th skill),
   a real Atlassian MCP tool name - corrected to `mcp__atlassian__searchJiraIssuesUsingJql`.
   Slug-based ticket search could never have resolved before.
 
-### Planned
-- `/sd:setup` codebase scan: pre-fill constitution §1.1/§2.4 and CLAUDE.md conventions from
-  sampled source files instead of leaving `<<placeholder>>`s; optional `paths.layers` map in
-  project-config.
-- Optional `sd-docs-writer` agent for ADR generation.
-- Telemetry-free usage analytics (opt-in, local only).
+> Forward-looking items that previously lived here moved to [`ROADMAP.md`](ROADMAP.md).
 
 ---
 

README.md

@@ -248,6 +248,20 @@ Configure per project in `.claude/project-config.json` under the `mcp` section.
 - [`install/README.md`](install/README.md) - Install guide and options
 - [`CONTRIBUTING.md`](CONTRIBUTING.md) - PR process and dev guidelines
 - [`CHANGELOG.md`](CHANGELOG.md) - Release notes
+- [`ROADMAP.md`](ROADMAP.md) - Planned and exploratory work
+
+---
+
+## Roadmap
+
+Forward-looking work lives in [`ROADMAP.md`](ROADMAP.md). Highlights:
+
+- **Near-term** - GitHub Issue auto-fetch (`gh issue view`) to match the existing JIRA snapshot path.
+- **Planned** - `/sd:setup` codebase scan (detected defaults instead of `<<placeholder>>`s) and an
+  optional `sd-docs-writer` agent for ADRs.
+- **Exploratory** - local-only, opt-in usage analytics.
+
+Shipped work is in [`CHANGELOG.md`](CHANGELOG.md).
 
 ---
 

ROADMAP.md

@@ -0,0 +1,46 @@
+# Roadmap
+
+Planned and exploratory work for specwright. Shipped items live in [`CHANGELOG.md`](CHANGELOG.md);
+this file is forward-looking only and intentionally non-binding - priorities shift as the engine is
+dogfooded on real projects.
+
+Current released version: **1.3.0** (see the [changelog](CHANGELOG.md) for what shipped).
+
+## Near-term
+
+Small, well-scoped items targeted at the next minor release.
+
+- **GitHub Issue auto-fetch (`gh issue view`)** - extend the JIRA-only ticket snapshot path so a
+  GitHub Issue `<ID>` argument is fetched and snapshotted into `04-artifacts/ticket/` the same way
+  JIRA tickets are. Mirrors the existing case in `sd-spec-architect`; GitHub and Linear are already
+  recognized as trackers, but their ticket content is not yet auto-fetched (it has to be pasted in).
+
+## Planned
+
+Larger items that each warrant a full `/sd:feature` spec before building.
+
+- **`/sd:setup` codebase scan** - pre-fill `constitution.md` (architectural rules, conventions) and
+  `CLAUDE.md` from sampled source files instead of leaving `<<placeholder>>`s, with an optional
+  `paths.layers` map in `project-config.json`. Turns first-run setup from blank-template into
+  detected-defaults.
+- **`sd-docs-writer` agent** - an optional subagent that authors Architecture Decision Records (ADRs)
+  and architecture docs from spec artifacts, promoting durable `.specs/` decisions into human-facing
+  documentation.
+
+## Exploratory
+
+Ideas under consideration; no committed timeline.
+
+- **Local-only usage analytics** - opt-in, telemetry-free counters (kept on disk, never transmitted)
+  to surface which workflows and gates get used most.
+
+## Non-goals
+
+specwright stays a generic, stack-agnostic engine. Project-specific commands, hardcoded stack
+commands (`dotnet test`, `npm test`), and anything that couples the engine to one language or
+framework are explicit non-goals - all project specifics are read at runtime from `CLAUDE.md`,
+`constitution.md`, and `project-config.json`. See [`docs/architecture.md`](docs/architecture.md).
+
+---
+
+Have a request or want to pick something up? Open an issue or see [`CONTRIBUTING.md`](CONTRIBUTING.md).