gkt 3.1.0__py3-none-any.whl

GravityKit/.agent/brain/agent_index.json

@@ -0,0 +1,208 @@
+{
+    "agents": {
+        "leader": {
+            "role": "Team Lead — Orchestrates the entire team with per-phase reporting",
+            "when_to_call": "Complex tasks that need multiple agents. User approves each phase before proceeding.",
+            "output": "Delegates tasks to specialized agents, reports per phase, manages QA loop (max 3 retries)",
+            "skills": [
+                "progress-tracker",
+                "codebase-navigator"
+            ],
+            "orchestration": {
+                "phases": [
+                    "Planning",
+                    "Architecture",
+                    "Design",
+                    "Development",
+                    "QA & Bug Fix",
+                    "Launch"
+                ],
+                "qa_loop": {
+                    "max_retries": 3,
+                    "on_failure": "Call meta-thinker + planner to rethink approach",
+                    "on_max_retries": "Stop and report to Manager with detailed failure analysis"
+                }
+            }
+        },
+        "quickstart": {
+            "role": "Autopilot — Fully automated project build from idea to production",
+            "when_to_call": "Quick MVPs, prototypes, or when user wants zero-approval fast build",
+            "output": "Complete project with QA, security audit, docs. Final report with all results.",
+            "skills": [],
+            "orchestration": {
+                "phases": [
+                    "Auto-Plan",
+                    "Architecture",
+                    "Design",
+                    "Development",
+                    "QA & Auto-Fix",
+                    "Polish"
+                ],
+                "qa_loop": {
+                    "max_retries": 5,
+                    "on_failure": "Call meta-thinker + planner to rethink approach",
+                    "on_max_retries": "Log unresolved bug, continue with remaining work"
+                }
+            }
+        },
+        "planner": {
+            "role": "Analyzes requirements, writes PRD, breaks down tasks",
+            "when_to_call": "New features, project kickoff, requirement analysis",
+            "output": "PRD.md, task breakdown, user stories, estimation",
+            "skills": [
+                "task-estimator",
+                "user-story-generator",
+                "project-management-assistant",
+                "project-scaffolder"
+            ]
+        },
+        "architect": {
+            "role": "Systems Design — Database, API, Architecture",
+            "when_to_call": "Database schema, API design, system diagrams, tech decisions",
+            "output": "schema.sql, api_spec.yaml, architecture diagrams",
+            "skills": [
+                "db-designer",
+                "api-designer",
+                "system-diagrammer",
+                "system-strategist",
+                "strategic-planning-advisor"
+            ]
+        },
+        "designer": {
+            "role": "UI/UX Design System and Assets",
+            "when_to_call": "UI components, color palette, typography, wireframes, responsive design",
+            "output": "Design system, component specs, color palette, wireframes",
+            "skills": [
+                "ui-ux-pro-max",
+                "color-palette-generator",
+                "product-designer"
+            ]
+        },
+        "frontend-dev": {
+            "role": "Frontend Developer — Component, Layout, State Management",
+            "when_to_call": "React/Vue/Tailwind components, pages, state logic, responsive layout",
+            "output": "Components, pages, hooks, styles, state management code",
+            "skills": []
+        },
+        "backend-dev": {
+            "role": "Backend Developer — API, DB Queries, Business Logic",
+            "when_to_call": "API endpoints, database queries, authentication, server logic",
+            "output": "API routes, controllers, models, middleware, services",
+            "skills": [
+                "test-generator"
+            ]
+        },
+        "mobile-dev": {
+            "role": "Mobile Developer — iOS/Android (React Native/Expo)",
+            "when_to_call": "Mobile screens, native features, navigation, app store deployment",
+            "output": "React Native/Expo screens, navigation config, native module setup",
+            "skills": [
+                "mobile-wizard"
+            ]
+        },
+        "devops": {
+            "role": "DevOps — Docker, CI/CD, Cloud Deployment",
+            "when_to_call": "Docker setup, CI/CD pipelines, deployment, cloud config",
+            "output": "Dockerfile, docker-compose.yml, GitHub Actions, deploy scripts",
+            "skills": [
+                "docker-wizard",
+                "ci-cd-setup",
+                "reliability-engineer"
+            ]
+        },
+        "qa-engineer": {
+            "role": "QA — Test Cases, Automation, Performance, Bug Reporting",
+            "when_to_call": "Test writing, test automation, performance testing, bug triage",
+            "output": "Test suites, test reports, bug reports",
+            "skills": [
+                "test-generator"
+            ]
+        },
+        "security-engineer": {
+            "role": "Security — Audit, Pen-Test, Vulnerability Scanning",
+            "when_to_call": "Security audit, vulnerability scan, OWASP check, secret detection",
+            "output": "Security report, vulnerability list, fix recommendations",
+            "skills": [
+                "security-scanner"
+            ]
+        },
+        "tech-writer": {
+            "role": "Documentation & API Refs",
+            "when_to_call": "README, API docs, user guides, changelog",
+            "output": "README.md, API documentation, user guides",
+            "skills": [
+                "doc-generator",
+                "readme-generator"
+            ]
+        },
+        "seo-specialist": {
+            "role": "SEO — Search Engine Optimization",
+            "when_to_call": "Meta tags, Schema.org, sitemap, performance, Core Web Vitals",
+            "output": "SEO audit report, meta tag fixes, schema markup",
+            "skills": [
+                "seo-analyzer"
+            ]
+        },
+        "meta-thinker": {
+            "role": "Creative Advisor — Ideas, Brainstorming, Vision",
+            "when_to_call": "Brainstorming, product vision, monetization, competitive analysis",
+            "output": "Idea reports, strategy docs, competitor analysis",
+            "skills": [
+                "meta-thinker",
+                "competitor-analyzer",
+                "market-trend-analyst"
+            ]
+        },
+        "knowledge-guide": {
+            "role": "Code Explainer, Note Taker, Handoff Specialist",
+            "when_to_call": "Explain codebase to new team members, capture notes, handoff docs",
+            "output": "Code explanations, handoff documents, context summaries",
+            "skills": [
+                "knowledge-guide",
+                "brain-manager",
+                "journal-manager"
+            ]
+        },
+        "code-reviewer": {
+            "role": "Code Reviewer — Automated code quality review",
+            "when_to_call": "Code quality check, naming review, security scan, performance audit",
+            "output": "Review report with issues (critical/warning/info) and quality score (A-F)",
+            "skills": [
+                "code-reviewer"
+            ]
+        },
+        "release-manager": {
+            "role": "Release Manager — Changelog, versioning, release notes",
+            "when_to_call": "Version bump, changelog generation, release preparation, tagging",
+            "output": "CHANGELOG.md, version bump, release notes, git tags",
+            "skills": [
+                "release-manager"
+            ]
+        },
+        "researcher": {
+            "role": "Researcher — Market analysis, web search, trend discovery",
+            "when_to_call": "Research competitors, validate ideas, discover trends, find best practices, gather information",
+            "output": "research_report.md, market-analysis.md, competitor data, web search results",
+            "skills": [
+                "market-trend-analyst",
+                "competitor-analyzer"
+            ],
+            "capabilities": {
+                "web_search": "DuckDuckGo API (zero dependencies, stdlib only)",
+                "modes": [
+                    "--compact (token-efficient)",
+                    "--json",
+                    "--output (markdown)",
+                    "--instant-only"
+                ]
+            }
+        }
+    },
+    "infrastructure": {
+        "context-router": "Universal data query router — use before reading raw data files. Saves tokens by returning only matching entries.",
+        "template-marketplace": "Pre-built project templates (SaaS, E-commerce, Blog, API, Landing, Dashboard, Mobile). Used by quickstart and leader."
+    },
+    "handoff_template": {
+        "format": "## Handoff to {agent}\nContext: {one_line_summary}\nTask: {specific_task}\nFiles: {relevant_files_from_codebase_index}\nConstraints: {tech_stack_and_rules}\nExpected Output: {what_to_produce}"
+    }
+}

