Skip to content

Reconcile doc counts to disk (SW-1) - #15

Merged
developzoneio merged 1 commit into
developfrom
docs/sw1-doc-consistency
Jun 23, 2026
Merged

Reconcile doc counts to disk (SW-1)#15
developzoneio merged 1 commit into
developfrom
docs/sw1-doc-consistency

Conversation

@developzoneio

Copy link
Copy Markdown
Owner

SW-1 (E1) — Documentation single-source-of-truth + consistency fix

Fixes the count contradictions reported in Jira SW-1. After auditing disk vs. every published number, only two real contradictions existed, both in README.md.

Changes

File Change
README.md Tagline Ten/five -> Eleven/six; /sd:feature gate count 4 -> 3; header Hard gates -> Gates; +2 pointer comments to the authoritative source
docs/architecture.md Marked the existing asset-count block and gate-count table as AUTHORITATIVE (the SSOT anchor). No numbers changed — already correct
commands/bug.md One narrow note: Gate 3a is the alternative-path form of Gate 3, so the gate count is 5
CHANGELOG.md Entry under [Unreleased] -> Fixed

Ground truth (verified on disk)

11 commands - 6 agents - 3 hooks (x2 platforms) - 6 skills - 9 templates (4 setup + 5 spec) - gates: feature 3, bug 5, rca 3, refactor 6, perf 8.

Verification

  • Tree-wide grep: 11 / 6 / 3 / 9 / 6 and /sd:feature = 3 consistent across all live docs (README, CLAUDE.md, CONTRIBUTING.md, architecture.md, usage.md, install/README.md).
  • Remaining 10/5 hits live only in frozen docs/history/ and docs/superpowers/plans/ artifacts that record past transitions — intentionally untouched.
  • No .ps1 files touched (ASCII gate N/A).

Out of scope

  • E3 enforcement / CI guard against regression (separate ticket; ticket notes "best done together with E3").
  • The untracked, generated docs/project-knowledge/ scan — already disk-accurate.
  • The systemic "N hard gates" vs. "only some labeled HARD" labeling fuzz in perf/refactor.

🤖 Generated with Claude Code

Fix the only two count contradictions, both in README.md: the stale
"Ten/five" tagline (-> Eleven/six) and /sd:feature gate count (4 -> 3).
Designate docs/architecture.md as the authoritative inventory source
(asset + gate counts) with pointer comments from README, and clarify
that /sd:bug Gate 3a is the alternative-path form of Gate 3 (count = 5).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@developzoneio
developzoneio merged commit 16d7714 into develop Jun 23, 2026
4 checks passed
@developzoneio
developzoneio deleted the docs/sw1-doc-consistency branch June 23, 2026 15:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant