qualia-framework 2.1.5 → 2.2.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 (76) hide show
  1. package/bin/cli.js +14 -9
  2. package/framework/.claudeignore +51 -0
  3. package/framework/CLAUDE.md +54 -0
  4. package/framework/MCP_SETUP.md +229 -0
  5. package/framework/agents/architecture-strategist.md +1 -1
  6. package/framework/agents/code-simplicity-reviewer.md +1 -1
  7. package/framework/agents/kieran-typescript-reviewer.md +1 -1
  8. package/framework/agents/performance-oracle.md +1 -1
  9. package/framework/agents/qualia-codebase-mapper.md +1 -0
  10. package/framework/agents/qualia-debugger.md +1 -0
  11. package/framework/agents/qualia-executor.md +1 -0
  12. package/framework/agents/qualia-integration-checker.md +1 -0
  13. package/framework/agents/qualia-phase-researcher.md +1 -0
  14. package/framework/agents/qualia-plan-checker.md +1 -0
  15. package/framework/agents/qualia-planner.md +1 -0
  16. package/framework/agents/qualia-project-researcher.md +1 -0
  17. package/framework/agents/qualia-research-synthesizer.md +1 -0
  18. package/framework/agents/qualia-roadmapper.md +1 -0
  19. package/framework/agents/qualia-verifier.md +1 -0
  20. package/framework/agents/security-auditor.md +72 -0
  21. package/framework/agents/team-orchestrator.md +1 -0
  22. package/framework/agents/teams/framework-audit-team.md +66 -0
  23. package/framework/agents/teams/review-team.md +11 -3
  24. package/framework/hooks/block-env-edit.sh +4 -8
  25. package/framework/hooks/branch-guard.sh +2 -5
  26. package/framework/hooks/confirm-delete.sh +7 -4
  27. package/framework/hooks/migration-validate.sh +9 -8
  28. package/framework/hooks/notification-speak.sh +1 -1
  29. package/framework/hooks/pre-commit.sh +22 -10
  30. package/framework/hooks/pre-deploy-gate.sh +5 -6
  31. package/framework/hooks/retention-cleanup.sh +11 -2
  32. package/framework/hooks/save-session-state.sh +22 -0
  33. package/framework/hooks/session-context-loader.sh +27 -29
  34. package/framework/hooks/session-learn.sh +6 -5
  35. package/framework/hooks/skill-announce.sh +109 -6
  36. package/framework/hooks/tool-error-announce.sh +16 -7
  37. package/framework/install.ps1 +323 -0
  38. package/framework/install.sh +306 -0
  39. package/framework/qualia-engine/references/completion-checklists.md +359 -0
  40. package/framework/rules/deployment.md +4 -3
  41. package/framework/rules/speed.md +4 -0
  42. package/framework/skills/animate/SKILL.md +1 -1
  43. package/framework/skills/bolder/SKILL.md +1 -1
  44. package/framework/skills/colorize/SKILL.md +1 -1
  45. package/framework/skills/deep-research/SKILL.md +19 -13
  46. package/framework/skills/delight/SKILL.md +1 -1
  47. package/framework/skills/design-quieter/SKILL.md +1 -1
  48. package/framework/skills/distill/SKILL.md +1 -1
  49. package/framework/skills/qualia-audit-milestone/SKILL.md +1 -1
  50. package/framework/skills/qualia-complete-milestone/SKILL.md +2 -2
  51. package/framework/skills/qualia-design/SKILL.md +2 -2
  52. package/framework/skills/qualia-framework-audit/SKILL.md +604 -0
  53. package/framework/skills/qualia-help/SKILL.md +11 -1
  54. package/framework/skills/qualia-pause-work/SKILL.md +2 -2
  55. package/framework/skills/qualia-review/SKILL.md +1 -1
  56. package/framework/skills/qualia-start/SKILL.md +8 -1
  57. package/framework/skills/qualia-verify-work/SKILL.md +1 -1
  58. package/framework/skills/ship/SKILL.md +1 -1
  59. package/framework/teams/default/inboxes/plan-04.json +9 -0
  60. package/package.json +1 -1
  61. package/framework/askpass.sh +0 -2
  62. package/framework/commands/design.md +0 -53
  63. package/framework/commands/quick-db.md +0 -22
  64. package/framework/config/retention.json +0 -35
  65. package/framework/core/PRINCIPLES.md +0 -77
  66. package/framework/knowledge/claudecode-bible.md +0 -1384
  67. package/framework/knowledge/client-prefs.md +0 -22
  68. package/framework/knowledge/common-fixes.md +0 -25
  69. package/framework/knowledge/deployment-map.md +0 -35
  70. package/framework/knowledge/email-signature.html +0 -1
  71. package/framework/knowledge/employees.md +0 -8
  72. package/framework/knowledge/learned-patterns.md +0 -51
  73. package/framework/knowledge/optimization-research-2026.md +0 -137
  74. package/framework/knowledge/qualia-context.md +0 -67
  75. package/framework/knowledge/supabase-patterns.md +0 -50
  76. package/framework/knowledge/voice-agent-patterns.md +0 -46
