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.
- package/bin/cli.js +14 -9
- package/framework/.claudeignore +51 -0
- package/framework/CLAUDE.md +54 -0
- package/framework/MCP_SETUP.md +229 -0
- package/framework/agents/architecture-strategist.md +1 -1
- package/framework/agents/code-simplicity-reviewer.md +1 -1
- package/framework/agents/kieran-typescript-reviewer.md +1 -1
- package/framework/agents/performance-oracle.md +1 -1
- package/framework/agents/qualia-codebase-mapper.md +1 -0
- package/framework/agents/qualia-debugger.md +1 -0
- package/framework/agents/qualia-executor.md +1 -0
- package/framework/agents/qualia-integration-checker.md +1 -0
- package/framework/agents/qualia-phase-researcher.md +1 -0
- package/framework/agents/qualia-plan-checker.md +1 -0
- package/framework/agents/qualia-planner.md +1 -0
- package/framework/agents/qualia-project-researcher.md +1 -0
- package/framework/agents/qualia-research-synthesizer.md +1 -0
- package/framework/agents/qualia-roadmapper.md +1 -0
- package/framework/agents/qualia-verifier.md +1 -0
- package/framework/agents/security-auditor.md +72 -0
- package/framework/agents/team-orchestrator.md +1 -0
- package/framework/agents/teams/framework-audit-team.md +66 -0
- package/framework/agents/teams/review-team.md +11 -3
- package/framework/hooks/block-env-edit.sh +4 -8
- package/framework/hooks/branch-guard.sh +2 -5
- package/framework/hooks/confirm-delete.sh +7 -4
- package/framework/hooks/migration-validate.sh +9 -8
- package/framework/hooks/notification-speak.sh +1 -1
- package/framework/hooks/pre-commit.sh +22 -10
- package/framework/hooks/pre-deploy-gate.sh +5 -6
- package/framework/hooks/retention-cleanup.sh +11 -2
- package/framework/hooks/save-session-state.sh +22 -0
- package/framework/hooks/session-context-loader.sh +27 -29
- package/framework/hooks/session-learn.sh +6 -5
- package/framework/hooks/skill-announce.sh +109 -6
- package/framework/hooks/tool-error-announce.sh +16 -7
- package/framework/install.ps1 +323 -0
- package/framework/install.sh +306 -0
- package/framework/qualia-engine/references/completion-checklists.md +359 -0
- package/framework/rules/deployment.md +4 -3
- package/framework/rules/speed.md +4 -0
- package/framework/skills/animate/SKILL.md +1 -1
- package/framework/skills/bolder/SKILL.md +1 -1
- package/framework/skills/colorize/SKILL.md +1 -1
- package/framework/skills/deep-research/SKILL.md +19 -13
- package/framework/skills/delight/SKILL.md +1 -1
- package/framework/skills/design-quieter/SKILL.md +1 -1
- package/framework/skills/distill/SKILL.md +1 -1
- package/framework/skills/qualia-audit-milestone/SKILL.md +1 -1
- package/framework/skills/qualia-complete-milestone/SKILL.md +2 -2
- package/framework/skills/qualia-design/SKILL.md +2 -2
- package/framework/skills/qualia-framework-audit/SKILL.md +604 -0
- package/framework/skills/qualia-help/SKILL.md +11 -1
- package/framework/skills/qualia-pause-work/SKILL.md +2 -2
- package/framework/skills/qualia-review/SKILL.md +1 -1
- package/framework/skills/qualia-start/SKILL.md +8 -1
- package/framework/skills/qualia-verify-work/SKILL.md +1 -1
- package/framework/skills/ship/SKILL.md +1 -1
- package/framework/teams/default/inboxes/plan-04.json +9 -0
- package/package.json +1 -1
- package/framework/askpass.sh +0 -2
- package/framework/commands/design.md +0 -53
- package/framework/commands/quick-db.md +0 -22
- package/framework/config/retention.json +0 -35
- package/framework/core/PRINCIPLES.md +0 -77
- package/framework/knowledge/claudecode-bible.md +0 -1384
- package/framework/knowledge/client-prefs.md +0 -22
- package/framework/knowledge/common-fixes.md +0 -25
- package/framework/knowledge/deployment-map.md +0 -35
- package/framework/knowledge/email-signature.html +0 -1
- package/framework/knowledge/employees.md +0 -8
- package/framework/knowledge/learned-patterns.md +0 -51
- package/framework/knowledge/optimization-research-2026.md +0 -137
- package/framework/knowledge/qualia-context.md +0 -67
- package/framework/knowledge/supabase-patterns.md +0 -50
- 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
package/framework/askpass.sh
DELETED
|
@@ -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
|