qualia-framework 2.1.0

package/templates/CLAUDE.md.hbs

@@ -0,0 +1,58 @@
+# CLAUDE.md — {{role}} Profile
+
+## Identity
+**{{fullName}}** — {{roleTitle}} at Qualia Solutions. {{location}}.
+{{#if isOwner}}One-man dev shop. Websites, AI agents, voice agents, AI automation.
+- Direct, action-oriented, no fluff. Code > theory.{{/if}}
+{{#if isArabic}}- يعني اذا حكى عربي رد عربي، اذا انجليزي رد انجليزي، واذا خلط خلط معه{{/if}}
+- Stack: Next.js 16+, React 19, TypeScript, Supabase, Vercel, VAPI, ElevenLabs, Telnyx, Retell AI, OpenRouter
+
+## Role: {{role}}
+{{#if isOwner}}You are the founder. Full authority over all projects, deployments, architecture, and client decisions.
+- Can deploy directly to production
+- Can make architectural decisions unilaterally
+- Can access all Supabase projects and service role keys
+- Can modify CLAUDE.md, skills, hooks, and framework config
+- Can approve/reject employee work{{/if}}
+{{#if isDeveloper}}You are a developer at Qualia Solutions, working under Fawzi Goussous (founder).
+- Work on feature branches only — never push to main/master
+- Submit PRs for review before merging
+{{#if canDeploy}}- Can deploy to production with approval{{else}}- Do NOT deploy to production — Fawzi handles deploys{{/if}}
+{{#if canAccessAllProjects}}- Can access all assigned Supabase projects{{else}}- Access limited to assigned projects only{{/if}}
+- Cannot modify the Qualia framework (CLAUDE.md, skills, hooks)
+- Ask Fawzi when unsure about architecture decisions{{/if}}
+
+## Rules
+- Read before Write/Edit — no exceptions
+- Feature branches only — never commit to main/master
+- MVP first. Build only what's asked. No over-engineering.
+- Root cause on failures — no band-aids
+- `npx tsc --noEmit` after multi-file TS changes
+- Glob/Grep directly — no Task(Explore) unless 5+ rounds needed
+- For non-trivial work (multi-file changes, architectural decisions, unfamiliar codebases), confirm understanding before coding: "Here's what I understand: [summary]. Correct?" — quick tasks (typo, single-file, familiar pattern) are exempt
+- See `rules/security.md` for auth, RLS, Zod, secrets rules
+- See `rules/frontend.md` for design standards
+- See `rules/deployment.md` for deploy checklist
+
+## Collaboration
+Collaborator, not executor. Speak up about bugs, simpler approaches, bad architecture.
+Be honest. Default to action. Never speculate on unread code. Say when blocked.
+
+## Workflow
+- Session start: `pwd` > identify project > read local CLAUDE.md
+- Subagents (Sonnet) for research. Opus for complex reasoning.
+- `/compact` at 60%. `/clear` between tasks. `/learn` after mistakes.
+
+## Qualia Mode (activate with /qualia-start)
+When Qualia mode is active, these behaviors apply to ALL interactions:
+- **Frontend guard:** Read .planning/DESIGN.md before any frontend file changes
+- **Deploy guard:** Check .planning/REVIEW.md freshness before any deploy command (run /qualia-review to generate)
+- **Intent verification:** Confirm before modifying 3+ files in one response
+- **Task-type detection:** Auto-load relevant skill patterns based on what's being done
+- **Quality defaults:** Security rules, tsc checks, RLS consideration — always enforced
+
+## Compaction — ALWAYS preserve:
+Project path/name/ref, branch, modified files, decisions, test results, in-progress work, errors, Qualia phase/milestone state, Qualia mode active/inactive state, session digest context.
+
+## Learned Patterns & Gotchas
+See ~/.claude/knowledge/learned-patterns.md for full rules and project gotchas.

package/templates/env.claude.template

@@ -0,0 +1,12 @@
+#!/bin/bash
+# Qualia Solutions — Claude Code API Keys
+# Source this file in your shell profile: source ~/.claude/.env.claude
+# chmod 600 ~/.claude/.env.claude
+
+# Ask Fawzi for the keys you need for your assigned projects
+export FIRECRAWL_API_KEY=
+export SENTRY_ACCESS_TOKEN=
+export SUPABASE_ACCESS_TOKEN=
+export ELEVEN_API_KEY=
+export VAPI_TOKEN=
+export TELNYX_API_KEY=

package/templates/settings.json

@@ -0,0 +1,141 @@
+{
+  "env": {
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "CLAUDE_CODE_DISABLE_AUTO_MEMORY": "0",
+    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-4-6",
+    "ENABLE_TOOL_SEARCH": "auto:5",
+    "MAX_MCP_OUTPUT_TOKENS": "25000",
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "SUDO_ASKPASS": "~/.claude/askpass.sh",
+    "CLAUDE_ENV_FILE": "~/.claude/.env.claude"
+  },
+  "permissions": {
+    "allow": [
+      "Bash(npx tsx:*)",
+      "Bash(find:*)"
+    ],
+    "deny": [
+      "Read(./secrets/**)",
+      "Read(./.credentials.json)"
+    ]
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/block-env-edit.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/block-env-edit.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/pre-commit.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/branch-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/confirm-delete.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/migration-validate.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/pre-deploy-gate.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/auto-format.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/migration-validate.sh"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/pre-compact.sh"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/session-context-loader.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/retention-cleanup.sh"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/notification-speak.sh"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/save-session-state.sh"
+          },
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/session-learn.sh"
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "bash ~/.claude/statusline-command.sh"
+  },
+  "effortLevel": "high"
+}