@qazuor/claude-code-config 0.4.0 → 0.6.0

package/README.md

@@ -16,6 +16,7 @@ A comprehensive CLI tool to install and manage Claude Code configurations in you
 - [Commands](#commands)
   - [init](#init-path)
   - [configure](#configure)
+  - [standards](#standards)
   - [list](#list-type)
   - [add](#add-module)
   - [remove](#remove-module)
@@ -26,8 +27,11 @@ A comprehensive CLI tool to install and manage Claude Code configurations in you
   - [Agents](#agents-23-available)
   - [Skills](#skills-25-available)
   - [Commands](#commands-23-available)
-  - [Documentation](#documentation-18-available)
+  - [Documentation](#documentation-21-available)
 - [Template Configuration](#template-configuration)
+- [Standards Configuration](#standards-configuration)
+- [Pre-commit Hooks](#pre-commit-hooks)
+- [Response Style](#response-style)
 - [MCP Servers](#mcp-servers)
 - [Permissions](#permissions)
 - [Code Style](#code-style)
@@ -51,6 +55,9 @@ A comprehensive CLI tool to install and manage Claude Code configurations in you
 - **23 Bundles**: Pre-grouped module sets organized by category (stacks, testing, quality, etc.)
 - **Bundle Categories**: Stack bundles (React+TanStack, Astro, Next.js), API bundles (Hono, Express), testing, quality, and more
 - **Template Configuration**: Interactive setup for `{{PLACEHOLDER}}` values with smart defaults
+- **Standards Wizard**: Configure code, testing, documentation, design, security, and performance standards
+- **Pre-commit Hooks**: Configurable git hooks with lint, typecheck, tests, and custom commands
+- **Response Style**: Configure Claude's tone, verbosity, and communication preferences
 - **MCP Server Integration**: Configure Model Context Protocol servers
 - **Permissions System**: Fine-grained control over Claude's capabilities
 - **Code Style Tools**: EditorConfig, Biome, Prettier, and Commitlint configuration
@@ -61,12 +68,28 @@ A comprehensive CLI tool to install and manage Claude Code configurations in you
 
 | Category | Count | Description |
 |----------|-------|-------------|
-| **Agents** | 23 | Specialized AI agents for different roles |
-| **Skills** | 25 | Reusable capabilities and knowledge |
+| **Agents** | 15 | Specialized AI agents for different roles (generic + specialized) |
+| **Skills** | 41 | Reusable capabilities including framework-specific patterns |
 | **Commands** | 23 | Slash commands for workflows |
-| **Docs** | 18 | Reference documentation and guides |
+| **Docs** | 21 | Reference documentation and guides |
 | **MCP Servers** | 27 | External tool integrations |
 | **Bundles** | 23 | Pre-grouped module sets |
+| **Standards** | 6 | Configurable project standards (code, testing, docs, design, security, performance) |
+
+### Framework-Agnostic Design
+
+Agents are designed to be **framework-agnostic** and use **related skills** for framework-specific patterns:
+
+- **api-engineer** + `hono-patterns` / `express-patterns` / `fastify-patterns` / `nestjs-patterns`
+- **database-engineer** + `drizzle-patterns` / `prisma-patterns` / `mongoose-patterns`
+- **frontend-engineer** + `react-patterns` / `nextjs-patterns` / `astro-patterns` / `tanstack-start-patterns`
+
+### Intelligent Skill Selection
+
+The wizard includes an **intelligent mutual exclusivity system** that:
+- Detects conflicting skills (e.g., TDD vs BDD vs ATDD)
+- Automatically disables incompatible options
+- Allows combining compatible methodologies (e.g., TDD + Clean Architecture)
 
 ### Smart Defaults
 
@@ -83,15 +106,20 @@ After running `qazuor-claude-config init`, your project will have:
 ```
 .claude/
 ├── config.json              # Configuration storage
+├── settings.json            # Claude Code settings (model, permissions)
 ├── settings.local.json      # Local permissions & MCP
-├── agents/                  # 23 specialized AI agents
-│   ├── engineering/         # Backend, frontend, DB engineers
+├── agents/                  # 15 specialized AI agents
+│   ├── engineering/         # Generic engineers (API, Database, Frontend)
 │   ├── product/             # Product functional & technical
 │   ├── quality/             # QA, debugger
 │   ├── design/              # UX/UI designer
 │   └── specialized/         # SEO, i18n, content, tech writer
-├── skills/                  # 25 development skills
+├── skills/                  # 41 development skills
 │   ├── testing/             # TDD, security, performance, QA
+│   ├── patterns/            # Architecture patterns (Clean, Hexagonal, etc.)
+│   ├── api-frameworks/      # Hono, Express, Fastify, NestJS patterns
+│   ├── database/            # Drizzle, Prisma, Mongoose patterns
+│   ├── frontend-frameworks/ # React, Next.js, Astro, TanStack patterns
 │   ├── development/         # Git, Vercel, Shadcn, diagrams
 │   └── design/              # Brand, errors, markdown, PDF
 ├── commands/                # 23 slash commands
@@ -100,7 +128,7 @@ After running `qazuor-claude-config init`, your project will have:
 │   ├── git/                 # Commit helper
 │   ├── meta/                # Create agent/command/skill, help
 │   └── formatting/          # Markdown formatter
-├── docs/                    # 18 documentation files
+├── docs/                    # 21 documentation files
 │   ├── workflows/           # Decision tree, phases, protocols
 │   ├── standards/           # Code, testing, docs standards
 │   └── templates/           # PDR, tech analysis, TODOs
@@ -163,12 +191,15 @@ The wizard will guide you through:
 1. **Project Information** - Name, description, organization, entity types
 2. **Preferences** - Language, co-author settings
 3. **Scaffold Options** - Claude-only or full project structure
-4. **Module Selection** - Choose bundles or custom modules
+4. **Module Selection** - Choose bundles or custom modules (with smart skill selection)
 5. **Hook Configuration** - Desktop/audio notifications
 6. **MCP Servers** - External tool integrations
 7. **Permissions** - What Claude can do
 8. **Code Style** - EditorConfig, Biome, Prettier, Commitlint
-9. **Template Configuration** - Auto-detected command/path/target values
+9. **CI/CD** - GitHub Actions workflows
+10. **Folder Preferences** - Test, planning, docs locations
+11. **Template Configuration** - Auto-detected command/path/target values
+12. **Claude Settings** - Model, API choice, permissions, behavior
 
 > **Tip**: You can go back to any previous step using the "← Back" option to modify your choices.
 
@@ -276,6 +307,58 @@ qazuor-claude-config configure --preview
 qazuor-claude-config configure --show-defaults
 ```
 
+### `standards`
+
+Configure project standards interactively. This wizard helps you define code style, testing, documentation, design, security, and performance standards for your project.
+
+```bash
+qazuor-claude-config standards [options] [path]
+```
+
+#### Options
+
+| Option | Description |
+|--------|-------------|
+| `--scan` | Scan for unconfigured standard placeholders only |
+| `-c, --category <name>` | Configure specific category: `code`, `testing`, `documentation`, `design`, `security`, `performance` |
+| `--preview` | Preview changes without applying |
+| `--update-templates` | Update/sync templates from package to project (for existing installations) |
+| `-y, --yes` | Accept defaults without prompts |
+| `-v, --verbose` | Show detailed output |
+
+#### Categories
+
+| Category | Configures |
+|----------|------------|
+| `code` | Indent style, quotes, semicolons, max lines, TypeScript rules |
+| `testing` | Coverage target, TDD, test patterns, test location |
+| `documentation` | JSDoc level, examples, changelog format, comments |
+| `design` | CSS framework, component library, accessibility, dark mode |
+| `security` | Auth pattern, validation library, CSRF, rate limiting |
+| `performance` | Core Web Vitals (LCP, FID, CLS), bundle size, API response time |
+
+#### Examples
+
+```bash
+# Full interactive standards wizard
+qazuor-claude-config standards
+
+# Configure only code standards
+qazuor-claude-config standards --category code
+
+# Scan for unconfigured placeholders
+qazuor-claude-config standards --scan
+
+# Preview changes without applying
+qazuor-claude-config standards --preview
+
+# Update templates from package (for existing installations)
+qazuor-claude-config standards --update-templates
+
+# Accept all defaults
+qazuor-claude-config standards --yes
+```
+
 ### `list [type]`
 
 List available modules, bundles, or MCP servers.
@@ -288,10 +371,10 @@ qazuor-claude-config list [options] [type]
 
 | Type | Description |
 |------|-------------|
-| `agents` | List all 23 available agents |
-| `skills` | List all 25 available skills |
+| `agents` | List all 15 available agents |
+| `skills` | List all 41 available skills |
 | `commands` | List all 23 available commands |
-| `docs` | List all 18 documentation modules |
+| `docs` | List all 21 documentation modules |
 | `bundles` | List all 23 module bundles |
 | `mcp` | List all 27 MCP servers |
 | *(none)* | List summary of all modules |
@@ -340,10 +423,11 @@ Categories: agent, skill, command, doc
 ```bash
 # Add an agent
 qazuor-claude-config add agent:tech-lead
-qazuor-claude-config add agent:prisma-engineer
+qazuor-claude-config add agent:api-engineer
 
 # Add a skill
 qazuor-claude-config add skill:tdd-methodology
+qazuor-claude-config add skill:hono-patterns
 
 # Add a command
 qazuor-claude-config add command:security-audit
@@ -439,29 +523,29 @@ Complete technology stacks for different project types.
 
 | Bundle | Description | Includes |
 |--------|-------------|----------|
-| `drizzle-database` | Drizzle ORM patterns | db-drizzle-engineer, json-data-auditor |
-| `prisma-database` | Prisma ORM patterns | prisma-engineer, json-data-auditor |
-| `mongoose-database` | MongoDB + Mongoose | mongoose-engineer, json-data-auditor |
+| `drizzle-database` | Drizzle ORM patterns | database-engineer, drizzle-patterns, json-data-auditor |
+| `prisma-database` | Prisma ORM patterns | database-engineer, prisma-patterns, json-data-auditor |
+| `mongoose-database` | MongoDB + Mongoose | database-engineer, mongoose-patterns, json-data-auditor |
 
 ### API Bundles
 
 | Bundle | Description | Includes |
 |--------|-------------|----------|
-| `hono-api` | Hono framework | hono-engineer, api-app-testing, error-handling-patterns |
-| `express-api` | Express.js framework | express-engineer, api-app-testing, error-handling-patterns |
-| `fastify-api` | Fastify framework | fastify-engineer, api-app-testing, error-handling-patterns |
-| `nestjs-api` | NestJS framework | nestjs-engineer, api-app-testing, error-handling-patterns |
+| `hono-api` | Hono framework | api-engineer, hono-patterns, api-app-testing, error-handling-patterns |
+| `express-api` | Express.js framework | api-engineer, express-patterns, api-app-testing, error-handling-patterns |
+| `fastify-api` | Fastify framework | api-engineer, fastify-patterns, api-app-testing, error-handling-patterns |
+| `nestjs-api` | NestJS framework | api-engineer, nestjs-patterns, api-app-testing, error-handling-patterns |
 
 ### Frontend Bundles
 
 | Bundle | Description | Includes |
 |--------|-------------|----------|
-| `react-ui` | React + Shadcn UI | react-senior-dev, ux-ui-designer, shadcn-specialist, brand-guidelines, accessibility-audit |
-| `react-forms` | React Hook Form + Zod | react-senior-dev, react-hook-form-patterns, shadcn-specialist |
-| `react-state-zustand` | Zustand state management | react-senior-dev, zustand-patterns, tanstack-query-patterns |
-| `react-state-redux` | Redux Toolkit | react-senior-dev, redux-toolkit-patterns |
-| `nextjs-auth` | NextAuth.js authentication | nextjs-engineer, nextauth-patterns, security-testing |
-| `nextjs-i18n` | Next.js internationalization | nextjs-engineer, i18n-specialist, i18n-patterns |
+| `react-ui` | React + Shadcn UI | frontend-engineer, react-patterns, ux-ui-designer, shadcn-specialist, brand-guidelines, accessibility-audit |
+| `react-forms` | React Hook Form + Zod | frontend-engineer, react-patterns, react-hook-form-patterns, shadcn-specialist |
+| `react-state-zustand` | Zustand state management | frontend-engineer, react-patterns, zustand-patterns, tanstack-query-patterns |
+| `react-state-redux` | Redux Toolkit | frontend-engineer, react-patterns, redux-toolkit-patterns |
+| `nextjs-auth` | NextAuth.js authentication | frontend-engineer, nextjs-patterns, nextauth-patterns, security-testing |
+| `nextjs-i18n` | Next.js internationalization | frontend-engineer, nextjs-patterns, i18n-specialist, i18n-patterns |
 
 ### Workflow Bundles
 
@@ -474,25 +558,19 @@ Complete technology stacks for different project types.
 
 ## Modules
 
-### Agents (23 Available)
+### Agents (15 Available)
 
-Specialized AI agents for different development roles.
+Specialized AI agents for different development roles. Engineering agents are **framework-agnostic** and use **related skills** for framework-specific patterns.
 
 #### Engineering Agents
 
-| ID | Name | Description |
-|----|------|-------------|
-| `tech-lead` | Tech Lead | Architecture, coordination, code review |
-| `hono-engineer` | Hono Engineer | Hono API development |
-| `express-engineer` | Express Engineer | Express.js API development |
-| `fastify-engineer` | Fastify Engineer | Fastify API development |
-| `nestjs-engineer` | NestJS Engineer | NestJS framework development |
-| `db-drizzle-engineer` | Drizzle Engineer | Database with Drizzle ORM |
-| `prisma-engineer` | Prisma Engineer | Database with Prisma ORM |
-| `node-typescript-engineer` | Node/TS Engineer | Node.js/TypeScript development |
-| `astro-engineer` | Astro Engineer | Astro framework development |
-| `tanstack-start-engineer` | TanStack Engineer | TanStack Router/Query |
-| `react-senior-dev` | React Developer | React component development |
+| ID | Name | Description | Related Skills |
+|----|------|-------------|----------------|
+| `tech-lead` | Tech Lead | Architecture, coordination, code review | - |
+| `api-engineer` | API Engineer | Generic backend API development | hono, express, fastify, nestjs patterns |
+| `database-engineer` | Database Engineer | Generic database design and development | drizzle, prisma, mongoose patterns |
+| `frontend-engineer` | Frontend Engineer | Generic frontend development | react, nextjs, astro, tanstack patterns |
+| `node-typescript-engineer` | Node/TS Engineer | Node.js/TypeScript development | - |
 
 #### Product Agents
 
@@ -524,15 +602,62 @@ Specialized AI agents for different development roles.
 | `content-writer` | Content Writer | Web copywriting |
 | `enrichment-agent` | Enrichment Agent | Data enrichment and planning context |
 
-### Skills (25 Available)
+### Skills (41 Available)
+
+Reusable capabilities that can be invoked by agents. Skills are organized by category and some have **mutual exclusivity** constraints.
+
+#### Framework-Specific Skills
+
+**API Frameworks** (use with api-engineer):
+
+| ID | Name | Description |
+|----|------|-------------|
+| `hono-patterns` | Hono Patterns | Hono framework patterns and best practices |
+| `express-patterns` | Express Patterns | Express.js patterns and middleware |
+| `fastify-patterns` | Fastify Patterns | Fastify plugins and hooks |
+| `nestjs-patterns` | NestJS Patterns | NestJS modules, controllers, providers |
+
+**Database ORMs** (use with database-engineer):
+
+| ID | Name | Description |
+|----|------|-------------|
+| `drizzle-patterns` | Drizzle Patterns | Drizzle ORM schemas and queries |
+| `prisma-patterns` | Prisma Patterns | Prisma client and migrations |
+| `mongoose-patterns` | Mongoose Patterns | Mongoose schemas and models |
+
+**Frontend Frameworks** (use with frontend-engineer):
+
+| ID | Name | Description |
+|----|------|-------------|
+| `react-patterns` | React Patterns | React hooks, components, state |
+| `nextjs-patterns` | Next.js Patterns | Next.js App Router, SSR, SSG |
+| `astro-patterns` | Astro Patterns | Astro islands, content collections |
+| `tanstack-start-patterns` | TanStack Start | TanStack Router and Query patterns |
+
+#### Methodology Skills
+
+**Development Methodologies** (mutually exclusive - pick one):
+
+| ID | Name | Description |
+|----|------|-------------|
+| `tdd-methodology` | TDD Methodology | Test-driven development (Red-Green-Refactor) |
+| `bdd-methodology` | BDD Methodology | Behavior-driven development with Gherkin |
+| `atdd-methodology` | ATDD Methodology | Acceptance test-driven development |
 
-Reusable capabilities that can be invoked by agents.
+**Architectural Methodologies** (can combine with development methodologies):
+
+| ID | Name | Description |
+|----|------|-------------|
+| `clean-architecture` | Clean Architecture | Concentric layers with dependency inversion |
+| `hexagonal-architecture` | Hexagonal Architecture | Ports and Adapters pattern |
+| `vertical-slice-architecture` | Vertical Slice | Feature-based code organization |
+
+> **Note:** Clean and Hexagonal are alternatives (similar approaches). Vertical Slice is an alternative to both layered architectures.
 
 #### Testing Skills
 
 | ID | Name | Description |
 |----|------|-------------|
-| `tdd-methodology` | TDD Methodology | Test-driven development |
 | `security-testing` | Security Testing | Security vulnerability testing |
 | `performance-testing` | Performance Testing | Performance optimization |
 | `api-app-testing` | API Testing | API testing strategies |
@@ -621,7 +746,7 @@ Slash commands for common workflows.
 |---------|-------------|
 | `/format-markdown` | Format markdown files |
 
-### Documentation (18 Available)
+### Documentation (20 Available)
 
 Reference documentation and workflow guides.
 
@@ -635,9 +760,12 @@ Reference documentation and workflow guides.
 | `phase-2-implementation` | Implementation guide |
 | `phase-3-validation` | Validation guide |
 | `phase-4-finalization` | Finalization guide |
-| `code-standards` | Coding standards |
-| `testing-standards` | Testing guidelines |
-| `documentation-standards` | Documentation guidelines |
+| `code-standards` | Coding standards (configurable) |
+| `testing-standards` | Testing guidelines (configurable) |
+| `documentation-standards` | Documentation guidelines (configurable) |
+| `design-standards` | Design system standards (configurable) |
+| `security-standards` | Security standards (configurable) |
+| `performance-standards` | Performance standards (configurable) |
 | `architecture-patterns` | Architecture patterns |
 | `pdr-template` | Product Definition Report template |
 | `tech-analysis-template` | Technical analysis template |
@@ -685,6 +813,223 @@ qazuor-claude-config configure --show-defaults
 
 Defaults are stored in `~/.claude/defaults.json`.
 
+## Standards Configuration
+
+The standards wizard (`qazuor-claude-config standards`) allows you to configure project-wide standards that are automatically applied to documentation templates.
+
+### Standard Categories
+
+#### Code Standards
+
+| Setting | Options | Default |
+|---------|---------|---------|
+| Indent Style | `space`, `tab` | `space` |
+| Indent Size | `2`, `4` | `2` |
+| Max Line Length | `80`, `100`, `120` | `100` |
+| Max File Lines | `300`, `500`, `800`, `1000` | `500` |
+| Quote Style | `single`, `double` | `single` |
+| Semicolons | `true`, `false` | `true` |
+| Trailing Commas | `all`, `es5`, `none` | `all` |
+| Allow `any` Type | `true`, `false` | `false` |
+| Named Exports Only | `true`, `false` | `true` |
+| RO-RO Pattern | `true`, `false` | `true` |
+| JSDoc Required | `true`, `false` | `true` |
+
+#### Testing Standards
+
+| Setting | Options | Default |
+|---------|---------|---------|
+| Coverage Target | `60%`, `70%`, `80%`, `90%`, `95%` | `90%` |
+| TDD Required | `true`, `false` | `true` |
+| Test Pattern | `aaa` (Arrange-Act-Assert), `gwt` (Given-When-Then) | `aaa` |
+| Test Location | `separate` (test/ folder), `colocated` (__tests__) | `separate` |
+| Unit Test Max | `50ms`, `100ms`, `200ms` | `100ms` |
+| Integration Test Max | `500ms`, `1000ms`, `2000ms` | `1000ms` |
+
+#### Documentation Standards
+
+| Setting | Options | Default |
+|---------|---------|---------|
+| JSDoc Level | `minimal`, `standard`, `comprehensive` | `standard` |
+| Require Examples | `true`, `false` | `true` |
+| Changelog Format | `conventional`, `keepachangelog` | `conventional` |
+| Inline Comment Policy | `why-not-what`, `minimal`, `extensive` | `why-not-what` |
+
+#### Design Standards
+
+| Setting | Options | Default |
+|---------|---------|---------|
+| CSS Framework | `tailwind`, `css-modules`, `styled-components`, `vanilla` | `tailwind` |
+| Component Library | `shadcn`, `radix`, `headless`, `none` | `shadcn` |
+| Accessibility Level | `A`, `AA`, `AAA` | `AA` |
+| Dark Mode Support | `true`, `false` | `true` |
+
+#### Security Standards
+
+| Setting | Options | Default |
+|---------|---------|---------|
+| Auth Pattern | `jwt`, `session`, `oauth`, `none` | `jwt` |
+| Input Validation | `zod`, `yup`, `joi`, `manual` | `zod` |
+| CSRF Protection | `true`, `false` | `true` |
+| Rate Limiting | `true`, `false` | `true` |
+
+#### Performance Standards
+
+| Setting | Options | Default |
+|---------|---------|---------|
+| LCP Target | `1500ms`, `2000ms`, `2500ms`, `4000ms` | `2500ms` |
+| FID Target | `50ms`, `100ms`, `200ms`, `300ms` | `100ms` |
+| CLS Target | `0.05`, `0.1`, `0.15`, `0.25` | `0.1` |
+| Bundle Size Target | `100KB`, `150KB`, `250KB`, `500KB` | `250KB` |
+| API Response Target | `100ms`, `200ms`, `300ms`, `500ms` | `200ms` |
+
+### Presets
+
+| Preset | Description |
+|--------|-------------|
+| `strict` | High coverage (95%), strict TypeScript, comprehensive docs |
+| `balanced` | Standard settings for most projects (default) |
+| `relaxed` | Lower coverage (70%), more flexible rules |
+| `startup` | Fast iteration, minimal overhead |
+| `enterprise` | Maximum standards, full documentation |
+
+## Pre-commit Hooks
+
+Configurable pre-commit hooks powered by Husky. The wizard generates sophisticated bash scripts based on your configuration.
+
+### Configuration Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `enabled` | Enable/disable pre-commit hook | `true` |
+| `lint.enabled` | Run linting | `true` |
+| `lint.stagedOnly` | Only lint staged files | `true` |
+| `lint.tool` | Linting tool (`biome`, `eslint`, `custom`) | `biome` |
+| `typecheck.enabled` | Run TypeScript type checking | `true` |
+| `tests.enabled` | Run tests | `true` |
+| `tests.mode` | Test mode (`none`, `affected`, `all`) | `affected` |
+| `tests.coverageThreshold` | Minimum coverage (0 = disabled) | `0` |
+| `formatCheck.enabled` | Check formatting | `false` |
+| `formatCheck.tool` | Format tool (`biome`, `prettier`, `custom`) | `biome` |
+| `showTiming` | Show execution time for each step | `true` |
+| `continueOnFailure` | Run all checks even if one fails | `false` |
+
+### Custom Commands
+
+Add custom validation commands:
+
+```json
+{
+  "customCommands": [
+    {
+      "name": "Security Scan",
+      "command": "pnpm audit --audit-level=high",
+      "allowFailure": true,
+      "order": 50
+    }
+  ]
+}
+```
+
+### Presets
+
+| Preset | Description |
+|--------|-------------|
+| `minimal` | Lint only (staged files) |
+| `standard` | Lint + typecheck (default) |
+| `strict` | Lint + typecheck + affected tests |
+
+### Generated Hook Example
+
+```bash
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+# Pre-commit hook - Generated by @qazuor/claude-code-config
+echo "🔍 Running pre-commit checks..."
+
+# Linting
+echo ""
+echo "📝 Linting..."
+step_start
+pnpm biome check --staged --no-errors-on-unmatched || { echo "  ❌ Lint failed"; exit 1; }
+echo "  ✅ Lint passed"
+step_end
+
+# Type checking
+echo ""
+echo "🔷 Type checking..."
+step_start
+pnpm typecheck || { echo "  ❌ Type check failed"; exit 1; }
+echo "  ✅ Types OK"
+step_end
+
+echo ""
+echo "✨ All checks passed!"
+```
+
+## Response Style
+
+Configure Claude's communication style and tone for your project.
+
+### Configuration Options
+
+| Option | Description | Options |
+|--------|-------------|---------|
+| `tone` | Overall response tone | `friendly`, `professional`, `formal`, `strict`, `mentor` |
+| `verbosity` | Level of detail in responses | `concise`, `balanced`, `detailed` |
+| `responseLanguage` | Language for responses (code always in English) | `en`, `es`, `auto` |
+| `useEmojis` | Use emojis in responses | `true`, `false` |
+| `errorStyle` | How to report errors | `supportive`, `neutral`, `direct` |
+| `explainReasoning` | Include explanation of "why" | `true`, `false` |
+| `offerAlternatives` | Suggest multiple solutions | `true`, `false` |
+| `proactivity` | Level of unsolicited suggestions | `minimal`, `moderate`, `high` |
+| `confirmBeforeBigChanges` | Ask before major changes | `true`, `false` |
+
+### Tone Options
+
+| Tone | Description |
+|------|-------------|
+| `friendly` | Casual, approachable, occasional emojis |
+| `professional` | Professional but accessible |
+| `formal` | Formal, technical language |
+| `strict` | Direct, no-nonsense, to the point |
+| `mentor` | Educational, explains the "why" |
+
+### Presets
+
+| Preset | Tone | Verbosity | Emojis | Error Style |
+|--------|------|-----------|--------|-------------|
+| `friendly` | friendly | balanced | ✓ | supportive |
+| `professional` | professional | balanced | ✗ | neutral |
+| `strict` | strict | concise | ✗ | direct |
+| `mentor` | mentor | detailed | ✗ | supportive |
+
+### Generated Guidelines
+
+The configuration generates guidelines in CLAUDE.md:
+
+```markdown
+## Response Style
+
+**Tone:** Professional
+**Verbosity:** Balanced
+**Language:** Spanish (code in English)
+**Emojis:** No
+**Error Style:** Neutral
+**Explain Reasoning:** Yes
+**Offer Alternatives:** Yes
+**Proactivity:** Moderate
+**Confirm Big Changes:** Yes
+
+### Guidelines
+- Respond in Spanish, write code/comments in English
+- Be professional but accessible
+- Explain the "why" behind decisions
+- Present alternatives when multiple valid approaches exist
+- Ask for confirmation before architectural changes
+```
+
 ## MCP Servers
 
 Model Context Protocol servers extend Claude's capabilities. All 27 servers are verified npm packages.
@@ -1082,7 +1427,7 @@ import type {
 
 ## Configuration File
 
-The main configuration is stored in `.claude/config.json`.
+The main configuration is stored in `.claude/qazuor-claude-config.json`.
 
 ```json
 {