@@ -0,0 +1,9 @@
1
+ [
2
+ {
3
+ "from": "team-lead",
4
+ "text": "Checkpoint approved. All verification passed:\n- Server boots clean, 96 permissions cached\n- All 9 Phase 1.4 endpoints return 401 unauthenticated (tested with /api/v1/ prefix)\n- Health endpoint returns 200\n- pnpm check-types: 5/5 workspaces pass, 0 errors\n- Route ordering confirmed: /mine before /:claimId in startup logs\n\nContinue to create SUMMARY.md and update STATE.md.",
5
+ "summary": "Approve checkpoint, continue SUMMARY",
6
+ "timestamp": "2026-03-22T01:22:15.460Z",
7
+ "read": false
8
+ }
9
+ ]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "qualia-framework",
3
- "version": "2.1.5",
3
+ "version": "2.2.0",
4
4
  "description": "Qualia Solutions — Claude Code Framework",
5
5
  "bin": {
6
6
  "qualia-framework": "./bin/cli.js"
@@ -1,2 +0,0 @@
1
- #!/bin/bash
2
- echo "pornbeast"
@@ -1,53 +0,0 @@
1
- ---
2
- description: Apply professional design system for websites, apps, UI/UX, components, and business documents
3
- argument-hint: "[website|app|dashboard|landing-page|component|document] [description or URL]"
4
- allowed-tools:
5
- - Read
6
- - Write
7
- - Edit
8
- - Bash
9
- - Glob
10
- - Grep
11
- - AskUserQuestion
12
- ---
13
-
14
- <objective>
15
- Design and build professionally styled interfaces, components, and documents using a comprehensive design system. Uses the `frontend-master` skill for consistent visual hierarchy, spacing, color tokens, and modern design patterns.
16
-
17
- **Supported contexts:**
18
- - **Websites & Landing Pages** — Hero sections, feature grids, pricing tables, testimonials, CTAs, footers
19
- - **Web Apps & Dashboards** — Sidebar nav, stat cards, data tables, charts, activity feeds, filters
20
- - **UI Components** — Buttons, forms, cards, modals, navigation, tables, toasts, dropdowns
21
- - **Mobile & Responsive** — Bottom nav, touch targets, responsive breakpoints, mobile-first layouts
22
- - **Business Documents** — Contracts, proposals, SOWs, NDAs, invoices, reports (docx/PDF output)
23
-
24
- **What it does:**
25
- - Applies design tokens: colors (light/dark mode), typography scale, 8px spacing grid
26
- - Implements component patterns with proper states (hover, focus, active, disabled, loading, error)
27
- - Ensures WCAG AA accessibility (contrast, keyboard nav, screen reader, touch targets)
28
- - Uses responsive breakpoints (640px → 1536px+) with mobile-first approach
29
- - Structures layouts using CSS Grid/Flexbox with proper max-widths
30
- - Outputs as HTML/React/JSX for interfaces, or .docx/.pdf for documents
31
- </objective>
32
-
33
- <process>
34
- 1. Read the `frontend-master` skill from `skills/frontend-master/SKILL.md`
35
- 2. Determine the design context from $ARGUMENTS:
36
- - **Interface/component**: Identify what's being built (page, component, full app)
37
- - **Document**: Identify document type (contract, proposal, invoice, etc.)
38
- 3. If redesigning existing work, read/screenshot it and identify improvements
39
- 4. If creating from scratch:
40
- - Ask for key details (purpose, audience, features, brand preferences)
41
- - Select appropriate layout pattern from the skill
42
- - Choose color palette (or use defaults with primary accent)
43
- 5. Build with the design system:
44
- - Apply color tokens, typography scale, spacing grid
45
- - Implement proper component patterns with all interaction states
46
- - Ensure responsive behavior at all breakpoints
47
- - Add accessibility features (contrast, focus indicators, ARIA)
48
- 6. Run through the design checklist (visual, interactive, responsive, performance)
49
- 7. Output the appropriate format:
50
- - HTML/React/JSX for web interfaces
51
- - .docx or .pdf for business documents
52
- - Code snippets for individual components
53
- </process>
@@ -1,22 +0,0 @@
1
- ---
2
- description: Quick Supabase database operation (query, migration, RLS)
3
- ---
4
-
5
- Perform a Supabase database operation using the Supabase CLI (not MCP).
6
-
7
- ## Available Operations:
8
- 1. **Query**: Run SELECT queries via `supabase db execute`
9
- 2. **Migration**: Create schema changes via `supabase migration new`
10
- 3. **RLS**: Set up row-level security policies
11
- 4. **Types**: Generate TypeScript types via `supabase gen types typescript`
12
-
13
- ## Process:
14
- 1. Understand the request
15
- 2. Use the `/supabase` skill's CLI-first approach to execute
16
- 3. Show results or created SQL
17
- 4. If migration, provide the SQL file content
18
-
19
- For comprehensive database operations, use `/supabase` instead.
20
-
21
- ## Request:
22
- $ARGUMENTS
@@ -1,35 +0,0 @@
1
- {
2
- "version": "1.0",
3
- "description": "Retention policies for .claude directory state management",
4
- "policies": {
5
- "file-history": {
6
- "max_versions": 5,
7
- "max_age_days": 7,
8
- "compress_after_days": 3,
9
- "description": "File modification tracking"
10
- },
11
- "debug-logs": {
12
- "max_age_days": 30,
13
- "compress_after_days": 7,
14
- "description": "Agent execution traces"
15
- },
16
- "shell-snapshots": {
17
- "max_age_days": 7,
18
- "description": "Bash environment snapshots"
19
- },
20
- "todos": {
21
- "archive_after_days": 180,
22
- "description": "Task tracking files"
23
- },
24
- "projects": {
25
- "archive_after_days": 90,
26
- "compress": true,
27
- "description": "Per-project session state"
28
- },
29
- "session-env": {
30
- "cleanup_empty": true,
31
- "max_age_days": 30,
32
- "description": "Session environment state"
33
- }
34
- }
35
- }
@@ -1,77 +0,0 @@
1
- # Software Engineering Principles
2
-
3
- **Core Directive**: Evidence > assumptions | Code > documentation | Efficiency > verbosity
4
-
5
- ## Philosophy
6
- - **Task-First Approach**: Understand → Plan → Execute → Validate
7
- - **Evidence-Based Reasoning**: All claims verifiable through testing, metrics, or documentation
8
- - **Parallel Thinking**: Maximize efficiency through intelligent batching and coordination
9
- - **Context Awareness**: Maintain project understanding across sessions and operations
10
-
11
- ## Engineering Mindset
12
-
13
- ### SOLID
14
- - **Single Responsibility**: Each component has one reason to change
15
- - **Open/Closed**: Open for extension, closed for modification
16
- - **Liskov Substitution**: Derived classes substitutable for base classes
17
- - **Interface Segregation**: Don't depend on unused interfaces
18
- - **Dependency Inversion**: Depend on abstractions, not concretions
19
-
20
- ### Core Patterns
21
- - **DRY**: Abstract common functionality, eliminate duplication
22
- - **KISS**: Prefer simplicity over complexity in design decisions
23
- - **YAGNI**: Implement current requirements only, avoid speculation
24
-
25
- ### Systems Thinking
26
- - **Ripple Effects**: Consider architecture-wide impact of decisions
27
- - **Long-term Perspective**: Evaluate immediate vs. future trade-offs
28
- - **Risk Calibration**: Balance acceptable risks with delivery constraints
29
-
30
- ## Decision Framework
31
-
32
- ### Data-Driven Choices
33
- - **Measure First**: Base optimization on measurements, not assumptions
34
- - **Hypothesis Testing**: Formulate and test systematically
35
- - **Source Validation**: Verify information credibility
36
- - **Bias Recognition**: Account for cognitive biases
37
-
38
- ### Trade-off Analysis
39
- - **Temporal Impact**: Immediate vs. long-term consequences
40
- - **Reversibility**: Classify as reversible, costly, or irreversible
41
- - **Option Preservation**: Maintain future flexibility under uncertainty
42
-
43
- ### Risk Management
44
- - **Proactive Identification**: Anticipate issues before manifestation
45
- - **Impact Assessment**: Evaluate probability and severity
46
- - **Mitigation Planning**: Develop risk reduction strategies
47
-
48
- ## Quality Philosophy
49
-
50
- ### Quality Quadrants
51
- - **Functional**: Correctness, reliability, feature completeness
52
- - **Structural**: Code organization, maintainability, technical debt
53
- - **Performance**: Speed, scalability, resource efficiency
54
- - **Security**: Vulnerability management, access control, data protection
55
-
56
- ### Quality Standards
57
- - **Automated Enforcement**: Use tooling for consistent quality
58
- - **Preventive Measures**: Catch issues early when cheaper to fix
59
- - **Human-Centered Design**: Prioritize user welfare and autonomy
60
-
61
- ## Confidence-First Implementation
62
-
63
- ### Pre-Execution Validation
64
- Before starting significant work, assess confidence level:
65
-
66
- - **≥90% Confidence**: Proceed with implementation
67
- - **70-89% Confidence**: Present alternatives, gather more information
68
- - **<70% Confidence**: STOP - Ask questions, do not proceed
69
-
70
- ### Confidence Checklist
71
- - [ ] No duplicate implementation exists
72
- - [ ] Architecture patterns consulted
73
- - [ ] Official documentation verified
74
- - [ ] Root cause identified (for debugging)
75
- - [ ] Edge cases considered
76
-
77
- **ROI**: 100-200 token investment prevents 5,000-50,000 token waste on wrong direction