brain/CHANGELOG.md

Changelog

brain-v1.1 — 2026-05-11

Added

• docs/brain-plugin-routing.md v1.0 — normative document for plugin selection in brain repo. Resolves 8 sources of ambiguity (К1-К8 from design spec). Covers reestr, disabled-in-brain soft-rule (FD/UPM), routing table (17 overlaps + 3 tie-breakers), categorization (5 categories × 22 plugins), install checklist (5 sub-procedures), update procedure.
• docs/superpowers/specs/2026-05-11-brain-plugin-routing-design.md — design spec backing routing.md v1.0.
• docs/superpowers/plans/2026-05-11-brain-plugin-routing.md — implementation plan.
• .brain-version self-marker created (was missing in v1.0 bootstrap — closed as part of v1.1 bump).
• target field (ENUM user-level/consumer/user-level+consumer) in user-level-files/plugins-manifest.json — implements D9 from design spec.
• category field in plugins-manifest (from routing.md §4.1).
• Two new brain manifest entries: skill-creator@claude-plugins-official + claude-code-setup@claude-plugins-official — closes Phase 0 install drift (К3).

Changed

• CLAUDE.md brain root — version brain-v1.0 → brain-v1.1; new section «Выбор плагина и установка нового» linking to routing.md and noting disabled-in-brain soft-rule.
• user-level-files/settings-fragment.json — enabledPlugins extended with skill-creator and claude-code-setup (matching user-level ~/.claude/settings.json state after Phase 0).
• manifest.json — version bumped to brain-v1.1.

Notes

• PSR template (project-files/docs/Plugin_stack_rules.template.md) is NOT modified — it remains the consumer-side ruleset.
• D11: .brain-version + manifest.json + CLAUDE.md version line + CHANGELOG bumped atomically with brain-plugin-routing v1.0 implementation.

brain-v1.0 — 2026-05-11 (planned)

Extracted artifacts

project-files/ (для consumer-репозиториев):

• CLAUDE.md.template (Лидерра v1.86, 266 строк)
• docs/Pravila_raboty_Claude.template.md (v1.10, 720 строк)
• docs/Plugin_stack_rules.template.md (v1.7, 916 строк)
• docs/Tooling.template.md (v1.15, 613 строк)
• docs/CHANGELOG_claude_md.template.md
• docs/visualizations/hooks-skills-plugins-map.html (3122 строки)
• .mcp.json.template (playwright + github + semgrep; laravel-boost dropped — project-specific)

user-level-files/ (для ~/.claude/):

• 10 hook-скриптов (skill-marker, skill-check, economy-mode×4, economy-state-guard×2, economy-postcompact, economy-verifier, economy-self-check×2)
• settings-fragment.json (enabledPlugins + permissions + hooks)
• marketplaces.json (3 marketplace: anthropics/claude-plugins-official, obra/superpowers, nextlevelbuilder/ui-ux-pro-max-skill)
• plugins-manifest.json (4 плагина с pinned gitCommitSha)
• mcp-user.template.json (magic с <<MAGIC_API_KEY>> placeholder)

scripts/ (sync tooling):

• install.sh — orchestrator (project/user mode + plugins + MCP)
• verify.sh — sha256 integrity + Python syntax
• extract.sh — reverse sync (consumer → brain)
• lib/common.sh, merge-settings.sh, merge-mcp.sh, setup-secrets.sh, install-plugins.sh

Security

• API_KEY (21st.dev) masking при extraction (placeholder + interactive prompt)
• gitleaks self-scan — обязательный gate перед первым commit'ом
• CI workflow с gitleaks на каждый push

Known limitations

• Plugin SHA pinning через claude plugin install — best-effort (warn on mismatch, не fail)
• На VSCode-extension Claude Code команды claude plugin install могут быть недоступны — fallback на прямое редактирование JSON