start-vibing 4.4.16 → 4.4.17

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "start-vibing",
-	"version": "4.4.16",
+	"version": "4.4.17",
 	"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

@@ -23,6 +23,39 @@ The user may write to Claude in Portuguese, Spanish, or any other language — C
 
 ---
 
+## Response Style (HARD RULE)
+
+> **Be brief by default. Output tokens cost ~5x input and are ~8x slower to generate. Verbose responses are also re-processed every turn — the cost compounds.**
+
+Adapted from Anthropic's official Opus 4.7 system prompt for Claude Code (April 2026 post-mortem — single addition reported as having "outsized effect on intelligence in Claude Code"):
+
+- **Final responses ≤100 words** unless the task genuinely requires more (multi-step plan, design rationale, teaching, code review with rationale).
+- **Text between tool calls ≤25 words.** One sentence per update at key moments — not a running commentary on internal deliberation.
+- **No prefacing.** Skip "Great question!", "I'll help you with that", "Let me start by…". Just do the thing.
+- **No trailing summaries.** The diff is visible. Don't re-narrate what just happened. End-of-turn = 1–2 sentences max, what changed and what's next.
+- **No re-explanations.** If it's already in this conversation or in CLAUDE.md, don't repeat it.
+- **Don't add docstrings, comments, or type annotations to code you didn't change.** Comment only when WHY is non-obvious. Names already explain WHAT.
+- **Don't reference the current task in code.** No `// added for ticket X` / `// used by feature Y` — that belongs in PR descriptions, not source.
+
+### Brevity ≠ cutting reasoning
+
+Cut **visible explanations**, NOT **internal thinking**:
+
+- Visible prose costs output tokens, gets re-processed every turn, and on large models often _hurts_ accuracy via over-elaboration (arXiv 2604.00025 — restricting outputs to <50 words gave +26.3pp accuracy on GSM8K/MMLU-STEM).
+- Internal thinking/reasoning budget _improves_ quality on hard tasks (Anthropic guidance). Do NOT set `MAX_THINKING_TOKENS=0` or `effort=low` on complex problems.
+- Code comments produced DURING generation often help — they act as logical pivots between natural language and code (arXiv 2404.07549 improves pass@1). Strip prose AROUND the code, not comments INSIDE it.
+
+### When to override brevity
+
+- User explicitly asks for detail ("explain why", "walk me through").
+- Teaching mode (user is learning the codebase or domain).
+- Design / planning discussion where rationale matters.
+- Code review with inline findings + rationale.
+
+Default = terse. Verbose only on signal.
+
+---
+
 ## 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:
@@ -422,23 +455,152 @@ All implementations MUST:
 
 ## FORBIDDEN Actions
 
