npm - start-vibing - Versions diffs - 4.4.11 → 4.4.13 - Mend

start-vibing 4.4.11 → 4.4.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/package.json +1 -1
package/template/.claude/CLAUDE.md +117 -92
package/template/CLAUDE.md +78 -57

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "start-vibing",
-	"version": "4.4.11",
+	"version": "4.4.13",
 	"description": "Setup Claude Code with 9 plugins, 6 community skills, and 8 MCP servers. Parallel install, auto-accept, superpowers + ralph-loop. e2e-audit 0.2.0 refactor (skill-only, no agents): SessionStart hook + slash command make the skill keyword-invokable (\"e2e audit\", \"roda o e2e\", \"integration test\", \"test coverage gaps\"). Source-first discovery via detect-stack, discover-routes (Next app/pages/Remix/SvelteKit/Nuxt/Astro), discover-api-surface (HTTP handlers, tRPC procedures, GraphQL, server actions, middleware auth), inventory-existing-tests (preserve prior corpus + sha256 drift hash), and detect-uncovered (branch-diff vs origin/main finds changes not covered by existing specs). Report-then-ask between mapping and Playwright run; post-run-feedback report before writing findings. SHOT+TRACE+ASSERT+SOURCE evidence quad per non-meta finding; meta rules (coverage-gap-*, uncovered-*, test-drift, stack-detect, post-run-feedback) exempt. verify-audit.sh enforces schema + quad. Generic (no project leakage). super-design 0.7.0 carries over.",
 	"type": "module",
 	"bin": {

package/template/.claude/CLAUDE.md CHANGED Viewed

@@ -5,16 +5,34 @@ For user-facing project rules, see `/CLAUDE.md`.
 ---
+## Language Policy (HARD RULE)
+> **ENGLISH ONLY — for everything Claude produces — UNLESS the user explicitly asks for another language in the current request.**
+Applies to **every** output, no exceptions beyond an explicit user override:
+- Chat replies, status updates, summaries, questions back to the user
+- Code (identifiers, variables, function/class names, type names)
+- Comments, JSDoc, docstrings
+- Commit messages, PR titles, PR descriptions, branch names
+- Documentation (`/docs/**`, README, CLAUDE.md updates, changelogs, ADRs)
+- Test names, error messages, log messages, CLI help strings
+- File and folder names, configuration keys
+The user may write to Claude in Portuguese, Spanish, or any other language — Claude still responds and writes in English unless the user explicitly says e.g. "responda em português", "write this in Spanish". An override applies only to the current request; revert to English on the next turn. Never mix English + another language in the same output. If unsure whether a request is an override, default to English and ask one short clarifying question.
+---
 ## What start-vibing v4 Installs
 start-vibing is a CLI (`npx start-vibing`) that sets up Claude Code with a complete development system in ~30 seconds:
-| Component | Count | Installation Method |
-|-----------|-------|-------------------|
-| **MCP Servers** | 8 | `claude mcp add` (parallel, ~20s) |
-| **Plugins** | 9 | `claude plugin install` (parallel, auto-accept, ~3s) |
-| **Community Skills** | 5 | Direct HTTPS download from GitHub (~0.3s) |
-| **Template Files** | ~30 | File copy (agents, skills, config, CLAUDE.md) |
+| Component            | Count | Installation Method                                  |
+| -------------------- | ----- | ---------------------------------------------------- |
+| **MCP Servers**      | 8     | `claude mcp add` (parallel, ~20s)                    |
+| **Plugins**          | 9     | `claude plugin install` (parallel, auto-accept, ~3s) |
+| **Community Skills** | 5     | Direct HTTPS download from GitHub (~0.3s)            |
+| **Template Files**   | ~30   | File copy (agents, skills, config, CLAUDE.md)        |
 ### Installation Architecture
@@ -32,14 +50,14 @@ All phases run best-effort. MCP and plugin failures are non-blocking — `settin
 ### CLI Options
-| Flag | Effect |
-|------|--------|
-| `--force` | Overwrite all files (including custom ones) |
-| `--new` | Start fresh Claude session (default: resume last) |
-| `--no-claude` | Skip Claude Code installation and launch |
-| `--no-mcp` | Skip MCP server installation |
-| `--no-skills` | Skip community skills installation |
-| `--no-update-check` | Skip version check |
+| Flag                | Effect                                            |
+| ------------------- | ------------------------------------------------- |
+| `--force`           | Overwrite all files (including custom ones)       |
+| `--new`             | Start fresh Claude session (default: resume last) |
+| `--no-claude`       | Skip Claude Code installation and launch          |
+| `--no-mcp`          | Skip MCP server installation                      |
+| `--no-skills`       | Skip community skills installation                |
+| `--no-update-check` | Skip version check                                |
 ---
@@ -58,13 +76,13 @@ All phases run best-effort. MCP and plugin failures are non-blocking — `settin
 ## Agents (5 Active Subagents)
-| Agent | Model | Purpose |
-|-------|-------|---------|
-| **research-web** | sonnet | Researches best practices (2025-2026) with ontology-based structuring, output to `/docs/research/` |
-| **documenter** | sonnet | Analyzes sessions via git log/diff, writes changelog + technical docs + ADRs to `/docs/` |
-| **commit-manager** | haiku | Manages git commits, conventional format, merge workflow |
-| **claude-md-compactor** | sonnet | Compacts CLAUDE.md when it exceeds 40k chars |
-| **tester-unit** | sonnet | Creates unit tests with Vitest for new functions and utilities |
+| Agent                   | Model  | Purpose                                                                                            |
+| ----------------------- | ------ | -------------------------------------------------------------------------------------------------- |
+| **research-web**        | sonnet | Researches best practices (2025-2026) with ontology-based structuring, output to `/docs/research/` |
+| **documenter**          | sonnet | Analyzes sessions via git log/diff, writes changelog + technical docs + ADRs to `/docs/`           |
+| **commit-manager**      | haiku  | Manages git commits, conventional format, merge workflow                                           |
+| **claude-md-compactor** | sonnet | Compacts CLAUDE.md when it exceeds 40k chars                                                       |
+| **tester-unit**         | sonnet | Creates unit tests with Vitest for new functions and utilities                                     |
 ### Agent Workflow Order
@@ -79,6 +97,7 @@ Agents are dispatched via the `Agent` tool with `subagent_type` matching agent n
 The research-web agent outputs findings to `/docs/research/[topic].md` (NOT to `.claude/skills/research-cache/`).
 **Research flow:**
 1. Check `/docs/research/` for existing findings (reuse if fresh < 3 months)
 2. Build ontology map (concepts → relationships → constraints)
 3. Search with `[topic] [aspect] [2025-2026] [context]` queries
@@ -86,6 +105,7 @@ The research-web agent outputs findings to `/docs/research/[topic].md` (NOT to `
 5. Save structured output to `/docs/research/`
 **For UI/UX tasks, the agent also runs:**
 - Competitor analysis (3-5 competitors, heuristic evaluation)
 - Design system pattern check (shadcn/ui, Radix, WCAG 2.1)
 - User flow mapping (happy path + 2 error paths)
@@ -96,6 +116,7 @@ The research-web agent outputs findings to `/docs/research/[topic].md` (NOT to `
 The documenter agent runs after implementation, analyzes the session, and writes structured docs to `/docs/`.
 **Documentation flow:**
 1. Run `git log` + `git diff` to analyze what changed
 2. Classify changes: per-commit, per-feature, per-session
 3. Mini-research for technologies used (check `/docs/research/` first, else 1-2 queries)
@@ -103,6 +124,7 @@ The documenter agent runs after implementation, analyzes the session, and writes
 5. Update all indexes (`/docs/index.md` + per-folder indexes)
 **Output structure:**
 ```
 /docs/
 ├── index.md              # Root index
@@ -121,6 +143,7 @@ The documenter agent runs after implementation, analyzes the session, and writes
 ```
 **Writing rules:**
 - Self-contained sections (AI RAG chunk retrieval)
 - What→Why→How progression (humans first)
 - Before→After pattern for all changes (mandatory)
@@ -136,22 +159,22 @@ Plugins are the primary extension mechanism. All 9 are installed in parallel wit
 ### Core Workflow Plugins
-| Plugin | Mechanism | Purpose |
-|--------|-----------|---------|
-| **superpowers** | Skills + commands | TDD, brainstorming, debugging, planning, code review, git worktrees |
-| **ralph-loop** | Stop hook + command | Iterative autonomous development loop with checkpoints |
-| **context7** | Skill + agent + MCP | Auto library docs — replaces manual context7 MCP server |
-| **code-simplifier** | Skill + command | Refine code for clarity, reduce nesting, improve naming |
+| Plugin              | Mechanism           | Purpose                                                             |
+| ------------------- | ------------------- | ------------------------------------------------------------------- |
+| **superpowers**     | Skills + commands   | TDD, brainstorming, debugging, planning, code review, git worktrees |
+| **ralph-loop**      | Stop hook + command | Iterative autonomous development loop with checkpoints              |
+| **context7**        | Skill + agent + MCP | Auto library docs — replaces manual context7 MCP server             |
+| **code-simplifier** | Skill + command     | Refine code for clarity, reduce nesting, improve naming             |
 ### Development Plugins
-| Plugin | Mechanism | Purpose |
-|--------|-----------|---------|
-| **typescript-lsp** | LSP server (auto) | Type diagnostics, go-to-definition, hover info |
-| **security-guidance** | PreToolUse hook (auto) | OWASP Top 10, vulnerability scan, blocks unsafe patterns |
-| **code-review** | `/code-review` command | Code quality analysis, PR review |
-| **commit-commands** | `/commit` command | Git commit, push, PR flows with conventional format |
-| **frontend-design** | `/frontend-design` command | Production-grade UI design with competitor research |
+| Plugin                | Mechanism                  | Purpose                                                  |
+| --------------------- | -------------------------- | -------------------------------------------------------- |
+| **typescript-lsp**    | LSP server (auto)          | Type diagnostics, go-to-definition, hover info           |
+| **security-guidance** | PreToolUse hook (auto)     | OWASP Top 10, vulnerability scan, blocks unsafe patterns |
+| **code-review**       | `/code-review` command     | Code quality analysis, PR review                         |
+| **commit-commands**   | `/commit` command          | Git commit, push, PR flows with conventional format      |
+| **frontend-design**   | `/frontend-design` command | Production-grade UI design with competitor research      |
 ### Plugin Installation Details
@@ -193,6 +216,7 @@ All file changes and git history persist between iterations. Best for multi-file
 ### Using Code Simplifier (POST-IMPLEMENTATION)
 After implementing, run `/simplify` to:
 - Reduce nesting and redundancy
 - Improve naming and readability
 - Replace nested ternaries with early returns
@@ -206,10 +230,10 @@ All 8 MCPs are installed in parallel via `claude mcp add -s user` (~20s total).
 ### Required MCPs (ALWAYS use these)
-| Server | Package | Purpose |
-|--------|---------|---------|
+| Server                | Package                                            | Purpose                                                                      |
+| --------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------- |
 | `sequential-thinking` | `@modelcontextprotocol/server-sequential-thinking` | Structured reasoning for multi-step tasks, architecture decisions, debugging |
-| `playwright` | `@playwright/mcp@latest` | Browser automation for UI verification, E2E tests, visual validation |
+| `playwright`          | `@playwright/mcp@latest`                           | Browser automation for UI verification, E2E tests, visual validation         |
 > These 2 are **non-negotiable**. Skipping them leads to poor planning and untested UIs.
@@ -217,27 +241,27 @@ All 8 MCPs are installed in parallel via `claude mcp add -s user` (~20s total).
 ### Standard MCPs
-| Server | Package | Transport | Purpose |
-|--------|---------|-----------|---------|
-| `memory` | `@modelcontextprotocol/server-memory` | stdio (npx) | Persistent knowledge graph across sessions |
-| `nextjs-devtools` | `next-devtools-mcp@latest` | stdio (npx) | Next.js runtime errors, routes, cache inspection |
-| `mongodb` | `@mongodb-js/mongodb-mcp-server` | stdio (npx) | MongoDB queries, schema inspection, aggregation |
-| `jira` | `@aashari/mcp-server-atlassian-jira` | stdio (npx) | Issue tracking, task management |
-| `git` | `mcp-server-git` | stdio (uvx) | Git operations, repo search, history, diffs |
-| `fetch` | `mcp-server-fetch` | stdio (uvx) | Fetch web pages as markdown |
+| Server            | Package                               | Transport   | Purpose                                          |
+| ----------------- | ------------------------------------- | ----------- | ------------------------------------------------ |
+| `memory`          | `@modelcontextprotocol/server-memory` | stdio (npx) | Persistent knowledge graph across sessions       |
+| `nextjs-devtools` | `next-devtools-mcp@latest`            | stdio (npx) | Next.js runtime errors, routes, cache inspection |
+| `mongodb`         | `@mongodb-js/mongodb-mcp-server`      | stdio (npx) | MongoDB queries, schema inspection, aggregation  |
+| `jira`            | `@aashari/mcp-server-atlassian-jira`  | stdio (npx) | Issue tracking, task management                  |
+| `git`             | `mcp-server-git`                      | stdio (uvx) | Git operations, repo search, history, diffs      |
+| `fetch`           | `mcp-server-fetch`                    | stdio (uvx) | Fetch web pages as markdown                      |
 ### Optional MCPs (install manually)
 These are shown to the user after setup but not auto-installed:
-| Server | Install Command |
-|--------|----------------|
+| Server   | Install Command                                                                     |
+| -------- | ----------------------------------------------------------------------------------- |
 | `github` | `claude mcp add --transport http -s user github https://api.githubcopilot.com/mcp/` |
-| `sentry` | `claude mcp add --transport http -s user sentry https://mcp.sentry.dev/mcp` |
-| `figma` | `claude mcp add --transport http -s user figma https://mcp.figma.com/mcp` |
-| `linear` | `claude mcp add --transport http -s user linear https://mcp.linear.app/sse` |
-| `stripe` | `claude mcp add --transport http -s user stripe https://mcp.stripe.com` |
-| `vercel` | `claude mcp add --transport http -s user vercel https://mcp.vercel.com` |
+| `sentry` | `claude mcp add --transport http -s user sentry https://mcp.sentry.dev/mcp`         |
+| `figma`  | `claude mcp add --transport http -s user figma https://mcp.figma.com/mcp`           |
+| `linear` | `claude mcp add --transport http -s user linear https://mcp.linear.app/sse`         |
+| `stripe` | `claude mcp add --transport http -s user stripe https://mcp.stripe.com`             |
+| `vercel` | `claude mcp add --transport http -s user vercel https://mcp.vercel.com`             |
 ---
@@ -260,13 +284,13 @@ Community skills are downloaded directly from GitHub raw URLs (the `skillsadd` n
 ### Installed Skills
-| Skill | Source Repo | Purpose |
-|-------|------------|---------|
-| **react-best-practices** | `vercel-labs/agent-skills` | React/Next.js performance optimization rules |
-| **web-design-guidelines** | `vercel-labs/agent-skills` | 100+ WCAG accessibility + UX audit rules |
-| **composition-patterns** | `vercel-labs/agent-skills` | Compound component and composition patterns |
-| **webapp-testing** | `anthropics/skills` | Real browser test execution with Playwright |
-| **mcp-builder** | `anthropics/skills` | Guide for building MCP servers |
+| Skill                     | Source Repo                | Purpose                                      |
+| ------------------------- | -------------------------- | -------------------------------------------- |
+| **react-best-practices**  | `vercel-labs/agent-skills` | React/Next.js performance optimization rules |
+| **web-design-guidelines** | `vercel-labs/agent-skills` | 100+ WCAG accessibility + UX audit rules     |
+| **composition-patterns**  | `vercel-labs/agent-skills` | Compound component and composition patterns  |
+| **webapp-testing**        | `anthropics/skills`        | Real browser test execution with Playwright  |
+| **mcp-builder**           | `anthropics/skills`        | Guide for building MCP servers               |
 ### Adding More Skills
@@ -294,12 +318,12 @@ curl -o .claude/skills/<name>/SKILL.md \
 Project-specific settings in `.claude/config/`:
-| File | Purpose |
-|------|---------|
-| `project-config.json` | Stack, structure, commands |
-| `quality-gates.json` | Quality check commands |
+| File                  | Purpose                        |
+| --------------------- | ------------------------------ |
+| `project-config.json` | Stack, structure, commands     |
+| `quality-gates.json`  | Quality check commands         |
 | `testing-config.json` | Test framework and conventions |
-| `security-rules.json` | Security audit rules |
+| `security-rules.json` | Security audit rules           |
 Agents read config files before acting. Do NOT hardcode project specifics — update the JSON files instead.
@@ -311,17 +335,17 @@ The `.claude/settings.json` file contains `enabledPlugins` which is the fallback
 ```json
 {
-  "enabledPlugins": {
-    "typescript-lsp@claude-plugins-official": true,
-    "security-guidance@claude-plugins-official": true,
-    "code-review@claude-plugins-official": true,
-    "commit-commands@claude-plugins-official": true,
-    "frontend-design@claude-plugins-official": true,
-    "superpowers@claude-plugins-official": true,
-    "ralph-loop@claude-plugins-official": true,
-    "context7@claude-plugins-official": true,
-    "code-simplifier@claude-plugins-official": true
-  }
+	"enabledPlugins": {
+		"typescript-lsp@claude-plugins-official": true,
+		"security-guidance@claude-plugins-official": true,
+		"code-review@claude-plugins-official": true,
+		"commit-commands@claude-plugins-official": true,
+		"frontend-design@claude-plugins-official": true,
+		"superpowers@claude-plugins-official": true,
+		"ralph-loop@claude-plugins-official": true,
+		"context7@claude-plugins-official": true,
+		"code-simplifier@claude-plugins-official": true
+	}
 }
 ```
@@ -359,6 +383,7 @@ The `.claude/settings.json` file contains `enabledPlugins` which is the fallback
 ### After Completing Work
 The documenter agent runs automatically after implementation:
 1. Analyzes git log/diff for the session
 2. Writes changelog + technical docs + ADRs as needed
 3. Updates all indexes
@@ -397,23 +422,23 @@ All implementations MUST:
 ## FORBIDDEN Actions
-| Action                         | Reason                       |
-| ------------------------------ | ---------------------------- |
-| Write in non-English           | ALL code/docs MUST be in EN  |
-| Skip typecheck                 | Catches runtime errors       |
-| Use `any` type                 | Defeats strict mode          |
-| Define types in `src/`         | Must be in `types/`          |
-| Commit directly to main        | Create feature/fix branches  |
-| Skip documenter after implementation | Changelog + docs are mandatory |
-| Mix doc types in one file      | Changelog ≠ technical ≠ decision |
-| Leave docs unlinked from index | Undiscoverable docs are useless |
-| Skip superpowers for features  | Use brainstorming + TDD      |
-| Skip code-simplifier           | Run /simplify post-implementation |
-| Use MUI/Chakra                 | Use shadcn/ui + Radix        |
-| Files > 400 lines              | MUST split into smaller      |
-| 'use client' at top level      | Push to leaf components only |
-| Waterfall data fetching        | Use Promise.all() for parallel |
-| Skip CLAUDE.md update          | MUST update after implementations |
+| Action                               | Reason                                                                                                                |
+| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| Speak/write in non-English           | EN ONLY (chat, code, docs, commits) — see Language Policy. Override only via explicit user request, current turn only |
+| Skip typecheck                       | Catches runtime errors                                                                                                |
+| Use `any` type                       | Defeats strict mode                                                                                                   |
+| Define types in `src/`               | Must be in `types/`                                                                                                   |
+| Commit directly to main              | Create feature/fix branches                                                                                           |
+| Skip documenter after implementation | Changelog + docs are mandatory                                                                                        |
+| Mix doc types in one file            | Changelog ≠ technical ≠ decision                                                                                      |
+| Leave docs unlinked from index       | Undiscoverable docs are useless                                                                                       |
+| Skip superpowers for features        | Use brainstorming + TDD                                                                                               |
+| Skip code-simplifier                 | Run /simplify post-implementation                                                                                     |
+| Use MUI/Chakra                       | Use shadcn/ui + Radix                                                                                                 |
+| Files > 400 lines                    | MUST split into smaller                                                                                               |
+| 'use client' at top level            | Push to leaf components only                                                                                          |
+| Waterfall data fetching              | Use Promise.all() for parallel                                                                                        |
+| Skip CLAUDE.md update                | MUST update after implementations                                                                                     |
 ---

package/template/CLAUDE.md CHANGED Viewed

@@ -18,6 +18,26 @@ UPDATE THIS WITH YOUR PROJECT DESCRIPTION
 ---
+## Language Policy (HARD RULE)
+> **ENGLISH ONLY — for everything Claude produces — UNLESS the user explicitly asks for another language in the current request.**
+This applies to **every** output, with **no exceptions** beyond an explicit user override:
+- Chat replies, status updates, summaries, questions back to the user
+- Code (identifiers, variables, function/class names, type names)
+- Comments, JSDoc, docstrings
+- Commit messages, PR titles, PR descriptions, branch names
+- Documentation (`/docs/**`, README, CLAUDE.md updates, changelogs, ADRs)
+- Test names, error messages, log messages, CLI help strings
+- File and folder names, configuration keys
+The user may write to Claude in Portuguese, Spanish, or any other language — **Claude still responds and writes in English** unless the user explicitly says e.g. "responda em português", "write this in Spanish", "use PT-BR for the docs". An override applies **only to the current request**; revert to English on the next turn unless re-confirmed. Mixing English + another language in the same output is forbidden.
+If unsure whether a request is an override, default to English and ask one short clarifying question.
+---
 ## Stack
 | Component  | Technology                 |
@@ -87,17 +107,17 @@ project-root/
 ## Key Plugins (9 installed)
-| Plugin | Purpose | Invocation |
-|--------|---------|------------|
-| **superpowers** | TDD, debugging, brainstorming, planning | Auto + `/brainstorming`, `/execute-plan` |
-| **ralph-loop** | Iterative autonomous dev loop | `/ralph-loop "task" --max-iterations 10` |
-| **context7** | Auto library docs (replaces MCP) | Auto-invokes on library mentions |
-| **code-simplifier** | Refine code quality post-implementation | `/simplify` or ask Claude |
-| **typescript-lsp** | Type diagnostics, go-to-def | Auto (LSP server) |
-| **security-guidance** | OWASP vulnerability scan | Auto (PreToolUse hook) |
-| **code-review** | PR analysis | `/code-review` |
-| **commit-commands** | Git commit, push, PR | `/commit` |
-| **frontend-design** | Production-grade UI design | `/frontend-design` |
+| Plugin                | Purpose                                 | Invocation                               |
+| --------------------- | --------------------------------------- | ---------------------------------------- |
+| **superpowers**       | TDD, debugging, brainstorming, planning | Auto + `/brainstorming`, `/execute-plan` |
+| **ralph-loop**        | Iterative autonomous dev loop           | `/ralph-loop "task" --max-iterations 10` |
+| **context7**          | Auto library docs (replaces MCP)        | Auto-invokes on library mentions         |
+| **code-simplifier**   | Refine code quality post-implementation | `/simplify` or ask Claude                |
+| **typescript-lsp**    | Type diagnostics, go-to-def             | Auto (LSP server)                        |
+| **security-guidance** | OWASP vulnerability scan                | Auto (PreToolUse hook)                   |
+| **code-review**       | PR analysis                             | `/code-review`                           |
+| **commit-commands**   | Git commit, push, PR                    | `/commit`                                |
+| **frontend-design**   | Production-grade UI design              | `/frontend-design`                       |
 ### Superpowers Workflow (USE THIS)
@@ -121,12 +141,12 @@ Claude works autonomously until the task is complete or hits the iteration limit
 ## Agent System (4 Subagents)
-| Agent | Purpose |
-|-------|---------|
-| **research-web** | Researches best practices before new features |
-| **commit-manager** | Manages git commits, conventional format |
-| **claude-md-compactor** | Compacts CLAUDE.md when > 40k chars |
-| **tester-unit** | Creates unit tests with Vitest |
+| Agent                   | Purpose                                       |
+| ----------------------- | --------------------------------------------- |
+| **research-web**        | Researches best practices before new features |
+| **commit-manager**      | Manages git commits, conventional format      |
+| **claude-md-compactor** | Compacts CLAUDE.md when > 40k chars           |
+| **tester-unit**         | Creates unit tests with Vitest                |
 ---
@@ -135,6 +155,7 @@ Claude works autonomously until the task is complete or hits the iteration limit
 > Documentation lives in `/docs` and is created **only when the user asks**.
 After completing any task, Claude should ask:
 ```
 Done! Finished [task description]. Want me to:
 1. Document this in /docs?
@@ -149,12 +170,12 @@ Do NOT auto-document. Do NOT maintain domain docs. Keep it simple.
 > After ANY implementation, update this file to reflect the current state.
-| Change Type | Sections to Update |
-|-------------|-------------------|
+| Change Type     | Sections to Update                  |
+| --------------- | ----------------------------------- |
 | Any file change | Last Change (branch, date, summary) |
-| New feature | 30s Overview, Architecture |
-| New dependency | Stack |
-| Workflow change | Workflow section |
+| New feature     | 30s Overview, Architecture          |
+| New dependency  | Stack                               |
+| Workflow change | Workflow section                    |
 Keep only the LATEST Last Change entry (no stacking).
@@ -164,13 +185,13 @@ Keep only the LATEST Last Change entry (no stacking).
 ### HTTP Requests (MANDATORY)
-| Rule | Implementation |
-|------|----------------|
-| Use axios ONLY | Never `fetch()` or raw `axios` |
-| `withCredentials: true` | ALWAYS for cookies/sessions |
-| Extend base instance | Create `lib/api/axios.ts` |
-| Type responses | `api.get<User>('/users')` |
-| Centralize errors | Use interceptors |
+| Rule                    | Implementation                 |
+| ----------------------- | ------------------------------ |
+| Use axios ONLY          | Never `fetch()` or raw `axios` |
+| `withCredentials: true` | ALWAYS for cookies/sessions    |
+| Extend base instance    | Create `lib/api/axios.ts`      |
+| Type responses          | `api.get<User>('/users')`      |
+| Centralize errors       | Use interceptors               |
 ### Path Aliases (MANDATORY)
@@ -216,20 +237,20 @@ Types: `feat`, `fix`, `refactor`, `docs`, `chore`
 ## FORBIDDEN Actions
-| Action                         | Reason                       |
-| ------------------------------ | ---------------------------- |
-| Write in non-English           | ALL code/docs MUST be in EN  |
-| Skip typecheck                 | Catches runtime errors       |
-| Use `any` type                 | Defeats strict mode          |
-| Define types in `src/`         | Must be in `types/`          |
-| Commit directly to main        | Create feature/fix branches  |
-| Use MUI/Chakra                 | Use shadcn/ui + Radix        |
-| Wildcard icon imports          | Use named imports            |
-| Files > 400 lines              | MUST split into smaller      |
-| 'use client' at top level      | Push to leaf components only |
-| Waterfall data fetching        | Use Promise.all() for parallel |
-| Auto-document without asking   | Ask user first               |
-| Skip superpowers for features  | Use brainstorming + TDD      |
+| Action                        | Reason                                                                                                                |
+| ----------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| Speak/write in non-English    | EN ONLY (chat, code, docs, commits) — see Language Policy. Override only via explicit user request, current turn only |
+| Skip typecheck                | Catches runtime errors                                                                                                |
+| Use `any` type                | Defeats strict mode                                                                                                   |
+| Define types in `src/`        | Must be in `types/`                                                                                                   |
+| Commit directly to main       | Create feature/fix branches                                                                                           |
+| Use MUI/Chakra                | Use shadcn/ui + Radix                                                                                                 |
+| Wildcard icon imports         | Use named imports                                                                                                     |
+| Files > 400 lines             | MUST split into smaller                                                                                               |
+| 'use client' at top level     | Push to leaf components only                                                                                          |
+| Waterfall data fetching       | Use Promise.all() for parallel                                                                                        |
+| Auto-document without asking  | Ask user first                                                                                                        |
+| Skip superpowers for features | Use brainstorming + TDD                                                                                               |
 ---
@@ -247,13 +268,13 @@ Types: `feat`, `fix`, `refactor`, `docs`, `chore`
 ## MCP Servers
-| Server                | Purpose                 | When to Use                          |
-| --------------------- | ----------------------- | ------------------------------------ |
-| `sequential-thinking` | Complex problem-solving | Multi-step tasks, planning           |
-| `memory`              | Persistent knowledge    | Store/recall project patterns        |
-| `playwright`          | Browser automation      | UI testing, page verification        |
-| `nextjs-devtools`     | Next.js dev tools       | Next.js projects only                |
-| `mongodb`             | Database operations     | DB queries, schema inspection        |
+| Server                | Purpose                 | When to Use                   |
+| --------------------- | ----------------------- | ----------------------------- |
+| `sequential-thinking` | Complex problem-solving | Multi-step tasks, planning    |
+| `memory`              | Persistent knowledge    | Store/recall project patterns |
+| `playwright`          | Browser automation      | UI testing, page verification |
+| `nextjs-devtools`     | Next.js dev tools       | Next.js projects only         |
+| `mongodb`             | Database operations     | DB queries, schema inspection |
 > Note: `context7` is now a **plugin** (auto-invokes on library mentions).
@@ -261,13 +282,13 @@ Types: `feat`, `fix`, `refactor`, `docs`, `chore`
 ## Community Skills (from GitHub)
-| Skill | Source | Purpose |
-|-------|--------|---------|
-| **react-best-practices** | vercel-labs | React/Next.js perf optimization rules |
-| **web-design-guidelines** | vercel-labs | 100+ WCAG + UX audit rules |
-| **composition-patterns** | vercel-labs | Compound component patterns |
-| **webapp-testing** | anthropics | Real browser test execution |
-| **mcp-builder** | anthropics | MCP server development guide |
+| Skill                     | Source      | Purpose                               |
+| ------------------------- | ----------- | ------------------------------------- |
+| **react-best-practices**  | vercel-labs | React/Next.js perf optimization rules |
+| **web-design-guidelines** | vercel-labs | 100+ WCAG + UX audit rules            |
+| **composition-patterns**  | vercel-labs | Compound component patterns           |
+| **webapp-testing**        | anthropics  | Real browser test execution           |
+| **mcp-builder**           | anthropics  | MCP server development guide          |
 ---