GravityKit/.agent/brain/project_context.json

@@ -0,0 +1,31 @@
+{
+    "project": {
+        "name": "",
+        "description": "",
+        "tech_stack": [],
+        "repo_url": "",
+        "created_at": ""
+    },
+    "architecture": {
+        "pattern": "",
+        "database": "",
+        "api_style": "",
+        "auth_method": "",
+        "hosting": "",
+        "notes": []
+    },
+    "decisions": [],
+    "conventions": {
+        "naming": "",
+        "file_structure": "",
+        "git_branch_strategy": "",
+        "commit_format": "",
+        "code_style": ""
+    },
+    "known_issues": [],
+    "current_sprint": {
+        "goal": "",
+        "status": "",
+        "tasks": []
+    }
+}

GravityKit/.agent/skills/3d-web-experience/SKILL.md

@@ -0,0 +1,254 @@
+---
+name: 3d-web-experience
+description: "Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences. Use when: 3D website, three.js, WebGL, react three fiber, 3D experience."
+source: vibeship-spawner-skills (Apache 2.0)
+---
+
+# 3D Web Experience
+
+**Role**: 3D Web Experience Architect
+
+You bring the third dimension to the web. You know when 3D enhances
+and when it's just showing off. You balance visual impact with
+performance. You make 3D accessible to users who've never touched
+a 3D app. You create moments of wonder without sacrificing usability.
+
+## Capabilities
+
+- Three.js implementation
+- React Three Fiber
+- WebGL optimization
+- 3D model integration
+- Spline workflows
+- 3D product configurators
+- Interactive 3D scenes
+- 3D performance optimization
+
+## Patterns
+
+### 3D Stack Selection
+
+Choosing the right 3D approach
+
+**When to use**: When starting a 3D web project
+
+```python
+## 3D Stack Selection
+
+### Options Comparison
+| Tool | Best For | Learning Curve | Control |
+|------|----------|----------------|---------|
+| Spline | Quick prototypes, designers | Low | Medium |
+| React Three Fiber | React apps, complex scenes | Medium | High |
+| Three.js vanilla | Max control, non-React | High | Maximum |
+| Babylon.js | Games, heavy 3D | High | Maximum |
+
+### Decision Tree
+```
+Need quick 3D element?
+└── Yes → Spline
+└── No → Continue
+
+Using React?
+└── Yes → React Three Fiber
+└── No → Continue
+
+Need max performance/control?
+└── Yes → Three.js vanilla
+└── No → Spline or R3F
+```
+
+### Spline (Fastest Start)
+```jsx
+import Spline from '@splinetool/react-spline';
+
+export default function Scene() {
+  return (
+    <Spline scene="https://prod.spline.design/xxx/scene.splinecode" />
+  );
+}
+```
+
+### React Three Fiber
+```jsx
+import { Canvas } from '@react-three/fiber';
+import { OrbitControls, useGLTF } from '@react-three/drei';
+
+function Model() {
+  const { scene } = useGLTF('/model.glb');
+  return <primitive object={scene} />;
+}
+
+export default function Scene() {
+  return (
+    <Canvas>
+      <ambientLight />
+      <Model />
+      <OrbitControls />
+    </Canvas>
+  );
+}
+```
+```
+
+### 3D Model Pipeline
+
+Getting models web-ready
+
+**When to use**: When preparing 3D assets
+
+```python
+## 3D Model Pipeline
+
+### Format Selection
+| Format | Use Case | Size |
+|--------|----------|------|
+| GLB/GLTF | Standard web 3D | Smallest |
+| FBX | From 3D software | Large |
+| OBJ | Simple meshes | Medium |
+| USDZ | Apple AR | Medium |
+
+### Optimization Pipeline
+```
+1. Model in Blender/etc
+2. Reduce poly count (< 100K for web)
+3. Bake textures (combine materials)
+4. Export as GLB
+5. Compress with gltf-transform
+6. Test file size (< 5MB ideal)
+```
+
+### GLTF Compression
+```bash
+# Install gltf-transform
+npm install -g @gltf-transform/cli
+
+# Compress model
+gltf-transform optimize input.glb output.glb \
+  --compress draco \
+  --texture-compress webp
+```
+
+### Loading in R3F
+```jsx
+import { useGLTF, useProgress, Html } from '@react-three/drei';
+import { Suspense } from 'react';
+
+function Loader() {
+  const { progress } = useProgress();
+  return <Html center>{progress.toFixed(0)}%</Html>;
+}
+
+export default function Scene() {
+  return (
+    <Canvas>
+      <Suspense fallback={<Loader />}>
+        <Model />
+      </Suspense>
+    </Canvas>
+  );
+}
+```
+```
+
+### Scroll-Driven 3D
+
+3D that responds to scroll
+
+**When to use**: When integrating 3D with scroll
+
+```python
+## Scroll-Driven 3D
+
+### R3F + Scroll Controls
+```jsx
+import { ScrollControls, useScroll } from '@react-three/drei';
+import { useFrame } from '@react-three/fiber';
+
+function RotatingModel() {
+  const scroll = useScroll();
+  const ref = useRef();
+
+  useFrame(() => {
+    // Rotate based on scroll position
+    ref.current.rotation.y = scroll.offset * Math.PI * 2;
+  });
+
+  return <mesh ref={ref}>...</mesh>;
+}
+
+export default function Scene() {
+  return (
+    <Canvas>
+      <ScrollControls pages={3}>
+        <RotatingModel />
+      </ScrollControls>
+    </Canvas>
+  );
+}
+```
+
+### GSAP + Three.js
+```javascript
+import gsap from 'gsap';
+import ScrollTrigger from 'gsap/ScrollTrigger';
+
+gsap.to(camera.position, {
+  scrollTrigger: {
+    trigger: '.section',
+    scrub: true,
+  },
+  z: 5,
+  y: 2,
+});
+```
+
+### Common Scroll Effects
+- Camera movement through scene
+- Model rotation on scroll
+- Reveal/hide elements
+- Color/material changes
+- Exploded view animations
+```
+
+## Anti-Patterns
+
+### ❌ 3D For 3D's Sake
+
+**Why bad**: Slows down the site.
+Confuses users.
+Battery drain on mobile.
+Doesn't help conversion.
+
+**Instead**: 3D should serve a purpose.
+Product visualization = good.
+Random floating shapes = probably not.
+Ask: would an image work?
+
+### ❌ Desktop-Only 3D
+
+**Why bad**: Most traffic is mobile.
+Kills battery.
+Crashes on low-end devices.
+Frustrated users.
+
+**Instead**: Test on real mobile devices.
+Reduce quality on mobile.
+Provide static fallback.
+Consider disabling 3D on low-end.
+
+### ❌ No Loading State
+
+**Why bad**: Users think it's broken.
+High bounce rate.
+3D takes time to load.
+Bad first impression.
+
+**Instead**: Loading progress indicator.
+Skeleton/placeholder.
+Load 3D after page is interactive.
+Optimize model size.
+
+## Related Skills
+
+Works well with: `scroll-experience`, `interactive-portfolio`, `frontend`, `landing-page-design`