qualia-framework 2.5.1 → 3.1.0

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 (327) hide show
  1. package/CLAUDE.md +63 -0
  2. package/README.md +108 -30
  3. package/agents/builder.md +110 -0
  4. package/agents/planner.md +186 -0
  5. package/agents/qa-browser.md +186 -0
  6. package/agents/verifier.md +369 -0
  7. package/bin/cli.js +706 -417
  8. package/bin/install.js +622 -0
  9. package/bin/qualia-ui.js +284 -0
  10. package/bin/state.js +824 -0
  11. package/bin/statusline.js +252 -0
  12. package/docs/erp-contract.md +161 -0
  13. package/guide.md +63 -0
  14. package/hooks/auto-update.js +117 -0
  15. package/hooks/block-env-edit.js +52 -0
  16. package/hooks/branch-guard.js +68 -0
  17. package/hooks/migration-guard.js +83 -0
  18. package/hooks/pre-compact.js +52 -0
  19. package/hooks/pre-deploy-gate.js +149 -0
  20. package/hooks/pre-push.js +53 -0
  21. package/hooks/session-start.js +126 -0
  22. package/package.json +31 -17
  23. package/rules/design-reference.md +179 -0
  24. package/rules/frontend.md +126 -0
  25. package/rules/infrastructure.md +87 -0
  26. package/skills/qualia/SKILL.md +88 -0
  27. package/skills/qualia-build/SKILL.md +115 -0
  28. package/skills/qualia-debug/SKILL.md +87 -0
  29. package/skills/qualia-design/SKILL.md +99 -0
  30. package/skills/qualia-handoff/SKILL.md +66 -0
  31. package/skills/qualia-help/SKILL.md +60 -0
  32. package/skills/qualia-idk/SKILL.md +8 -0
  33. package/skills/qualia-learn/SKILL.md +111 -0
  34. package/skills/qualia-new/SKILL.md +323 -0
  35. package/skills/qualia-pause/SKILL.md +63 -0
  36. package/skills/qualia-plan/SKILL.md +101 -0
  37. package/skills/qualia-polish/SKILL.md +207 -0
  38. package/skills/qualia-quick/SKILL.md +37 -0
  39. package/skills/qualia-report/SKILL.md +114 -0
  40. package/skills/qualia-resume/SKILL.md +49 -0
  41. package/skills/qualia-review/SKILL.md +161 -0
  42. package/skills/qualia-ship/SKILL.md +90 -0
  43. package/skills/qualia-skill-new/SKILL.md +167 -0
  44. package/skills/qualia-task/SKILL.md +91 -0
  45. package/skills/qualia-test/SKILL.md +134 -0
  46. package/skills/qualia-verify/SKILL.md +113 -0
  47. package/templates/DESIGN.md +475 -0
  48. package/templates/help.html +476 -0
  49. package/templates/plan.md +42 -0
  50. package/templates/project.md +22 -0
  51. package/templates/state.md +27 -0
  52. package/templates/tracking.json +20 -0
  53. package/tests/bin.test.sh +687 -0
  54. package/tests/hooks.test.sh +384 -0
  55. package/tests/runner.js +1956 -0
  56. package/tests/state.test.sh +713 -0
  57. package/tests/statusline.test.sh +243 -0
  58. package/bin/collect-metrics.sh +0 -62
  59. package/framework/.claudeignore +0 -51
  60. package/framework/CLAUDE.md +0 -51
  61. package/framework/MCP_SETUP.md +0 -229
  62. package/framework/agents/architecture-strategist.md +0 -53
  63. package/framework/agents/backend-agent.md +0 -150
  64. package/framework/agents/code-simplicity-reviewer.md +0 -86
  65. package/framework/agents/frontend-agent.md +0 -111
  66. package/framework/agents/kieran-typescript-reviewer.md +0 -96
  67. package/framework/agents/performance-oracle.md +0 -111
  68. package/framework/agents/qualia-codebase-mapper.md +0 -761
  69. package/framework/agents/qualia-debugger.md +0 -1204
  70. package/framework/agents/qualia-executor.md +0 -882
  71. package/framework/agents/qualia-integration-checker.md +0 -424
  72. package/framework/agents/qualia-phase-researcher.md +0 -457
  73. package/framework/agents/qualia-plan-checker.md +0 -700
  74. package/framework/agents/qualia-planner.md +0 -1245
  75. package/framework/agents/qualia-project-researcher.md +0 -603
  76. package/framework/agents/qualia-research-synthesizer.md +0 -200
  77. package/framework/agents/qualia-roadmapper.md +0 -606
  78. package/framework/agents/qualia-verifier.md +0 -686
  79. package/framework/agents/red-team-qa.md +0 -130
  80. package/framework/agents/security-auditor.md +0 -72
  81. package/framework/agents/team-orchestrator.md +0 -229
  82. package/framework/agents/teams/framework-audit-team.md +0 -66
  83. package/framework/agents/teams/full-stack-team.md +0 -48
  84. package/framework/agents/teams/optimize-team.md +0 -53
  85. package/framework/agents/teams/review-team.md +0 -70
  86. package/framework/agents/teams/ship-team.md +0 -86
  87. package/framework/agents/test-agent.md +0 -182
  88. package/framework/hooks/auto-format.sh +0 -54
  89. package/framework/hooks/block-env-edit.sh +0 -42
  90. package/framework/hooks/branch-guard.sh +0 -43
  91. package/framework/hooks/confirm-delete.sh +0 -59
  92. package/framework/hooks/migration-validate.sh +0 -77
  93. package/framework/hooks/notification-speak.sh +0 -16
  94. package/framework/hooks/pre-commit.sh +0 -100
  95. package/framework/hooks/pre-compact.sh +0 -56
  96. package/framework/hooks/pre-deploy-gate.sh +0 -160
  97. package/framework/hooks/qualia-colors.sh +0 -32
  98. package/framework/hooks/retention-cleanup.sh +0 -62
  99. package/framework/hooks/save-session-state.sh +0 -185
  100. package/framework/hooks/session-context-loader.sh +0 -96
  101. package/framework/hooks/session-learn.sh +0 -32
  102. package/framework/hooks/skill-announce.sh +0 -123
  103. package/framework/hooks/tool-error-announce.sh +0 -27
  104. package/framework/install.ps1 +0 -323
  105. package/framework/install.sh +0 -313
  106. package/framework/qualia-framework/VERSION +0 -1
  107. package/framework/qualia-framework/assets/qualia-logo.png +0 -0
  108. package/framework/qualia-framework/bin/collect-metrics.sh +0 -67
  109. package/framework/qualia-framework/bin/generate-report-docx.py +0 -429
  110. package/framework/qualia-framework/bin/qualia-tools.js +0 -2201
  111. package/framework/qualia-framework/bin/qualia-tools.test.js +0 -1054
  112. package/framework/qualia-framework/references/checkpoints.md +0 -775
  113. package/framework/qualia-framework/references/completion-checklists.md +0 -359
  114. package/framework/qualia-framework/references/continuation-format.md +0 -249
  115. package/framework/qualia-framework/references/continuation-prompt.md +0 -97
  116. package/framework/qualia-framework/references/decimal-phase-calculation.md +0 -65
  117. package/framework/qualia-framework/references/design-quality.md +0 -56
  118. package/framework/qualia-framework/references/employee-guide.md +0 -167
  119. package/framework/qualia-framework/references/git-integration.md +0 -254
  120. package/framework/qualia-framework/references/git-planning-commit.md +0 -50
  121. package/framework/qualia-framework/references/model-profile-resolution.md +0 -32
  122. package/framework/qualia-framework/references/model-profiles.md +0 -73
  123. package/framework/qualia-framework/references/phase-argument-parsing.md +0 -61
  124. package/framework/qualia-framework/references/planning-config.md +0 -195
  125. package/framework/qualia-framework/references/questioning.md +0 -141
  126. package/framework/qualia-framework/references/tdd.md +0 -263
  127. package/framework/qualia-framework/references/ui-brand.md +0 -160
  128. package/framework/qualia-framework/references/verification-patterns.md +0 -612
  129. package/framework/qualia-framework/templates/DEBUG.md +0 -159
  130. package/framework/qualia-framework/templates/DESIGN.md +0 -81
  131. package/framework/qualia-framework/templates/UAT.md +0 -247
  132. package/framework/qualia-framework/templates/codebase/architecture.md +0 -255
  133. package/framework/qualia-framework/templates/codebase/concerns.md +0 -310
  134. package/framework/qualia-framework/templates/codebase/conventions.md +0 -307
  135. package/framework/qualia-framework/templates/codebase/integrations.md +0 -280
  136. package/framework/qualia-framework/templates/codebase/stack.md +0 -186
  137. package/framework/qualia-framework/templates/codebase/structure.md +0 -285
  138. package/framework/qualia-framework/templates/codebase/testing.md +0 -480
  139. package/framework/qualia-framework/templates/config.json +0 -35
  140. package/framework/qualia-framework/templates/context.md +0 -283
  141. package/framework/qualia-framework/templates/continue-here.md +0 -78
  142. package/framework/qualia-framework/templates/debug-subagent-prompt.md +0 -91
  143. package/framework/qualia-framework/templates/discovery.md +0 -146
  144. package/framework/qualia-framework/templates/lab-notes.md +0 -16
  145. package/framework/qualia-framework/templates/milestone-archive.md +0 -123
  146. package/framework/qualia-framework/templates/milestone.md +0 -115
  147. package/framework/qualia-framework/templates/phase-prompt.md +0 -567
  148. package/framework/qualia-framework/templates/planner-subagent-prompt.md +0 -117
  149. package/framework/qualia-framework/templates/project.md +0 -184
  150. package/framework/qualia-framework/templates/projects/ai-agent.md +0 -156
  151. package/framework/qualia-framework/templates/projects/mobile-app.md +0 -181
  152. package/framework/qualia-framework/templates/projects/voice-agent.md +0 -134
  153. package/framework/qualia-framework/templates/projects/website.md +0 -137
  154. package/framework/qualia-framework/templates/requirements.md +0 -231
  155. package/framework/qualia-framework/templates/research-project/ARCHITECTURE.md +0 -204
  156. package/framework/qualia-framework/templates/research-project/FEATURES.md +0 -147
  157. package/framework/qualia-framework/templates/research-project/PITFALLS.md +0 -200
  158. package/framework/qualia-framework/templates/research-project/STACK.md +0 -120
  159. package/framework/qualia-framework/templates/research-project/SUMMARY.md +0 -170
  160. package/framework/qualia-framework/templates/research.md +0 -552
  161. package/framework/qualia-framework/templates/roadmap.md +0 -206
  162. package/framework/qualia-framework/templates/state.md +0 -179
  163. package/framework/qualia-framework/templates/summary-complex.md +0 -59
  164. package/framework/qualia-framework/templates/summary-minimal.md +0 -41
  165. package/framework/qualia-framework/templates/summary-standard.md +0 -48
  166. package/framework/qualia-framework/templates/summary.md +0 -246
  167. package/framework/qualia-framework/templates/user-setup.md +0 -311
  168. package/framework/qualia-framework/templates/verification-report.md +0 -322
  169. package/framework/qualia-framework/workflows/add-phase.md +0 -179
  170. package/framework/qualia-framework/workflows/add-todo.md +0 -157
  171. package/framework/qualia-framework/workflows/audit-milestone.md +0 -241
  172. package/framework/qualia-framework/workflows/check-todos.md +0 -176
  173. package/framework/qualia-framework/workflows/complete-milestone.md +0 -858
  174. package/framework/qualia-framework/workflows/diagnose-issues.md +0 -219
  175. package/framework/qualia-framework/workflows/discovery-phase.md +0 -289
  176. package/framework/qualia-framework/workflows/discuss-phase.md +0 -534
  177. package/framework/qualia-framework/workflows/execute-phase.md +0 -559
  178. package/framework/qualia-framework/workflows/execute-plan.md +0 -438
  179. package/framework/qualia-framework/workflows/help.md +0 -470
  180. package/framework/qualia-framework/workflows/insert-phase.md +0 -220
  181. package/framework/qualia-framework/workflows/list-phase-assumptions.md +0 -178
  182. package/framework/qualia-framework/workflows/map-codebase.md +0 -327
  183. package/framework/qualia-framework/workflows/new-milestone.md +0 -363
  184. package/framework/qualia-framework/workflows/new-project.md +0 -982
  185. package/framework/qualia-framework/workflows/pause-work.md +0 -122
  186. package/framework/qualia-framework/workflows/plan-milestone-gaps.md +0 -256
  187. package/framework/qualia-framework/workflows/plan-phase.md +0 -422
  188. package/framework/qualia-framework/workflows/progress.md +0 -389
  189. package/framework/qualia-framework/workflows/quick.md +0 -252
  190. package/framework/qualia-framework/workflows/remove-phase.md +0 -326
  191. package/framework/qualia-framework/workflows/research-phase.md +0 -74
  192. package/framework/qualia-framework/workflows/resume-project.md +0 -306
  193. package/framework/qualia-framework/workflows/set-profile.md +0 -80
  194. package/framework/qualia-framework/workflows/settings.md +0 -145
  195. package/framework/qualia-framework/workflows/transition.md +0 -556
  196. package/framework/qualia-framework/workflows/update.md +0 -197
  197. package/framework/qualia-framework/workflows/verify-phase.md +0 -195
  198. package/framework/qualia-framework/workflows/verify-work.md +0 -625
  199. package/framework/rules/context7.md +0 -14
  200. package/framework/rules/frontend.md +0 -33
  201. package/framework/rules/speed.md +0 -23
  202. package/framework/scripts/__pycache__/say.cpython-314.pyc +0 -0
  203. package/framework/scripts/apply-retention.sh +0 -120
  204. package/framework/scripts/bootstrap-pop-os.sh +0 -354
  205. package/framework/scripts/claude-voice +0 -13
  206. package/framework/scripts/cleanup.sh +0 -131
  207. package/framework/scripts/cowork-mode.sh +0 -141
  208. package/framework/scripts/generate-project-claude-md.sh +0 -153
  209. package/framework/scripts/load-test-webhook.js +0 -172
  210. package/framework/scripts/say.py +0 -236
  211. package/framework/scripts/showcase-video-recorder/ffmpeg-builder.js +0 -167
  212. package/framework/scripts/showcase-video-recorder/playwright-helpers.js +0 -216
  213. package/framework/scripts/speak.py +0 -55
  214. package/framework/scripts/speak.sh +0 -18
  215. package/framework/scripts/status.sh +0 -138
  216. package/framework/scripts/sync-to-framework.sh +0 -65
  217. package/framework/scripts/voice-hotkey.py +0 -227
  218. package/framework/scripts/voice-input.sh +0 -51
  219. package/framework/skills/animate/SKILL.md +0 -202
  220. package/framework/skills/bolder/SKILL.md +0 -144
  221. package/framework/skills/browser-qa/SKILL.md +0 -536
  222. package/framework/skills/clarify/SKILL.md +0 -179
  223. package/framework/skills/client-handoff/SKILL.md +0 -135
  224. package/framework/skills/collab-onboard/SKILL.md +0 -111
  225. package/framework/skills/colorize/SKILL.md +0 -170
  226. package/framework/skills/critique/SKILL.md +0 -126
  227. package/framework/skills/deep-research/SKILL.md +0 -240
  228. package/framework/skills/delight/SKILL.md +0 -329
  229. package/framework/skills/deploy/SKILL.md +0 -261
  230. package/framework/skills/deploy-verify/SKILL.md +0 -377
  231. package/framework/skills/deploy-verify/scripts/canary-check.sh +0 -206
  232. package/framework/skills/deploy-verify/scripts/check-console-errors.js +0 -147
  233. package/framework/skills/deploy-verify/scripts/check-cwv.js +0 -139
  234. package/framework/skills/deploy-verify/scripts/project-detect.sh +0 -84
  235. package/framework/skills/deploy-verify/scripts/verify.sh +0 -548
  236. package/framework/skills/design-quieter/SKILL.md +0 -130
  237. package/framework/skills/distill/SKILL.md +0 -149
  238. package/framework/skills/docs-lookup/SKILL.md +0 -79
  239. package/framework/skills/fcm-notifications/SKILL.md +0 -125
  240. package/framework/skills/financial-ledger/SKILL.md +0 -1039
  241. package/framework/skills/frontend-master/NOTICE.md +0 -4
  242. package/framework/skills/frontend-master/SKILL.md +0 -127
  243. package/framework/skills/frontend-master/reference/color-and-contrast.md +0 -132
  244. package/framework/skills/frontend-master/reference/interaction-design.md +0 -123
  245. package/framework/skills/frontend-master/reference/motion-design.md +0 -99
  246. package/framework/skills/frontend-master/reference/responsive-design.md +0 -114
  247. package/framework/skills/frontend-master/reference/spatial-design.md +0 -100
  248. package/framework/skills/frontend-master/reference/typography.md +0 -131
  249. package/framework/skills/frontend-master/reference/ux-writing.md +0 -107
  250. package/framework/skills/harden/SKILL.md +0 -357
  251. package/framework/skills/i18n-rtl/SKILL.md +0 -752
  252. package/framework/skills/learn/SKILL.md +0 -95
  253. package/framework/skills/memory/SKILL.md +0 -50
  254. package/framework/skills/mobile-expo/SKILL.md +0 -977
  255. package/framework/skills/mobile-expo/references/store-checklist.md +0 -550
  256. package/framework/skills/nestjs-backend/README.md +0 -73
  257. package/framework/skills/nestjs-backend/SKILL.md +0 -446
  258. package/framework/skills/nestjs-backend/references/templates.md +0 -1173
  259. package/framework/skills/normalize/SKILL.md +0 -79
  260. package/framework/skills/onboard/SKILL.md +0 -242
  261. package/framework/skills/openrouter-agent/SKILL.md +0 -922
  262. package/framework/skills/polish/SKILL.md +0 -209
  263. package/framework/skills/pr/SKILL.md +0 -66
  264. package/framework/skills/qualia/SKILL.md +0 -199
  265. package/framework/skills/qualia-add-todo/SKILL.md +0 -68
  266. package/framework/skills/qualia-audit-milestone/SKILL.md +0 -95
  267. package/framework/skills/qualia-check-todos/SKILL.md +0 -55
  268. package/framework/skills/qualia-complete-milestone/SKILL.md +0 -134
  269. package/framework/skills/qualia-debug/SKILL.md +0 -149
  270. package/framework/skills/qualia-design/SKILL.md +0 -203
  271. package/framework/skills/qualia-discuss-phase/SKILL.md +0 -72
  272. package/framework/skills/qualia-evolve/SKILL.md +0 -200
  273. package/framework/skills/qualia-execute-phase/SKILL.md +0 -89
  274. package/framework/skills/qualia-framework-audit/SKILL.md +0 -604
  275. package/framework/skills/qualia-guide/SKILL.md +0 -32
  276. package/framework/skills/qualia-help/SKILL.md +0 -114
  277. package/framework/skills/qualia-idk/SKILL.md +0 -352
  278. package/framework/skills/qualia-list-phase-assumptions/SKILL.md +0 -67
  279. package/framework/skills/qualia-new-milestone/SKILL.md +0 -72
  280. package/framework/skills/qualia-new-project/SKILL.md +0 -232
  281. package/framework/skills/qualia-optimize/SKILL.md +0 -417
  282. package/framework/skills/qualia-pause-work/SKILL.md +0 -96
  283. package/framework/skills/qualia-plan-milestone-gaps/SKILL.md +0 -57
  284. package/framework/skills/qualia-plan-phase/SKILL.md +0 -104
  285. package/framework/skills/qualia-production-check/SKILL.md +0 -0
  286. package/framework/skills/qualia-progress/SKILL.md +0 -53
  287. package/framework/skills/qualia-quick/SKILL.md +0 -89
  288. package/framework/skills/qualia-report/SKILL.md +0 -166
  289. package/framework/skills/qualia-research-phase/SKILL.md +0 -88
  290. package/framework/skills/qualia-resume-work/SKILL.md +0 -62
  291. package/framework/skills/qualia-review/SKILL.md +0 -263
  292. package/framework/skills/qualia-start/SKILL.md +0 -161
  293. package/framework/skills/qualia-verify-work/SKILL.md +0 -132
  294. package/framework/skills/rag/SKILL.md +0 -750
  295. package/framework/skills/responsive/SKILL.md +0 -231
  296. package/framework/skills/retro/SKILL.md +0 -284
  297. package/framework/skills/sakani-conventions/SKILL.md +0 -136
  298. package/framework/skills/sakani-conventions/evals/evals.json +0 -23
  299. package/framework/skills/sakani-conventions/references/entities.md +0 -365
  300. package/framework/skills/sakani-conventions/references/error-codes.md +0 -95
  301. package/framework/skills/seo-master/SKILL.md +0 -490
  302. package/framework/skills/seo-master/references/checklist.md +0 -199
  303. package/framework/skills/seo-master/references/structured-data.md +0 -609
  304. package/framework/skills/ship/SKILL.md +0 -239
  305. package/framework/skills/stack-researcher/SKILL.md +0 -215
  306. package/framework/skills/status/SKILL.md +0 -154
  307. package/framework/skills/status/scripts/health-check.sh +0 -562
  308. package/framework/skills/subscription-payments/SKILL.md +0 -250
  309. package/framework/skills/supabase/SKILL.md +0 -973
  310. package/framework/skills/supabase/references/templates.md +0 -159
  311. package/framework/skills/team/SKILL.md +0 -67
  312. package/framework/skills/test-runner/SKILL.md +0 -202
  313. package/framework/skills/voice-agent/SKILL.md +0 -1312
  314. package/framework/skills/zoho-workflow/SKILL.md +0 -51
  315. package/framework/statusline-command.sh +0 -117
  316. package/framework/teams/default/inboxes/plan-04.json +0 -9
  317. package/framework/teams/review-team.md +0 -75
  318. package/framework/teams/ship-team.md +0 -86
  319. package/profiles/fawzi.json +0 -16
  320. package/profiles/hasan.json +0 -16
  321. package/profiles/moayad.json +0 -16
  322. package/templates/CLAUDE-owner.md +0 -52
  323. package/templates/CLAUDE.md.hbs +0 -58
  324. package/templates/env.claude.template +0 -12
  325. package/templates/settings.json +0 -172
  326. /package/{framework/rules → rules}/deployment.md +0 -0
  327. /package/{framework/rules → rules}/security.md +0 -0
