Skip to content
This repository was archived by the owner on Apr 5, 2026. It is now read-only.

CHANGELOG.md

Latest commit

 

History

History
156 lines (118 loc) · 9.93 KB

CHANGELOG.md

File metadata and controls

156 lines (118 loc) · 9.93 KB
Raw

Changelog

v2.2.0 -- 2026-02-28

Rule lifecycle management for the autolearn system.

Added

  • Rule lifecycle metadata format (PR #126): ADR-0014 defines per-entry metadata (**Added:**, **Source:**, **Status:**, **Last relevant:**, **See also:**), deprecation states, and archive strategy
  • Archive directory (PR #126): claude/rules/archive/ for deprecated entries (not loaded into sessions, frees context tokens)
  • Frontmatter extensions (PR #126): entry_count and last_updated fields in Tier 2 rules file frontmatter
  • Metadata PoC (PR #127): 10 proof-of-concept entries annotated with lifecycle metadata (5 AP, 5 KG)
  • Duplicate resolution (PR #127): AP#27 superseded by KG#17, archived; swagger cluster cross-referenced (5 entries)
  • Rules audit workflow (PR #128): /reflect option 5 for health check -- parses entries, generates report, identifies stale/duplicate entries, proposes actions
  • Last-relevant tracking (PR #128): /reflect quick and session workflows update **Last relevant:** timestamps on entries applied during the session

Changed

  • Autolearn-patterns entry count: 76 -> 75 (AP#27 archived)

v2.1.0 -- 2026-02-28

Governance and quality gates for the autolearn system.

Added

  • Tiered rule governance (PR #117): core-principles.md (Tier 0, immutable) and error-policy.md (Tier 1, governed) rules files with YAML frontmatter tier metadata
  • SessionStart health checks (PR #118): symlink integrity verification and CLAUDE.md detection at session start
  • Pre-commit verification (PR #119): build/test/lint gates before commit in workflow preferences
  • Fix-forward workflow (PR #120): error-policy.md with zero-tolerance fix-forward, replaces "pre-existing" classification
  • Template quality gates (PR #121): CI scaffolding templates include lint and test verification steps
  • Autolearn scope-aware routing (PR #122): in DevKit, write Tier 2 rules directly; in projects, write to MCP Memory and create DevKit issues for universal learnings
  • Rule validation pipeline (PR #123): five-stage gate for proposed rules (dangerous pattern scan, core principles check, conflict check, risk classification, storage decision) in references/validation-pipeline.md
  • Propagation verification (PR #124): /devkit-sync verify checks all active projects for DevKit update propagation via symlink health; SessionStart reports rule file changes after pull
  • /devkit-sync promote subcommand for graduating local patterns to universal rules
  • /devkit-sync update subcommand for version checking and upgrading

Changed

  • Autolearn workflows (quick-reflect.md, session-review.md) now include validation and scope assessment steps
  • update-knowledge.md requires DevKit context (context guard rejects non-DevKit sessions)
  • Rules file count increased from 8 to 10

v2.0.0 -- 2026-02-25

v2.0 represents a major architectural shift from a bash-centric toolkit to a cross-platform, multi-tier system with formal versioning.

Added

  • Three-tier settings architecture (ADR-0012): User > DevSpace > Project cascade
  • Dual-language scripting strategy (ADR-0013): PowerShell primary, bash legacy
  • Cross-platform path resolution via ~/.devkit-config.json
  • Forge abstraction layer for GitHub/GitLab operations
  • Project registry for multi-project coordination
  • Local overrides via .local.md pattern (gitignored, machine-specific)
  • SessionStart hardening: rate limiting (1/hour), lock-file awareness, pull logging
  • Auto-push prompt after /reflect sessions
  • Version-tagged releases with VERSION file as single source of truth
  • SessionStart version check: notifies when a newer DevKit release is available
  • devkit update command via /devkit-sync skill (check version, upgrade to tag or latest)
  • devkit promote command for graduating local patterns to universal rules

Version Policy

  • MAJOR: Breaking changes to rules, skill interfaces, or sync protocol
  • MINOR: New skills, agents, or non-breaking rule additions
  • PATCH: Bug fixes, documentation, pattern additions

v1.2.0 -- 2026-02-21

Fixed

  • claude/CLAUDE.md: replaced YOUR_PLATFORM placeholder with actual value and substitution note
  • METHODOLOGY.md: added Windows warning for BMAD/Spec Kit tools (see known-gotchas #42-44)
  • known-gotchas.md: renumbered contiguously 1-46 (was non-contiguous with gaps at 8-9, 13, 40, 42, 44 and #47 out of order)
  • Cross-references to gotcha numbers updated in autolearn-patterns.md and workflow-preferences.md
  • AGENT-WORKFLOW-GUIDE.md: replaced Python pseudo-code agent examples with correct .claude/agents/*.md format

Added

  • CI: README skill count accuracy check (fails if count doesn't match claude/skills/ directories)
  • CI: verify.sh skill list accuracy check (fails on missing directories, warns on unlisted skills)
  • profiles/ directory for Kit 2 stack profiles
  • project-templates/ directory for Kit 3 scaffolding
  • docs/ and machine/ directories for guides and snapshots
  • PowerShell stub files: setup.ps1, bootstrap.ps1, stack.ps1, new-project.ps1, verify.ps1, lib/*.ps1
  • setup/lib/ui.ps1: console output library (Write-Section/Step/OK/Warn/Fail, Write-VerifyTable, Read-Required/Confirm/Menu, Invoke-ManualChecklist)
  • setup/lib/checks.ps1: prerequisite and tool detection library (Test-Tool, Test-HyperV, Test-WSL2, Test-Virtualization, Test-DeveloperMode, Test-WindowsVersion, Test-ClaudeAuth/Skill/MCP, Test-DockerRunning/WSLBackend, Test-Credential, Get-PreflightStatus)
  • setup/lib/install.ps1: winget and manual install wrappers (Install-WingetPackage/Packages, Install-VSCodeExtension/Extensions, Invoke-ManualInstall, Export-WingetManifest, Export-VSCodeExtensions)
  • setup/lib/credentials.ps1: Windows Credential Manager integration (Set/Get/Test/Remove-DevkitCredential, Invoke-CredentialCollection with validation and secure input)
  • setup/setup.ps1: main menu entry point with -Kit parameter for direct dispatch, version display, quick status check
  • machine/winget.json: curated winget export (25 dev packages, personal apps removed)
  • machine/git-config.template: gitconfig template with YOUR_NAME/YOUR_EMAIL placeholders
  • machine/manual-requirements.md: reference for non-automatable setup steps (Hyper-V, WSL2, Docker config, Dev Mode)
  • setup/backup.ps1: refresh machine snapshot files from current state with diff summary
  • setup/bootstrap.ps1 phases 1-2: pre-flight checks (Windows version, Hyper-V, WSL2, virtualization, Developer Mode) and core tool installs from machine/winget.json + vscode-extensions.txt
  • setup/bootstrap.ps1 phases 3-4: git config from template, devspace directory setup with ~/.devkit-config.json, PowerShell profile alias, credentials collection via Windows Credential Manager
  • setup/bootstrap.ps1 phases 5-6: AI layer deploy (Claude Code npm install, skills/rules/agents/hooks with hash-based overwrite, CLAUDE.md placeholder substitution) and full verification table with next steps
  • docs/BOOTSTRAP.md: step-by-step new machine setup guide with troubleshooting section
  • setup/lib/profiles.ps1: profile format parser with YAML frontmatter, dependency resolution, and cycle detection
  • project-templates/concept-brief.md: project vision capture template for Kit 3 scaffolding
  • project-templates/claude-md-template.md: fallback CLAUDE.md template for new projects
  • project-templates/github-labels.json: standard label set (13 labels) for new GitHub repos
  • profiles/go-cli.md: base Go profile (winget, linters, VS Code extensions, cross-compilation)
  • profiles/go-web.md: extended Go+Web profile (buf, gRPC, REST client, Docker deployment)
  • profiles/iot-embedded.md: ESP32/ESPHome profile (uv-managed tools, OTA/serial flashing, sensor patterns)
  • setup/stack.ps1: Kit 2 profile selection and installer (-List, -ShowProfile, -Install, -Force flags)
  • setup/new-project.ps1 steps 1-2: concept collection (interactive + file), project scaffolding (git, GitHub, directories, labels, workspace)
  • setup/new-project.ps1 steps 3-4: Claude-generated CLAUDE.md (with template fallback), Phase 0 issue creation, workspace open

Changed

  • Bash setup scripts moved to setup/legacy/ with deprecation headers (PowerShell primary)
  • SKILLS-ECOSYSTEM.md: expanded Chat skill installation guide with rationale and sync process
  • devspace/CLAUDE.md moved to project-templates/workspace-claude-md-template.md

Removed

  • go-development SKILL.md: removed network_security_patterns section (SubNetree-specific content)

v1.1.0 -- 2026-02-17

Removed

  • coordination-sync, research-mode, dashboard, pm-view, dev-mode skills (moved to SubNetree project -- too project-specific for a general toolkit)

Fixed

  • settings.template.json: JSON syntax errors (missing commas on lines 17, 75)
  • settings.template.json: removed hardcoded Windows drive path (Read(//d/**))
  • AUTOMATION-SETUP.md: fixed Claude.md -> CLAUDE.md capitalization (3 instances)
  • SessionStart.sh: removed stale D:/DevSpace/.coordination/ references
  • verify.sh: now checks all 9 remaining skills (was only checking 5 of 14)

Changed

  • devspace/CLAUDE.md converted to template with generic placeholders
  • memory-seeds.md converted to example with generic entity names
  • claude/CLAUDE.md OS line made generic (was hardcoded to Windows MSYS_NT)
  • settings.template.json: removed redundant granular permissions, trimmed plugin list to core set
  • README.md: added Quick Start, What's Included section, updated skill inventory
  • METHODOLOGY.md: updated tool references for removed skills
  • SessionStart.sh: simplified to generic CLAUDE.md detection only

Added

  • GitHub Actions CI workflow: markdown lint + skill routing validation
  • CHANGELOG.md

v1.0.0 -- 2026-02-17

Initial release. 101 files: 5 rules (70+ patterns, 47+ gotchas), 14 skills, 6 agent templates, hooks, setup scripts, MCP config, project templates, and development methodology.