@bastani/atomic 0.5.11 → 0.5.12-1

package/.agents/skills/bdi-mental-states/references/sparql-competency.md

@@ -0,0 +1,420 @@
+# SPARQL Competency Queries
+
+Validation queries for BDI ontology implementations based on competency questions.
+
+## Mental Entity Queries
+
+### CQ1: What are all mental entities?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+
+SELECT DISTINCT ?entity ?type WHERE {
+    ?entity rdf:type ?type .
+    ?type rdfs:subClassOf* bdi:MentalEntity .
+}
+```
+
+### CQ2: What beliefs does an agent hold?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?label WHERE {
+    ?agent bdi:hasMentalState ?belief .
+    ?belief a bdi:Belief .
+    OPTIONAL { ?belief rdfs:label ?label }
+}
+```
+
+### CQ3: What desires does an agent have?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?desire ?label WHERE {
+    ?agent bdi:hasDesire ?desire .
+    ?desire a bdi:Desire .
+    OPTIONAL { ?desire rdfs:label ?label }
+}
+```
+
+### CQ4: What intentions has an agent committed to?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?intention ?label WHERE {
+    ?agent bdi:hasIntention ?intention .
+    ?intention a bdi:Intention .
+    OPTIONAL { ?intention rdfs:label ?label }
+}
+```
+
+## Motivational Chain Queries
+
+### CQ5: What beliefs motivated formation of a given desire?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?beliefLabel WHERE {
+    ?desire bdi:isMotivatedBy ?belief .
+    ?belief a bdi:Belief .
+    OPTIONAL { ?belief rdfs:label ?beliefLabel }
+}
+```
+
+### CQ6: Which desire does a particular intention fulfill?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?desire ?desireLabel WHERE {
+    ?intention bdi:fulfils ?desire .
+    ?desire a bdi:Desire .
+    OPTIONAL { ?desire rdfs:label ?desireLabel }
+}
+```
+
+### CQ7: What beliefs support a given intention?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?label WHERE {
+    ?intention bdi:isSupportedBy ?belief .
+    ?belief a bdi:Belief .
+    OPTIONAL { ?belief rdfs:label ?label }
+}
+```
+
+### CQ8: Trace complete cognitive chain for an intention
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?intention ?desire ?belief ?worldState WHERE {
+    ?intention a bdi:Intention ;
+               bdi:fulfils ?desire ;
+               bdi:isSupportedBy ?belief .
+    ?desire bdi:isMotivatedBy ?belief .
+    ?belief bdi:refersTo ?worldState .
+}
+```
+
+## Mental Process Queries
+
+### CQ9: Which mental process generated a belief?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?process ?processType WHERE {
+    ?process bdi:generates ?belief .
+    ?belief a bdi:Belief .
+    ?process a ?processType .
+    FILTER(?processType != owl:NamedIndividual)
+}
+```
+
+### CQ10: What triggered a mental process?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?process ?trigger ?triggerType WHERE {
+    ?process a bdi:MentalProcess ;
+             bdi:isTriggeredBy ?trigger .
+    ?trigger a ?triggerType .
+}
+```
+
+### CQ11: What did a mental process reason upon?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?process ?input WHERE {
+    ?process a bdi:MentalProcess ;
+             bdi:reasonsUpon ?input .
+}
+```
+
+## Plan and Goal Queries
+
+### CQ12: What plan does an intention specify?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?intention ?plan ?goal WHERE {
+    ?intention bdi:specifies ?plan .
+    ?plan a bdi:Plan ;
+          bdi:addresses ?goal .
+}
+```
+
+### CQ13: What is the ordered sequence of tasks in a plan?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?plan ?task ?nextTask WHERE {
+    ?plan a bdi:Plan ;
+          bdi:hasComponent ?task .
+    OPTIONAL { ?task bdi:precedes ?nextTask }
+}
+ORDER BY ?task
+```
+
+### CQ14: What is the first and last task of a plan?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?plan ?firstTask ?lastTask WHERE {
+    ?plan a bdi:Plan ;
+          bdi:beginsWith ?firstTask ;
+          bdi:endsWith ?lastTask .
+}
+```
+
+### CQ15: Which actions executed which tasks?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?action ?task ?time WHERE {
+    ?action bdi:isExecutionOf ?task ;
+            bdi:atTime ?time .
+}
+ORDER BY ?time
+```
+
+## Temporal Queries
+
+### CQ16: What mental states are valid at a specific time?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
+
+SELECT ?mentalState ?type WHERE {
+    ?mentalState bdi:hasValidity ?interval .
+    ?interval bdi:hasStartTime ?start ;
+              bdi:hasEndTime ?end .
+    ?mentalState a ?type .
+    FILTER(?start <= "2026-01-04T10:00:00"^^xsd:dateTime && 
+           ?end >= "2026-01-04T10:00:00"^^xsd:dateTime)
+}
+```
+
+### CQ17: When was a belief formed?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?formationTime WHERE {
+    ?process bdi:generates ?belief ;
+             bdi:atTime ?formationTime .
+    ?belief a bdi:Belief .
+}
+```
+
+### CQ18: What is the temporal validity of an intention?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?intention ?start ?end WHERE {
+    ?intention a bdi:Intention ;
+               bdi:hasValidity ?interval .
+    ?interval bdi:hasStartTime ?start ;
+              bdi:hasEndTime ?end .
+}
+```
+
+## Justification Queries
+
+### CQ19: What justifies a belief?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?justification ?justLabel WHERE {
+    ?belief a bdi:Belief ;
+            bdi:isJustifiedBy ?justification .
+    OPTIONAL { ?justification rdfs:label ?justLabel }
+}
+```
+
+### CQ20: What justifies an intention?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?intention ?justification ?justLabel WHERE {
+    ?intention a bdi:Intention ;
+               bdi:isJustifiedBy ?justification .
+    OPTIONAL { ?justification rdfs:label ?justLabel }
+}
+```
+
+## Compositional Queries
+
+### CQ21: What parts comprise a complex belief?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?part ?partLabel WHERE {
+    ?belief a bdi:Belief ;
+            bdi:hasPart ?part .
+    OPTIONAL { ?part rdfs:label ?partLabel }
+}
+```
+
+### CQ22: Find composite mental entities
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?composite (COUNT(?part) AS ?partCount) WHERE {
+    ?composite bdi:hasPart ?part .
+}
+GROUP BY ?composite
+HAVING (COUNT(?part) > 1)
+```
+
+## World State Queries
+
+### CQ23: What world state does a belief refer to?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief ?worldState ?wsComment WHERE {
+    ?belief a bdi:Belief ;
+            bdi:refersTo ?worldState .
+    OPTIONAL { ?worldState rdfs:comment ?wsComment }
+}
+```
+
+### CQ24: What actions brought about a world state?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?action ?worldState WHERE {
+    ?action bdi:bringsAbout ?worldState .
+    ?worldState a bdi:WorldState .
+}
+```
+
+### CQ25: What world states has an agent perceived?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?agent ?worldState ?time WHERE {
+    ?agent bdi:perceives ?worldState .
+    OPTIONAL { ?worldState bdi:atTime ?time }
+}
+```
+
+## Validation Queries (OWLUnit Style)
+
+### V1: Every intention must fulfill exactly one desire
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?intention WHERE {
+    ?intention a bdi:Intention .
+    FILTER NOT EXISTS { ?intention bdi:fulfils ?desire }
+}
+# Expected: Empty result set
+```
+
+### V2: Every belief must reference a world state
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief WHERE {
+    ?belief a bdi:Belief .
+    FILTER NOT EXISTS { ?belief bdi:refersTo ?worldState }
+}
+# Expected: Empty result set (or only abstract beliefs)
+```
+
+### V3: Mental processes must reason upon something
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?process WHERE {
+    ?process a bdi:MentalProcess .
+    FILTER NOT EXISTS { ?process bdi:reasonsUpon ?input }
+}
+# Expected: Empty result set
+```
+
+### V4: BeliefProcess must generate only Beliefs
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?process ?generated WHERE {
+    ?process a bdi:BeliefProcess ;
+             bdi:generates ?generated .
+    FILTER NOT EXISTS { ?generated a bdi:Belief }
+}
+# Expected: Empty result set
+```
+
+### V5: Plans must have begin and end tasks
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?plan WHERE {
+    ?plan a bdi:Plan .
+    FILTER NOT EXISTS { 
+        ?plan bdi:beginsWith ?first ;
+              bdi:endsWith ?last 
+    }
+}
+# Expected: Empty result set
+```
+
+## Multi-Agent Queries
+
+### CQ26: What beliefs are shared across agents?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?belief (COUNT(DISTINCT ?agent) AS ?agentCount) WHERE {
+    ?agent bdi:hasMentalState ?belief .
+    ?belief a bdi:Belief .
+}
+GROUP BY ?belief
+HAVING (COUNT(DISTINCT ?agent) > 1)
+```
+
+### CQ27: Which agents share the same desire?
+
+```sparql
+PREFIX bdi: <https://w3id.org/fossr/ontology/bdi/>
+
+SELECT ?desire ?agent1 ?agent2 WHERE {
+    ?agent1 bdi:hasDesire ?desire .
+    ?agent2 bdi:hasDesire ?desire .
+    FILTER(?agent1 != ?agent2)
+}
+```
+

package/.agents/skills/bolder/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: bolder
+description: Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability. Use when the user says the design looks bland, generic, too safe, lacks personality, or wants more visual impact and character.
+version: 2.1.1
+user-invocable: true
+argument-hint: "[target]"
+---
+
+Increase visual impact and personality in designs that are too safe, generic, or visually underwhelming, creating more engaging and memorable experiences.
+
+## MANDATORY PREPARATION
+
+Invoke /impeccable — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first.
+
+---
+
+## Assess Current State
+
+Analyze what makes the design feel too safe or boring:
+
+1. **Identify weakness sources**:
+   - **Generic choices**: System fonts, basic colors, standard layouts
+   - **Timid scale**: Everything is medium-sized with no drama
+   - **Low contrast**: Everything has similar visual weight
+   - **Static**: No motion, no energy, no life
+   - **Predictable**: Standard patterns with no surprises
+   - **Flat hierarchy**: Nothing stands out or commands attention
+
+2. **Understand the context**:
+   - What's the brand personality? (How far can we push?)
+   - What's the purpose? (Marketing can be bolder than financial dashboards)
+   - Who's the audience? (What will resonate?)
+   - What are the constraints? (Brand guidelines, accessibility, performance)
+
+If any of these are unclear from the codebase, ask the user directly to clarify what you cannot infer.
+
+**CRITICAL**: "Bolder" doesn't mean chaotic or garish. It means distinctive, memorable, and confident. Think intentional drama, not random chaos.
+
+**WARNING - AI SLOP TRAP**: When making things "bolder," AI defaults to the same tired tricks: cyan/purple gradients, glassmorphism, neon accents on dark backgrounds, gradient text on metrics. These are the OPPOSITE of bold—they're generic. Review ALL the DON'T guidelines in the impeccable skill before proceeding. Bold means distinctive, not "more effects."
+
+## Plan Amplification
+
+Create a strategy to increase impact while maintaining coherence:
+
+- **Focal point**: What should be the hero moment? (Pick ONE, make it amazing)
+- **Personality direction**: Maximalist chaos? Elegant drama? Playful energy? Dark moody? Choose a lane.
+- **Risk budget**: How experimental can we be? Push boundaries within constraints.
+- **Hierarchy amplification**: Make big things BIGGER, small things smaller (increase contrast)
+
+**IMPORTANT**: Bold design must still be usable. Impact without function is just decoration.
+
+## Amplify the Design
+
+Systematically increase impact across these dimensions:
+
+### Typography Amplification
+- **Replace generic fonts**: Swap system fonts for distinctive choices (see impeccable skill for inspiration)
+- **Extreme scale**: Create dramatic size jumps (3x-5x differences, not 1.5x)
+- **Weight contrast**: Pair 900 weights with 200 weights, not 600 with 400
+- **Unexpected choices**: Variable fonts, display fonts for headlines, condensed/extended widths, monospace as intentional accent (not as lazy "dev tool" default)
+
+### Color Intensification
+- **Increase saturation**: Shift to more vibrant, energetic colors (but not neon)
+- **Bold palette**: Introduce unexpected color combinations—avoid the purple-blue gradient AI slop
+- **Dominant color strategy**: Let one bold color own 60% of the design
+- **Sharp accents**: High-contrast accent colors that pop
+- **Tinted neutrals**: Replace pure grays with tinted grays that harmonize with your palette
+- **Rich gradients**: Intentional multi-stop gradients (not generic purple-to-blue)
+
+### Spatial Drama
+- **Extreme scale jumps**: Make important elements 3-5x larger than surroundings
+- **Break the grid**: Let hero elements escape containers and cross boundaries
+- **Asymmetric layouts**: Replace centered, balanced layouts with tension-filled asymmetry
+- **Generous space**: Use white space dramatically (100-200px gaps, not 20-40px)
+- **Overlap**: Layer elements intentionally for depth
+
+### Visual Effects
+- **Dramatic shadows**: Large, soft shadows for elevation (but not generic drop shadows on rounded rectangles)
+- **Background treatments**: Mesh patterns, noise textures, geometric patterns, intentional gradients (not purple-to-blue)
+- **Texture & depth**: Grain, halftone, duotone, layered elements—NOT glassmorphism (it's overused AI slop)
+- **Borders & frames**: Thick borders, decorative frames, custom shapes (not rounded rectangles with colored border on one side)
+- **Custom elements**: Illustrative elements, custom icons, decorative details that reinforce brand
+
+### Motion & Animation
+- **Entrance choreography**: Staggered, dramatic page load animations with 50-100ms delays
+- **Scroll effects**: Parallax, reveal animations, scroll-triggered sequences
+- **Micro-interactions**: Satisfying hover effects, click feedback, state changes
+- **Transitions**: Smooth, noticeable transitions using ease-out-quart/quint/expo (not bounce or elastic—they cheapen the effect)
+
+### Composition Boldness
+- **Hero moments**: Create clear focal points with dramatic treatment
+- **Diagonal flows**: Escape horizontal/vertical rigidity with diagonal arrangements
+- **Full-bleed elements**: Use full viewport width/height for impact
+- **Unexpected proportions**: Golden ratio? Throw it out. Try 70/30, 80/20 splits
+
+**NEVER**:
+- Add effects randomly without purpose (chaos ≠ bold)
+- Sacrifice readability for aesthetics (body text must be readable)
+- Make everything bold (then nothing is bold - need contrast)
+- Ignore accessibility (bold design must still meet WCAG standards)
+- Overwhelm with motion (animation fatigue is real)
+- Copy trendy aesthetics blindly (bold means distinctive, not derivative)
+
+## Verify Quality
+
+Ensure amplification maintains usability and coherence:
+
+- **NOT AI slop**: Does this look like every other AI-generated "bold" design? If yes, start over.
+- **Still functional**: Can users accomplish tasks without distraction?
+- **Coherent**: Does everything feel intentional and unified?
+- **Memorable**: Will users remember this experience?
+- **Performant**: Do all these effects run smoothly?
+- **Accessible**: Does it still meet accessibility standards?
+
+**The test**: If you showed this to someone and said "AI made this bolder," would they believe you immediately? If yes, you've failed. Bold means distinctive, not "more AI effects."
+
+Remember: Bold design is confident design. It takes risks, makes statements, and creates memorable experiences. But bold without strategy is just loud. Be intentional, be dramatic, be unforgettable.