package/templates/help.html ADDED
@@ -0,0 +1,476 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Qualia Framework — Reference</title>
7
+ <style>
8
+ :root {
9
+ --teal: #00ced1;
10
+ --teal-glow: #00aab0;
11
+ --teal-dim: #008285;
12
+ --bg: #0b1415;
13
+ --bg-subtle: #0f1c1e;
14
+ --bg-card: #121f21;
15
+ --text: #dce1e6;
16
+ --text-muted: #6b7a85;
17
+ --text-subtle: #4a5560;
18
+ --border: #1a2e30;
19
+ --green: #34d399;
20
+ --yellow: #eab308;
21
+ --red: #ef4444;
22
+ --blue: #60a5fa;
23
+ --font-display: 'Outfit', system-ui, sans-serif;
24
+ --font-body: 'Inter', system-ui, sans-serif;
25
+ --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
26
+ }
27
+
28
+ @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&family=Inter:wght@400;500&family=JetBrains+Mono:wght@400;500&display=swap');
29
+
30
+ * { margin: 0; padding: 0; box-sizing: border-box; }
31
+
32
+ body {
33
+ font-family: var(--font-body);
34
+ background: var(--bg);
35
+ color: var(--text);
36
+ line-height: 1.6;
37
+ -webkit-font-smoothing: antialiased;
38
+ }
39
+
40
+ /* ─── Header ─────────────────────────────── */
41
+ .header {
42
+ padding: clamp(2rem, 6vw, 4rem) clamp(1.5rem, 5vw, 4rem);
43
+ border-bottom: 1px solid var(--border);
44
+ background: linear-gradient(160deg, var(--bg-subtle), var(--bg));
45
+ position: relative;
46
+ overflow: hidden;
47
+ }
48
+ .header::before {
49
+ content: '';
50
+ position: absolute;
51
+ top: -40%;
52
+ right: -10%;
53
+ width: 400px;
54
+ height: 400px;
55
+ background: radial-gradient(circle, rgba(0,206,209,0.08), transparent 70%);
56
+ pointer-events: none;
57
+ }
58
+ .header-content { position: relative; max-width: 900px; margin: 0 auto; }
59
+ .header h1 {
60
+ font-family: var(--font-display);
61
+ font-weight: 300;
62
+ font-size: clamp(2rem, 1rem + 3vw, 3rem);
63
+ letter-spacing: -0.02em;
64
+ color: var(--text);
65
+ }
66
+ .header h1 span { color: var(--teal); font-weight: 600; }
67
+ .header p {
68
+ color: var(--text-muted);
69
+ font-size: 1rem;
70
+ margin-top: 0.75rem;
71
+ max-width: 50ch;
72
+ }
73
+ .version {
74
+ display: inline-block;
75
+ margin-top: 1rem;
76
+ padding: 0.25rem 0.75rem;
77
+ border: 1px solid var(--border);
78
+ border-radius: 999px;
79
+ font-family: var(--font-mono);
80
+ font-size: 0.75rem;
81
+ color: var(--teal-dim);
82
+ }
83
+
84
+ /* ─── Layout ─────────────────────────────── */
85
+ .content {
86
+ max-width: 900px;
87
+ margin: 0 auto;
88
+ padding: clamp(2rem, 5vw, 4rem) clamp(1.5rem, 5vw, 4rem);
89
+ }
90
+
91
+ /* ─── Sections ───────────────────────────── */
92
+ section { margin-bottom: 3.5rem; }
93
+ section h2 {
94
+ font-family: var(--font-display);
95
+ font-weight: 500;
96
+ font-size: 1.35rem;
97
+ letter-spacing: -0.01em;
98
+ color: var(--teal);
99
+ margin-bottom: 1.25rem;
100
+ padding-bottom: 0.5rem;
101
+ border-bottom: 1px solid var(--border);
102
+ }
103
+
104
+ /* ─── The Road ───────────────────────────── */
105
+ .road {
106
+ display: flex;
107
+ flex-wrap: wrap;
108
+ gap: 0.5rem;
109
+ align-items: center;
110
+ margin: 1.5rem 0;
111
+ }
112
+ .road-step {
113
+ padding: 0.5rem 1rem;
114
+ background: var(--bg-card);
115
+ border: 1px solid var(--border);
116
+ border-radius: 8px;
117
+ font-family: var(--font-mono);
118
+ font-size: 0.8rem;
119
+ color: var(--text);
120
+ transition: border-color 0.15s ease-out;
121
+ }
122
+ .road-step:hover { border-color: var(--teal-dim); }
123
+ .road-arrow { color: var(--text-subtle); font-size: 0.9rem; }
124
+
125
+ /* ─── Command Cards ──────────────────────── */
126
+ .commands { display: grid; gap: 0.75rem; }
127
+ .cmd-group { margin-bottom: 1.5rem; }
128
+ .cmd-group h3 {
129
+ font-family: var(--font-display);
130
+ font-weight: 500;
131
+ font-size: 0.85rem;
132
+ text-transform: uppercase;
133
+ letter-spacing: 0.08em;
134
+ color: var(--text-subtle);
135
+ margin-bottom: 0.75rem;
136
+ }
137
+ .cmd {
138
+ display: flex;
139
+ gap: 1rem;
140
+ align-items: baseline;
141
+ padding: 0.625rem 1rem;
142
+ background: var(--bg-card);
143
+ border: 1px solid var(--border);
144
+ border-radius: 8px;
145
+ transition: border-color 0.15s ease-out;
146
+ }
147
+ .cmd:hover { border-color: var(--teal-dim); }
148
+ .cmd-name {
149
+ font-family: var(--font-mono);
150
+ font-size: 0.85rem;
151
+ color: var(--teal);
152
+ white-space: nowrap;
153
+ min-width: 160px;
154
+ }
155
+ .cmd-desc {
156
+ font-size: 0.85rem;
157
+ color: var(--text-muted);
158
+ }
159
+
160
+ /* ─── Rules ──────────────────────────────── */
161
+ .rules { list-style: none; }
162
+ .rules li {
163
+ padding: 0.625rem 0;
164
+ border-bottom: 1px solid var(--border);
165
+ font-size: 0.9rem;
166
+ display: flex;
167
+ gap: 0.75rem;
168
+ align-items: baseline;
169
+ }
170
+ .rules li:last-child { border-bottom: none; }
171
+ .rule-icon { color: var(--teal); font-size: 0.85rem; flex-shrink: 0; }
172
+
173
+ /* ─── Services ───────────────────────────── */
174
+ .services {
175
+ display: grid;
176
+ grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
177
+ gap: 0.75rem;
178
+ }
179
+ .service {
180
+ padding: 1rem 1.25rem;
181
+ background: var(--bg-card);
182
+ border: 1px solid var(--border);
183
+ border-radius: 10px;
184
+ transition: border-color 0.15s ease-out;
185
+ }
186
+ .service:hover { border-color: var(--teal-dim); }
187
+ .service-name {
188
+ font-family: var(--font-display);
189
+ font-weight: 500;
190
+ font-size: 0.95rem;
191
+ color: var(--text);
192
+ margin-bottom: 0.25rem;
193
+ }
194
+ .service-desc { font-size: 0.8rem; color: var(--text-muted); }
195
+ .service-key {
196
+ font-family: var(--font-mono);
197
+ font-size: 0.7rem;
198
+ color: var(--teal-dim);
199
+ margin-top: 0.5rem;
200
+ }
201
+
202
+ /* ─── Scoring ────────────────────────────── */
203
+ .scoring {
204
+ display: grid;
205
+ grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
206
+ gap: 0.75rem;
207
+ }
208
+ .score-dim {
209
+ padding: 1rem;
210
+ background: var(--bg-card);
211
+ border: 1px solid var(--border);
212
+ border-radius: 10px;
213
+ text-align: center;
214
+ }
215
+ .score-dim h4 {
216
+ font-family: var(--font-display);
217
+ font-weight: 500;
218
+ color: var(--teal);
219
+ font-size: 0.95rem;
220
+ margin-bottom: 0.25rem;
221
+ }
222
+ .score-dim p { font-size: 0.78rem; color: var(--text-muted); }
223
+ .score-bar {
224
+ display: flex;
225
+ gap: 3px;
226
+ justify-content: center;
227
+ margin-top: 0.5rem;
228
+ }
229
+ .score-bar span {
230
+ width: 18px;
231
+ height: 6px;
232
+ border-radius: 3px;
233
+ background: var(--border);
234
+ }
235
+ .score-bar span.filled { background: var(--teal); }
236
+ .score-bar span.threshold { background: var(--yellow); }
237
+
238
+ /* ─── Footer ─────────────────────────────── */
239
+ .footer {
240
+ padding: 2rem clamp(1.5rem, 5vw, 4rem);
241
+ border-top: 1px solid var(--border);
242
+ text-align: center;
243
+ font-size: 0.8rem;
244
+ color: var(--text-subtle);
245
+ }
246
+ .footer strong { color: var(--teal); font-weight: 500; }
247
+
248
+ /* ─── Responsive ─────────────────────────── */
249
+ @media (max-width: 640px) {
250
+ .cmd { flex-direction: column; gap: 0.25rem; }
251
+ .cmd-name { min-width: unset; }
252
+ .road { flex-direction: column; align-items: flex-start; }
253
+ .road-arrow { display: none; }
254
+ }
255
+
256
+ @media (prefers-reduced-motion: reduce) {
257
+ * { transition-duration: 0.01ms !important; }
258
+ }
259
+ </style>
260
+ </head>
261
+ <body>
262
+
263
+ <div class="header">
264
+ <div class="header-content">
265
+ <h1><span>Qualia</span> Framework</h1>
266
+ <p>Plan, build, verify, ship. The AI-powered workflow for Qualia Solutions.</p>
267
+ <div class="version">v{{VERSION}}</div>
268
+ </div>
269
+ </div>
270
+
271
+ <div class="content">
272
+
273
+ <!-- The Road -->
274
+ <section>
275
+ <h2>The Road</h2>
276
+ <p style="color: var(--text-muted); margin-bottom: 1rem;">Every project follows this path. No exceptions.</p>
277
+ <div class="road">
278
+ <div class="road-step">/qualia-new</div>
279
+ <span class="road-arrow">&rarr;</span>
280
+ <div class="road-step">/qualia-plan</div>
281
+ <span class="road-arrow">&rarr;</span>
282
+ <div class="road-step">/qualia-build</div>
283
+ <span class="road-arrow">&rarr;</span>
284
+ <div class="road-step">/qualia-verify</div>
285
+ <span class="road-arrow">&rarr;</span>
286
+ <div class="road-step">/qualia-polish</div>
287
+ <span class="road-arrow">&rarr;</span>
288
+ <div class="road-step">/qualia-ship</div>
289
+ <span class="road-arrow">&rarr;</span>
290
+ <div class="road-step">/qualia-handoff</div>
291
+ <span class="road-arrow">&rarr;</span>
292
+ <div class="road-step">/qualia-report</div>
293
+ </div>
294
+ </section>
295
+
296
+ <!-- Commands -->
297
+ <section>
298
+ <h2>Commands</h2>
299
+
300
+ <div class="cmd-group">
301
+ <h3>Navigation</h3>
302
+ <div class="commands">
303
+ <div class="cmd"><span class="cmd-name">/qualia</span><span class="cmd-desc">What should I do next? Reads project state, tells you the exact command.</span></div>
304
+ <div class="cmd"><span class="cmd-name">/qualia-idk</span><span class="cmd-desc">Same as /qualia. For when you're stuck.</span></div>
305
+ <div class="cmd"><span class="cmd-name">/qualia-resume</span><span class="cmd-desc">Pick up where you left off from a previous session.</span></div>
306
+ <div class="cmd"><span class="cmd-name">/qualia-pause</span><span class="cmd-desc">Save progress. Creates .continue-here.md for next session.</span></div>
307
+ </div>
308
+ </div>
309
+
310
+ <div class="cmd-group">
311
+ <h3>Project Setup</h3>
312
+ <div class="commands">
313
+ <div class="cmd"><span class="cmd-name">/qualia-new</span><span class="cmd-desc">Interactive wizard. Asks about client, scope, design, stack. Creates everything.</span></div>
314
+ </div>
315
+ </div>
316
+
317
+ <div class="cmd-group">
318
+ <h3>Build Loop</h3>
319
+ <div class="commands">
320
+ <div class="cmd"><span class="cmd-name">/qualia-plan</span><span class="cmd-desc">Plan the current phase. AI generates tasks with success criteria.</span></div>
321
+ <div class="cmd"><span class="cmd-name">/qualia-build</span><span class="cmd-desc">Build it. Fresh AI agent per task, parallel waves.</span></div>
322
+ <div class="cmd"><span class="cmd-name">/qualia-verify</span><span class="cmd-desc">Verify it actually works. Greps code, scores on 4 dimensions.</span></div>
323
+ </div>
324
+ </div>
325
+
326
+ <div class="cmd-group">
327
+ <h3>Quick Work</h3>
328
+ <div class="commands">
329
+ <div class="cmd"><span class="cmd-name">/qualia-quick</span><span class="cmd-desc">Skip planning. For bug fixes, tweaks, hot fixes under 1 hour.</span></div>
330
+ <div class="cmd"><span class="cmd-name">/qualia-task</span><span class="cmd-desc">One focused task. More structured than quick, lighter than build.</span></div>
331
+ </div>
332
+ </div>
333
+
334
+ <div class="cmd-group">
335
+ <h3>Design & Quality</h3>
336
+ <div class="commands">
337
+ <div class="cmd"><span class="cmd-name">/qualia-design</span><span class="cmd-desc">One-shot design fix. Reads DESIGN.md, kills AI slop, makes it professional.</span></div>
338
+ <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Full design pass. Typography, color, states, motion, a11y, responsive, hardening.</span></div>
339
+ <div class="cmd"><span class="cmd-name">/qualia-review</span><span class="cmd-desc">Production audit. Security, performance, reliability. Scored diagnostics.</span></div>
340
+ </div>
341
+ </div>
342
+
343
+ <div class="cmd-group">
344
+ <h3>Ship & Deliver</h3>
345
+ <div class="commands">
346
+ <div class="cmd"><span class="cmd-name">/qualia-ship</span><span class="cmd-desc">Quality gates, commit, push, deploy to Vercel, post-deploy verification.</span></div>
347
+ <div class="cmd"><span class="cmd-name">/qualia-handoff</span><span class="cmd-desc">Client delivery. Credentials, docs, handover package.</span></div>
348
+ <div class="cmd"><span class="cmd-name">/qualia-report</span><span class="cmd-desc">Log your session. Mandatory before clock-out. Uploads to ERP.</span></div>
349
+ </div>
350
+ </div>
351
+
352
+ <div class="cmd-group">
353
+ <h3>Debugging & Learning</h3>
354
+ <div class="commands">
355
+ <div class="cmd"><span class="cmd-name">/qualia-debug</span><span class="cmd-desc">Structured debugging. Symptom &rarr; diagnosis &rarr; root cause &rarr; fix.</span></div>
356
+ <div class="cmd"><span class="cmd-name">/qualia-learn</span><span class="cmd-desc">Save a pattern, fix, or client preference to the knowledge base.</span></div>
357
+ <div class="cmd"><span class="cmd-name">/qualia-test</span><span class="cmd-desc">Generate or run tests. Auto-detects framework.</span></div>
358
+ </div>
359
+ </div>
360
+
361
+ <div class="cmd-group">
362
+ <h3>CLI (Terminal)</h3>
363
+ <div class="commands">
364
+ <div class="cmd"><span class="cmd-name">qualia-framework install</span><span class="cmd-desc">Install or reinstall the framework.</span></div>
365
+ <div class="cmd"><span class="cmd-name">qualia-framework update</span><span class="cmd-desc">Update to the latest version.</span></div>
366
+ <div class="cmd"><span class="cmd-name">qualia-framework version</span><span class="cmd-desc">Show installed version + check for updates.</span></div>
367
+ <div class="cmd"><span class="cmd-name">qualia-framework migrate</span><span class="cmd-desc">Upgrade v2 settings to v3.</span></div>
368
+ <div class="cmd"><span class="cmd-name">qualia-framework analytics</span><span class="cmd-desc">Hook telemetry, verification pass rates, gap cycles.</span></div>
369
+ <div class="cmd"><span class="cmd-name">qualia-framework team</span><span class="cmd-desc">List, add, or remove team members.</span></div>
370
+ <div class="cmd"><span class="cmd-name">qualia-framework traces</span><span class="cmd-desc">View recent hook activity.</span></div>
371
+ </div>
372
+ </div>
373
+ </section>
374
+
375
+ <!-- Verification Scoring -->
376
+ <section>
377
+ <h2>Verification Scoring</h2>
378
+ <p style="color: var(--text-muted); margin-bottom: 1rem;">Every phase is scored on 4 dimensions. Any score below 3 = automatic FAIL.</p>
379
+ <div class="scoring">
380
+ <div class="score-dim">
381
+ <h4>Correctness</h4>
382
+ <p>Does it work as expected?</p>
383
+ <div class="score-bar"><span class="filled"></span><span class="filled"></span><span class="threshold"></span><span></span><span></span></div>
384
+ </div>
385
+ <div class="score-dim">
386
+ <h4>Completeness</h4>
387
+ <p>Are all requirements met?</p>
388
+ <div class="score-bar"><span class="filled"></span><span class="filled"></span><span class="threshold"></span><span></span><span></span></div>
389
+ </div>
390
+ <div class="score-dim">
391
+ <h4>Wiring</h4>
392
+ <p>Is everything connected end-to-end?</p>
393
+ <div class="score-bar"><span class="filled"></span><span class="filled"></span><span class="threshold"></span><span></span><span></span></div>
394
+ </div>
395
+ <div class="score-dim">
396
+ <h4>Quality</h4>
397
+ <p>Code quality, security, a11y?</p>
398
+ <div class="score-bar"><span class="filled"></span><span class="filled"></span><span class="threshold"></span><span></span><span></span></div>
399
+ </div>
400
+ </div>
401
+ </section>
402
+
403
+ <!-- Rules -->
404
+ <section>
405
+ <h2>Rules</h2>
406
+ <ul class="rules">
407
+ <li><span class="rule-icon">1</span> Feature branches only &mdash; never push to main</li>
408
+ <li><span class="rule-icon">2</span> Read before write &mdash; understand files before editing</li>
409
+ <li><span class="rule-icon">3</span> MVP first &mdash; build what's asked, nothing extra</li>
410
+ <li><span class="rule-icon">4</span> /qualia-report before clock-out &mdash; mandatory, enforced by ERP</li>
411
+ <li><span class="rule-icon">5</span> No .env edits &mdash; ask Fawzi for secrets</li>
412
+ <li><span class="rule-icon">6</span> Stuck 30+ minutes? Ask Fawzi</li>
413
+ </ul>
414
+ </section>
415
+
416
+ <!-- Services -->
417
+ <section>
418
+ <h2>Our Stack</h2>
419
+ <div class="services">
420
+ <div class="service">
421
+ <div class="service-name">Supabase</div>
422
+ <div class="service-desc">Database, auth, storage. Every project. MCP + CLI available.</div>
423
+ <div class="service-key">Always enable RLS</div>
424
+ </div>
425
+ <div class="service">
426
+ <div class="service-name">Vercel</div>
427
+ <div class="service-desc">Hosting. 3 teams. No auto-deploy &mdash; CLI only via /qualia-ship.</div>
428
+ <div class="service-key">vercel --prod</div>
429
+ </div>
430
+ <div class="service">
431
+ <div class="service-name">Railway</div>
432
+ <div class="service-desc">Long-running agents, background jobs. MCP + CLI available.</div>
433
+ <div class="service-key">railway deploy</div>
434
+ </div>
435
+ <div class="service">
436
+ <div class="service-name">OpenRouter</div>
437
+ <div class="service-desc">AI model routing. One API key for all models.</div>
438
+ <div class="service-key">Ask Fawzi for a key</div>
439
+ </div>
440
+ <div class="service">
441
+ <div class="service-name">Retell AI</div>
442
+ <div class="service-desc">Voice agents. Primary voice platform.</div>
443
+ <div class="service-key">RETELL_API_KEY</div>
444
+ </div>
445
+ <div class="service">
446
+ <div class="service-name">ElevenLabs</div>
447
+ <div class="service-desc">Voice synthesis, cloning, streaming.</div>
448
+ <div class="service-key">ELEVENLABS_API_KEY</div>
449
+ </div>
450
+ </div>
451
+ </section>
452
+
453
+ <!-- GitHub -->
454
+ <section>
455
+ <h2>GitHub Organizations</h2>
456
+ <div class="services" style="grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));">
457
+ <div class="service">
458
+ <div class="service-name">QualiasolutionsCY</div>
459
+ <div class="service-desc">Primary org. All Qualia Solutions projects.</div>
460
+ </div>
461
+ <div class="service">
462
+ <div class="service-name">SakaniQualia</div>
463
+ <div class="service-desc">Sakani real estate platform.</div>
464
+ </div>
465
+ </div>
466
+ </section>
467
+
468
+ </div>
469
+
470
+ <div class="footer">
471
+ <strong>Welcome to the future with Qualia.</strong><br>
472
+ Qualia Solutions &mdash; Nicosia, Cyprus
473
+ </div>
474
+
475
+ </body>
476
+ </html>
package/templates/plan.md ADDED
@@ -0,0 +1,42 @@
1
+ ---
2
+ phase: {N}
3
+ goal: "{phase goal}"
4
+ tasks: {count}
5
+ waves: {count}
6
+ ---
7
+
8
+ # Phase {N}: {Name}
9
+
10
+ Goal: {what must be true when done}
11
+
12
+ ## Task 1 — {title}
13
+ **Wave:** 1
14
+ **Files:** {files to create or modify}
15
+ **Action:** {exactly what to build}
16
+ **Context:** Read @{file references}
17
+ **Done when:** {observable, testable criterion}
18
+
19
+ ## Task 2 — {title}
20
+ **Wave:** 1
21
+ **Files:** {files}
22
+ **Action:** {what to build}
23
+ **Done when:** {criterion}
24
+
25
+ ## Success Criteria
26
+ - [ ] {truth 1 — what the user can do}
27
+ - [ ] {truth 2}
28
+ - [ ] {truth 3}
29
+
30
+ ## Verification Contract
31
+
32
+ ### Contract for Task 1 — {title}
33
+ **Check type:** {file-exists | grep-match | command-exit | behavioral}
34
+ **Command:** `{exact command the verifier will run}`
35
+ **Expected:** {what the output should be}
36
+ **Fail if:** {what constitutes failure}
37
+
38
+ ### Contract for Task 2 — {title}
39
+ **Check type:** {file-exists | grep-match | command-exit | behavioral}
40
+ **Command:** `{exact command}`
41
+ **Expected:** {expected output}
42
+ **Fail if:** {failure condition}
package/templates/project.md ADDED
@@ -0,0 +1,22 @@
1
+ # {Project Name}
2
+
3
+ ## Client
4
+ {client name}
5
+
6
+ ## What We're Building
7
+ {description}
8
+
9
+ ## Requirements
10
+ - [ ] {requirement 1}
11
+ - [ ] {requirement 2}
12
+ - [ ] {requirement 3}
13
+
14
+ ## Out of Scope
15
+ - {exclusion 1}
16
+
17
+ ## Stack
18
+ Next.js 16+ / React 19 / TypeScript / Supabase / Vercel
19
+
20
+ ## Decisions
21
+ | Decision | Why |
22
+ |----------|-----|
package/templates/state.md ADDED
@@ -0,0 +1,27 @@
1
+ # Project State
2
+
3
+ ## Project
4
+ See: .planning/PROJECT.md
5
+
6
+ ## Current Position
7
+ Phase: 1 of {N} — {Phase Name}
8
+ Status: ready to plan
9
+ Assigned to: {employee}
10
+ Last activity: {date} — Project initialized
11
+
12
+ Progress: [░░░░░░░░░░] 0%
13
+
14
+ ## Roadmap
15
+ | # | Phase | Goal | Status |
16
+ |---|-------|------|--------|
17
+ | 1 | {name} | {goal} | ready |
18
+ | 2 | {name} | {goal} | — |
19
+ | 3 | {name} | {goal} | — |
20
+
21
+ ## Blockers
22
+ None.
23
+
24
+ ## Session
25
+ Last session: {date}
26
+ Last worked by: {employee}
27
+ Resume: —
package/templates/tracking.json ADDED
@@ -0,0 +1,20 @@
1
+ {
2
+ "project": "",
3
+ "client": "",
4
+ "type": "",
5
+ "assigned_to": "",
6
+ "phase": 0,
7
+ "phase_name": "",
8
+ "total_phases": 0,
9
+ "status": "setup",
10
+ "wave": 0,
11
+ "tasks_done": 0,
12
+ "tasks_total": 0,
13
+ "verification": "pending",
14
+ "gap_cycles": {},
15
+ "blockers": [],
16
+ "last_updated": "",
17
+ "last_commit": "",
18
+ "deployed_url": "",
19
+ "notes": ""
20
+ }