github Adityaraj0421/naksha-studio v5.0.0
v5.0.0 — Project Memory & Design Agent

7 hours ago

What's new

Naksha now remembers your project. A persistent memory system lets you capture design constraints, browser research findings, and component patterns once — and have them flow automatically into every subsequent design command.

Two new commands

/naksha-browse <url> — Browser-vision design research. Captures a live URL via Playwright, extracts layout patterns, typography, color palette, and UX patterns, then writes structured browser_findings to .naksha/project.json. Context is automatically injected into future design commands. Skips gracefully without Playwright MCP.

/naksha-remember <constraint> — Persist a design constraint or component pattern. Classifies input as constraint (grid, WCAG level, no-dark-mode) or component_pattern and patches .naksha/project.json.

v5 memory schema

.naksha/project.json gains three new fields:

  • constraints: {} — key/value design constraints
  • component_patterns: [] — named component patterns
  • browser_findings: [] — FIFO queue (cap 20) of browser research captures

Stop hook memory processor

The Stop hook is now a full memory-write processor. Commands emit <!-- naksha-memory-update { ... } --> blocks during sessions; on session end the hook applies them to .naksha/project.json automatically.

Memory context in 5 existing commands

/design, /brand-kit, /design-system, /design-score, /accessibility-audit, and /naksha-status all read project memory automatically — no copy-pasting context.

Pipeline v5

New pipeline YAML step types (browser, memory_write), two new pipeline templates (research-and-design, design-score-track), and /pipeline new <name> wizard. See docs/pipeline-failure-modes.md for failure handling.

Migrations

  • /naksha-init detects v4 projects on re-run and upgrades to v5 schema automatically (no data lost)
  • /naksha-doctor adds a Memory row to the health report and --fix guidance for v4 → v5 migration
  • All 4 platform adapters (Cursor, Windsurf, Gemini CLI, Copilot) document the v5 commands

New quality gate

guard-counts.sh — asserts canonical command count and knowledge-line floor across all adapters, prevents metadata drift from silently recurring.


Stats: 62 commands · 26 roles · 15,261 knowledge lines

Full notes: CHANGELOG.md

Don't miss a new naksha-studio release

NewReleases is sending notifications on new releases.