-| 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                                                                                     |
+| 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 |
+| Verbose responses by default                                           | ≤100 words final, ≤25 words between tool calls — see Response Style. Brevity is intelligence in Claude Code           |
+| Preface answers ("Great question!", "I'll help you with that")         | No filler. Just do the thing                                                                                          |
+| Trailing summary of what just happened                                 | Diff is visible. End-of-turn = 1–2 sentences max                                                                      |
+| Add docstrings/comments/type annotations to code you did NOT change    | Anthropic guidance: only modified code gets new comments. Names explain WHAT, comments only when WHY is non-obvious   |
+| Reference current task/ticket inside code (`// added for X`)           | Belongs in PR description, not source — rots over time                                                                |
+| Re-explain what's already in CLAUDE.md or earlier in this conversation | Wastes output tokens AND re-processes every turn                                                                      |
+| Cut thinking budget on hard tasks (`MAX_THINKING_TOKENS=0`/`low`)      | Cut visible prose, not internal reasoning. Thinking improves accuracy on hard tasks                                   |
+| Inline UI reference patterns (Grid/Modal/List/Toast/etc.) in CLAUDE.md | Patterns belong in `.claude/skills/research-cache/cache/` — recurring input cost otherwise                            |
+| Skip typecheck                                                         | Catches runtime errors                                                                                                |
+| Use `any` type                                                         | Defeats strict mode                                                                                                   |
+| Define types in `src/`                                                 | Must be in `types/`                                                                                                   |
+| Use `@types/` alias                                                    | Reserved by TypeScript                                                                                                |
+| 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                                                                                     |
+
+---
+
+## Universal Project Rules
+
+> Rules that apply to every project using this system. Project-specific overrides go in `/CLAUDE.md`.
+
+### HTTP Requests
+
+| 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
+
+| Alias      | Maps To             | Use For       |
+| ---------- | ------------------- | ------------- |
+| `$types/*` | `./types/*`         | Type defs     |
+| `@common`  | `./common/index.ts` | Logger, utils |
+| `@db`      | `./common/db/`      | DB connection |
+
+NEVER use `@types/` (reserved by TypeScript).
+
+### Types Location
+
+- ALL interfaces/types MUST be in `types/` folder.
+- NEVER define types in `src/` files.
+- EXCEPTION: Zod inferred types and Mongoose Documents.
+
+### TypeScript Strict
+
+```typescript
+process.env['VARIABLE']; // bracket notation
+source: 'listed' as const; // literal type
+```
+
+### Quality Gates
+
+```bash
+bun run typecheck     # MUST pass
+bun run lint          # MUST pass
+bun run test          # MUST pass
+docker compose build  # MUST pass (Docker projects)
+```
+
+### Commit Format
+
+```
+[type]: [description]
+
+- Detail 1
+- Detail 2
+
+Generated with Claude Code
+```
+
+Types: `feat`, `fix`, `refactor`, `docs`, `chore`. NEVER commit directly to `main` — branch as `feature/` | `fix/` | `refactor/` | `test/` first.
+
+### UI Architecture
+
+Web apps MUST have **separate UIs** per platform — not just "responsive design".
+
+| Platform          | Layout                                      |
+| ----------------- | ------------------------------------------- |
+| Mobile (375px)    | Full-screen modals, bottom nav, touch-first |
+| Tablet (768px)    | Condensed dropdowns, hybrid nav             |
+| Desktop (1280px+) | Sidebar left, top navbar with search        |
+
+ANY task editing `.tsx`/`.jsx` MUST consider all 3 viewports. Use `/frontend-design` plugin or research competitors before new UI features.
+
+### Component Organization
+
+| Question                         | Location                  |
+| -------------------------------- | ------------------------- |
+| Used in ONE page only?           | `app/[page]/_components/` |
+| Used across 2+ features?         | `components/shared/`      |
+| UI primitive (Button, Input)?    | `components/ui/`          |
+| Layout element (Header, Footer)? | `components/layout/`      |
+
+### File Size
+
+| Lines   | Action                             |
+| ------- | ---------------------------------- |
+| < 200   | Keep in single file                |
+| 200-400 | Consider splitting                 |
+| > 400   | MUST split into smaller components |
+
+### Mandatory Planning
+
+Use `EnterPlanMode` for non-trivial tasks BEFORE implementing.
+
+| Task Type            | Plan Required |
+| -------------------- | ------------- |
+| New feature          | YES           |
+| UI changes (any JSX) | YES           |
+| Multi-file changes   | YES           |
+| Bug fix (simple)     | NO            |
+| Single-line fix      | NO            |
+
+### UI Reference Material (NOT inlined here)
+
+Detailed UI patterns — Grid Layouts, Modal/Dialog, Lists, Multi-Step Forms, Toast, Optimistic UI, Data Display, Navigation, Animation, Icon Libraries — live in:
+
+- `.claude/skills/research-cache/cache/*.md` — pattern docs (`grid-layout-patterns-2025`, `modal-dialog-design-patterns-2024-2025`, `list-design-patterns-web-apps`, `multi-step-form-patterns`, `react-toast-notifications`, `optimistic-ui-patterns-react`, `data-display-patterns-2024-2025`, `navigation-header-design-patterns-2025`).
+- Skills (`shadcn-ui`, `nextjs-app-router`, `react-patterns`, `tailwind-patterns`) — auto-injected by description match when relevant.
+
+DO NOT inline this material into CLAUDE.md — it's recurring input cost for material only needed on demand. Read the cache file or skill when you actually need the pattern.
+
+### NRY (Never Repeat Yourself)
+
+Common Claude mistakes:
+
+- Multi-line bash with `\` continuations (breaks permissions).
+- Relative paths in permission patterns.
+- Using bash for file operations (use Read/Write/Edit).
+- Ignoring context size — use `/compact` at natural breakpoints, `/clear` when switching contexts.
 
 ---