diff --git a/CHANGELOG.md b/CHANGELOG.md
index 813dd02..973f0cb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,17 @@ Gira uses SemVer tags. User-facing features normally increment the minor version
 
 ## Unreleased
 
+## v1.17.0 - 2026-05-24
+
+- Added optional issue-backed feature map commands with the short `gira feat`
+  alias so operators and agents can list feature records, check feature map
+  health, and inspect whether a work issue is linked to a capability.
+- Added the feature map convention docs for GitHub issue-backed capability
+  records, keeping GitHub Projects as visibility views and GitHub issues as the
+  canonical source of truth.
+- Added stable JSON contracts for `feature-map-list/v1`,
+  `feature-map-check/v1`, and `feature-map-for/v1`.
+
 ## v1.16.0 - 2026-05-19
 
 - Added milestone lifecycle commands for creating, listing, assigning, planning,
diff --git a/docs-site/command-reference.md b/docs-site/command-reference.md
index e9e44e2..c6088e8 100644
--- a/docs-site/command-reference.md
+++ b/docs-site/command-reference.md
@@ -12,7 +12,7 @@ Usage:
 gira feature check [--repo OWNER/REPO] [--limit N] [--json]
 ```
 
-Since: `v1.18.0`
+Since: `v1.17.0`
 
 Flags:
 
@@ -40,7 +40,7 @@ Usage:
 gira feature for ISSUE [--repo OWNER/REPO] [--limit N] [--json]
 ```
 
-Since: `v1.18.0`
+Since: `v1.17.0`
 
 Flags:
 
@@ -69,7 +69,7 @@ Usage:
 gira feature list [--repo OWNER/REPO] [--limit N] [--json]
 ```
 
-Since: `v1.18.0`
+Since: `v1.17.0`
 
 Flags:
 
diff --git a/internal/gira/command_registry.go b/internal/gira/command_registry.go
index f6abd9d..f5cc69c 100644
--- a/internal/gira/command_registry.go
+++ b/internal/gira/command_registry.go
@@ -128,7 +128,7 @@ func CoreCommandSpecs() []CommandSpec {
 			Path:    []string{"feature", "list"},
 			Summary: "List optional issue-backed feature or capability records.",
 			Usage:   "gira feature list [--repo OWNER/REPO] [--limit N] [--json]",
-			Since:   "v1.18.0",
+			Since:   "v1.17.0",
 			Flags: []FlagSpec{
 				{Name: "--repo", Summary: "Target GitHub repo in OWNER/REPO format."},
 				{Name: "--limit", Summary: "Max issues to inspect. Default: 1000."},
@@ -144,7 +144,7 @@ func CoreCommandSpecs() []CommandSpec {
 			Path:    []string{"feature", "check"},
 			Summary: "Validate optional feature map records and work links without mutating GitHub.",
 			Usage:   "gira feature check [--repo OWNER/REPO] [--limit N] [--json]",
-			Since:   "v1.18.0",
+			Since:   "v1.17.0",
 			Flags: []FlagSpec{
 				{Name: "--repo", Summary: "Target GitHub repo in OWNER/REPO format."},
 				{Name: "--limit", Summary: "Max issues to inspect. Default: 1000."},
@@ -160,7 +160,7 @@ func CoreCommandSpecs() []CommandSpec {
 			Path:    []string{"feature", "for"},
 			Summary: "Show which feature or capability a work issue is linked to.",
 			Usage:   "gira feature for ISSUE [--repo OWNER/REPO] [--limit N] [--json]",
-			Since:   "v1.18.0",
+			Since:   "v1.17.0",
 			Flags: []FlagSpec{
 				{Name: "--repo", Summary: "Target GitHub repo in OWNER/REPO format."},
 				{Name: "--issue", Summary: "Work issue number. Can also be numeric positional."},