Skip to content

docs: visual explainer of v1.x to v3.1.1 evolution#737

Merged
robertDouglass merged 3 commits intoPriivacy-ai:mainfrom
AlexU-A:docs/version-evolution-visual
Apr 22, 2026
Merged

docs: visual explainer of v1.x to v3.1.1 evolution#737
robertDouglass merged 3 commits intoPriivacy-ai:mainfrom
AlexU-A:docs/version-evolution-visual

Conversation

@AlexU-A
Copy link
Copy Markdown
Contributor

@AlexU-A AlexU-A commented Apr 21, 2026

Summary

  • Two self-contained HTML pages for the spec-kitty docs site, styled to match the project's own design system
  • Evolution infographic (docs/assets/spec-kitty-evolution-v1-to-v3.html): technical evolution from v1.0.0 through v3.1.1
  • Public backlog (docs/assets/spec-kitty-backlog.html): 96 open issues organized into 9 strategic themes

Design system alignment

Both pages use spec-kitty's palette and patterns extracted from docs/templates/spec-kitty/public/main.css:

  • Baby-blue #A7C7E7 page background, creamy-white #FFFDF7 card surfaces
  • Sunny-yellow #FFF275 card top borders, grassy-green #7BB661 headings
  • 12px border-radius cards with subtle shadow, hover lift
  • System font stack (no external font dependencies)
  • Dark mode via prefers-color-scheme with spec-kitty dark tokens
  • Page nav bar with logo linking both pages

Evolution page covers

  • v1.x: PyPI stable release, orchestrator externalization, dependency hardening
  • v2.x: Event architecture, ADR sprint (13-21), skills pack (6 to 8), promotion to stable main
  • v3.x: Architecture redesign — event log authority, MissionContext, thin shims, ~2,000 lines removed
  • 3 architecture evolution diagrams: State management, command execution, and feature detection
  • Agent ecosystem: All 12 agents, config-driven management, 4 mission types
  • Stats dashboard: 12 metrics covering commits, removals, deduplication, ADRs, and skills

Backlog page covers

  • 96 open issues across 9 themes: SaaS/Multi-Tenant, Doctrine, UI/DX, Agent Intelligence, Intake/Discovery, Workflow, Architecture, Bugs, and Quick Wins
  • KPI dashboard with issue counts, theme distribution, priority breakdown
  • Filterable by theme with anchor navigation

Files

  • docs/assets/spec-kitty-evolution-v1-to-v3.html
  • docs/assets/spec-kitty-backlog.html

Open in any browser, no dependencies.

Test plan

  • Open both HTML files in a browser and verify they render correctly
  • Check responsive layout at mobile widths
  • Verify both light and dark mode themes
  • Verify logo renders in the nav bar
  • Verify nav links between both pages work

🤖 Generated with Claude Code

AlexU-A and others added 3 commits April 21, 2026 10:08
Self-contained HTML infographic covering all major architectural changes,
new features, and breaking changes across the three major version streams.
Created as a cheat sheet for Alex ahead of the spec-kitty team call.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace blueprint dark theme with spec-kitty's own palette (baby-blue
background, creamy-white cards, sunny-yellow borders, grassy-green
headings). Add page nav with logo linking both docs. Support dark mode
via prefers-color-scheme. Remove Google Fonts dependency in favor of
system font stack.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Darken --grassy-green (#7BB661 → #1f5a1f), --text-dim (#546e7a →
#37505e), and --v3 (#5a9a3e → #3d7a28) in light mode. All text-on-
background pairs now meet WCAG AA (4.5:1+). Dark mode was already
compliant.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@robertDouglass robertDouglass left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alex, thank you for the creative contribution here. These two visual pages add real character to the docs, and the presentation makes the backlog and version evolution much easier to understand quickly.

@robertDouglass robertDouglass merged commit bb01e5d into Priivacy-ai:main Apr 22, 2026
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.

2 participants