From ab65271a5858d2001f8649e6fd9a6ee556bffe74 Mon Sep 17 00:00:00 2001 From: GeronimoGc Date: Fri, 20 Nov 2026 07:22:45 -0500 Subject: [PATCH] feat: complete a2host architecture, backend, zero-build frontend, and IEEE docs --- .agents/mcp_config.json | 9 + .agents/skills/3d-web-experience/SKILL.md | 259 ++ .../cpic-ui-design-and-templates/SKILL.md | 785 ++++++ .../examples/SampleFullPageTemplate.jsx | 227 ++ .../references/color-palette-tokens.md | 138 + .../references/page-templates.md | 257 ++ .../references/responsive-screen-layouts.md | 150 ++ .../skills/diagrams-and-data-tables/SKILL.md | 163 ++ .agents/skills/github-flow/SKILL.md | 231 ++ .../references/pull-request-template.md | 29 + .../skills/modern-ui-design-system/SKILL.md | 60 + .../skills/premium-motion-animations/SKILL.md | 75 + .agents/skills/premium-visual-polish/SKILL.md | 60 + .agents/skills/react-best-practices/AGENTS.md | 2249 +++++++++++++++++ .agents/skills/react-best-practices/README.md | 123 + .agents/skills/react-best-practices/SKILL.md | 127 + .../skills/react-best-practices/metadata.json | 15 + .../react-best-practices/rules/_sections.md | 46 + .../react-best-practices/rules/_template.md | 28 + .../rules/advanced-event-handler-refs.md | 55 + .../rules/advanced-use-latest.md | 49 + .../rules/async-api-routes.md | 38 + .../rules/async-defer-await.md | 80 + .../rules/async-dependencies.md | 36 + .../rules/async-parallel.md | 28 + .../rules/async-suspense-boundaries.md | 99 + .../rules/bundle-barrel-imports.md | 59 + .../rules/bundle-conditional.md | 31 + .../rules/bundle-defer-third-party.md | 49 + .../rules/bundle-dynamic-imports.md | 35 + .../rules/bundle-preload.md | 50 + .../rules/client-event-listeners.md | 74 + .../rules/client-swr-dedup.md | 56 + .../rules/js-batch-dom-css.md | 82 + .../rules/js-cache-function-results.md | 80 + .../rules/js-cache-property-access.md | 28 + .../rules/js-cache-storage.md | 70 + .../rules/js-combine-iterations.md | 32 + .../rules/js-early-exit.md | 50 + .../rules/js-hoist-regexp.md | 45 + .../rules/js-index-maps.md | 37 + .../rules/js-length-check-first.md | 49 + .../rules/js-min-max-loop.md | 82 + .../rules/js-set-map-lookups.md | 24 + .../rules/js-tosorted-immutable.md | 57 + .../rules/rendering-activity.md | 26 + .../rules/rendering-animate-svg-wrapper.md | 47 + .../rules/rendering-conditional-render.md | 40 + .../rules/rendering-content-visibility.md | 38 + .../rules/rendering-hoist-jsx.md | 46 + .../rules/rendering-hydration-no-flicker.md | 82 + .../rules/rendering-svg-precision.md | 28 + .../rules/rerender-defer-reads.md | 39 + .../rules/rerender-dependencies.md | 45 + .../rules/rerender-derived-state.md | 29 + .../rules/rerender-functional-setstate.md | 74 + .../rules/rerender-lazy-state-init.md | 58 + .../rules/rerender-memo.md | 44 + .../rules/rerender-transitions.md | 40 + .../rules/server-after-nonblocking.md | 73 + .../rules/server-cache-lru.md | 41 + .../rules/server-cache-react.md | 26 + .../rules/server-parallel-fetching.md | 79 + .../rules/server-serialization.md | 38 + .agents/skills/react-flow-architect/SKILL.md | 619 +++++ .agents/skills/react-modernization/SKILL.md | 37 + .../resources/implementation-playbook.md | 512 ++++ .agents/skills/react-patterns/SKILL.md | 203 ++ .../skills/react-state-management/SKILL.md | 444 ++++ .agents/skills/react-ui-patterns/SKILL.md | 295 +++ .../skills/responsive-mobile-first/SKILL.md | 63 + .../scrum-multi-agent-orchestration/SKILL.md | 219 ++ .../examples/framework_implementations.py | 362 +++ .../examples/orchestration_patterns.py | 411 +++ .../examples/scrum_feature_sprint.py | 93 + .../agent_communication.cpython-314.pyc | Bin 0 -> 19932 bytes .../scrum_orchestrator.cpython-314.pyc | Bin 0 -> 12161 bytes .../workflow_management.cpython-314.pyc | Bin 0 -> 18539 bytes .../scripts/agent_communication.py | 334 +++ .../scripts/benchmarking.py | 341 +++ .../scripts/scrum_orchestrator.py | 224 ++ .../scripts/workflow_management.py | 334 +++ .agents/skills/security-audit/AI-AND-LLM.md | 83 + .../skills/security-audit/ATTACK-CLASSES.md | 130 + .agents/skills/security-audit/CLIENT-SIDE.md | 83 + .../security-audit/CLOUD-AND-DEPLOYMENT.md | 86 + .../DATA-ISOLATION-AND-LIFECYCLE.md | 84 + .../DESKTOP-MOBILE-AND-LOCAL-IPC.md | 89 + .agents/skills/security-audit/HUNTING.md | 251 ++ .../MEMORY-SAFETY-AND-BINARY.md | 101 + .../PROTOCOLS-RPC-AND-MESSAGING.md | 81 + .../skills/security-audit/RECONNAISSANCE.md | 156 ++ .../RESOURCE-EXHAUSTION-AND-AVAILABILITY.md | 78 + .agents/skills/security-audit/SKILL.md | 192 ++ .../SUPPLY-CHAIN-AND-RELEASE.md | 73 + .../VALIDATION-AND-REPORTING.md | 186 ++ .../security-audit/WEB-PROTOCOL-AND-AUTH.md | 105 + .../skills/security-audit/report-schema.json | 461 ++++ .../validate-coverage-ledger.cjs | 872 +++++++ .../validate-coverage-ledger.test.cjs | 740 ++++++ .../security-audit/validate-findings.cjs | 773 ++++++ .../security-audit/validate-findings.test.cjs | 652 +++++ .agents/skills/security-auditor/SKILL.md | 165 ++ .agents/skills/solidity-security/SKILL.md | 37 + .../resources/implementation-playbook.md | 524 ++++ .../system-architecture-analysis/SKILL.md | 100 + .../skills/tanstack-table-and-charts/SKILL.md | 241 ++ .../skills/wcag-accessibility-a11y/SKILL.md | 67 + .agents/skills/web-security-testing/SKILL.md | 183 ++ .env.example | 26 + .gitignore | 5 + AGENTS.md | 182 ++ a2host.md | 45 + docs/01-requirements/srs-ieee-29148.md | 345 +++ docs/02-architecture/sdd-ieee-1016.md | 349 +++ docs/03-api/api-specification.md | 502 ++++ docs/04-security/security-model.md | 274 ++ docs/05-deployment/vps-deployment-guide.md | 284 +++ docs/06-user-guides/admin-manual.md | 211 ++ docs/README.md | 76 + ecosystem.config.js | 15 + package-lock.json | 843 ++++++ package.json | 19 + public/css/components.css | 1313 ++++++++++ public/css/main.css | 541 ++++ public/index.html | 610 +++++ public/js/api.js | 203 ++ public/js/app.js | 1435 +++++++++++ public/js/markdown.js | 153 ++ public/js/state.js | 125 + public/js/toast.js | 128 + public/js/validators.js | 146 ++ public/login.html | 200 ++ src/app.js | 45 + src/config/env.js | 39 + src/controllers/auth.controller.js | 111 + src/controllers/docs.controller.js | 30 + src/controllers/folder.controller.js | 28 + src/controllers/subdomain.controller.js | 85 + src/controllers/system.controller.js | 19 + src/controllers/user.controller.js | 57 + src/index.js | 49 + .../apache/apache.driver.interface.js | 129 + src/infrastructure/apache/driver.factory.js | 55 + .../apache/mock.apache.driver.js | 402 +++ .../apache/real.apache.driver.js | 300 +++ src/infrastructure/storage/user.store.js | 273 ++ src/middlewares/auth.middleware.js | 96 + src/middlewares/error.middleware.js | 39 + src/middlewares/rate-limit.middleware.js | 61 + src/routes/auth.routes.js | 22 + src/routes/docs.routes.js | 17 + src/routes/folder.routes.js | 16 + src/routes/index.js | 22 + src/routes/subdomain.routes.js | 23 + src/routes/system.routes.js | 15 + src/routes/user.routes.js | 20 + src/services/docs.service.js | 109 + src/services/folder.service.js | 149 ++ src/services/site.service.js | 439 ++++ src/services/system.service.js | 108 + src/services/template.service.js | 196 ++ src/services/user.service.js | 183 ++ src/utils/crypto.util.js | 228 ++ src/utils/response.util.js | 58 + src/utils/validation.util.js | 179 ++ test/integration/api.test.js | 446 ++++ test/integration/rollback.test.js | 166 ++ test/unit/crypto.test.js | 140 + test/unit/templates.test.js | 73 + test/unit/user-store.test.js | 130 + test/unit/validation.test.js | 146 ++ 172 files changed, 31116 insertions(+) create mode 100644 .agents/mcp_config.json create mode 100644 .agents/skills/3d-web-experience/SKILL.md create mode 100644 .agents/skills/cpic-ui-design-and-templates/SKILL.md create mode 100644 .agents/skills/cpic-ui-design-and-templates/examples/SampleFullPageTemplate.jsx create mode 100644 .agents/skills/cpic-ui-design-and-templates/references/color-palette-tokens.md create mode 100644 .agents/skills/cpic-ui-design-and-templates/references/page-templates.md create mode 100644 .agents/skills/cpic-ui-design-and-templates/references/responsive-screen-layouts.md create mode 100644 .agents/skills/diagrams-and-data-tables/SKILL.md create mode 100644 .agents/skills/github-flow/SKILL.md create mode 100644 .agents/skills/github-flow/references/pull-request-template.md create mode 100644 .agents/skills/modern-ui-design-system/SKILL.md create mode 100644 .agents/skills/premium-motion-animations/SKILL.md create mode 100644 .agents/skills/premium-visual-polish/SKILL.md create mode 100644 .agents/skills/react-best-practices/AGENTS.md create mode 100644 .agents/skills/react-best-practices/README.md create mode 100644 .agents/skills/react-best-practices/SKILL.md create mode 100644 .agents/skills/react-best-practices/metadata.json create mode 100644 .agents/skills/react-best-practices/rules/_sections.md create mode 100644 .agents/skills/react-best-practices/rules/_template.md create mode 100644 .agents/skills/react-best-practices/rules/advanced-event-handler-refs.md create mode 100644 .agents/skills/react-best-practices/rules/advanced-use-latest.md create mode 100644 .agents/skills/react-best-practices/rules/async-api-routes.md create mode 100644 .agents/skills/react-best-practices/rules/async-defer-await.md create mode 100644 .agents/skills/react-best-practices/rules/async-dependencies.md create mode 100644 .agents/skills/react-best-practices/rules/async-parallel.md create mode 100644 .agents/skills/react-best-practices/rules/async-suspense-boundaries.md create mode 100644 .agents/skills/react-best-practices/rules/bundle-barrel-imports.md create mode 100644 .agents/skills/react-best-practices/rules/bundle-conditional.md create mode 100644 .agents/skills/react-best-practices/rules/bundle-defer-third-party.md create mode 100644 .agents/skills/react-best-practices/rules/bundle-dynamic-imports.md create mode 100644 .agents/skills/react-best-practices/rules/bundle-preload.md create mode 100644 .agents/skills/react-best-practices/rules/client-event-listeners.md create mode 100644 .agents/skills/react-best-practices/rules/client-swr-dedup.md create mode 100644 .agents/skills/react-best-practices/rules/js-batch-dom-css.md create mode 100644 .agents/skills/react-best-practices/rules/js-cache-function-results.md create mode 100644 .agents/skills/react-best-practices/rules/js-cache-property-access.md create mode 100644 .agents/skills/react-best-practices/rules/js-cache-storage.md create mode 100644 .agents/skills/react-best-practices/rules/js-combine-iterations.md create mode 100644 .agents/skills/react-best-practices/rules/js-early-exit.md create mode 100644 .agents/skills/react-best-practices/rules/js-hoist-regexp.md create mode 100644 .agents/skills/react-best-practices/rules/js-index-maps.md create mode 100644 .agents/skills/react-best-practices/rules/js-length-check-first.md create mode 100644 .agents/skills/react-best-practices/rules/js-min-max-loop.md create mode 100644 .agents/skills/react-best-practices/rules/js-set-map-lookups.md create mode 100644 .agents/skills/react-best-practices/rules/js-tosorted-immutable.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-activity.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-conditional-render.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-content-visibility.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-hoist-jsx.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-hydration-no-flicker.md create mode 100644 .agents/skills/react-best-practices/rules/rendering-svg-precision.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-defer-reads.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-dependencies.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-derived-state.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-functional-setstate.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-lazy-state-init.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-memo.md create mode 100644 .agents/skills/react-best-practices/rules/rerender-transitions.md create mode 100644 .agents/skills/react-best-practices/rules/server-after-nonblocking.md create mode 100644 .agents/skills/react-best-practices/rules/server-cache-lru.md create mode 100644 .agents/skills/react-best-practices/rules/server-cache-react.md create mode 100644 .agents/skills/react-best-practices/rules/server-parallel-fetching.md create mode 100644 .agents/skills/react-best-practices/rules/server-serialization.md create mode 100644 .agents/skills/react-flow-architect/SKILL.md create mode 100644 .agents/skills/react-modernization/SKILL.md create mode 100644 .agents/skills/react-modernization/resources/implementation-playbook.md create mode 100644 .agents/skills/react-patterns/SKILL.md create mode 100644 .agents/skills/react-state-management/SKILL.md create mode 100644 .agents/skills/react-ui-patterns/SKILL.md create mode 100644 .agents/skills/responsive-mobile-first/SKILL.md create mode 100644 .agents/skills/scrum-multi-agent-orchestration/SKILL.md create mode 100644 .agents/skills/scrum-multi-agent-orchestration/examples/framework_implementations.py create mode 100644 .agents/skills/scrum-multi-agent-orchestration/examples/orchestration_patterns.py create mode 100644 .agents/skills/scrum-multi-agent-orchestration/examples/scrum_feature_sprint.py create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/__pycache__/agent_communication.cpython-314.pyc create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/__pycache__/scrum_orchestrator.cpython-314.pyc create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/__pycache__/workflow_management.cpython-314.pyc create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/agent_communication.py create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/benchmarking.py create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/scrum_orchestrator.py create mode 100644 .agents/skills/scrum-multi-agent-orchestration/scripts/workflow_management.py create mode 100644 .agents/skills/security-audit/AI-AND-LLM.md create mode 100644 .agents/skills/security-audit/ATTACK-CLASSES.md create mode 100644 .agents/skills/security-audit/CLIENT-SIDE.md create mode 100644 .agents/skills/security-audit/CLOUD-AND-DEPLOYMENT.md create mode 100644 .agents/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md create mode 100644 .agents/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md create mode 100644 .agents/skills/security-audit/HUNTING.md create mode 100644 .agents/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md create mode 100644 .agents/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md create mode 100644 .agents/skills/security-audit/RECONNAISSANCE.md create mode 100644 .agents/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md create mode 100644 .agents/skills/security-audit/SKILL.md create mode 100644 .agents/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md create mode 100644 .agents/skills/security-audit/VALIDATION-AND-REPORTING.md create mode 100644 .agents/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md create mode 100644 .agents/skills/security-audit/report-schema.json create mode 100755 .agents/skills/security-audit/validate-coverage-ledger.cjs create mode 100644 .agents/skills/security-audit/validate-coverage-ledger.test.cjs create mode 100755 .agents/skills/security-audit/validate-findings.cjs create mode 100644 .agents/skills/security-audit/validate-findings.test.cjs create mode 100644 .agents/skills/security-auditor/SKILL.md create mode 100644 .agents/skills/solidity-security/SKILL.md create mode 100644 .agents/skills/solidity-security/resources/implementation-playbook.md create mode 100644 .agents/skills/system-architecture-analysis/SKILL.md create mode 100644 .agents/skills/tanstack-table-and-charts/SKILL.md create mode 100644 .agents/skills/wcag-accessibility-a11y/SKILL.md create mode 100644 .agents/skills/web-security-testing/SKILL.md create mode 100644 .env.example create mode 100644 .gitignore create mode 100644 AGENTS.md create mode 100644 a2host.md create mode 100644 docs/01-requirements/srs-ieee-29148.md create mode 100644 docs/02-architecture/sdd-ieee-1016.md create mode 100644 docs/03-api/api-specification.md create mode 100644 docs/04-security/security-model.md create mode 100644 docs/05-deployment/vps-deployment-guide.md create mode 100644 docs/06-user-guides/admin-manual.md create mode 100644 docs/README.md create mode 100644 ecosystem.config.js create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 public/css/components.css create mode 100644 public/css/main.css create mode 100644 public/index.html create mode 100644 public/js/api.js create mode 100644 public/js/app.js create mode 100644 public/js/markdown.js create mode 100644 public/js/state.js create mode 100644 public/js/toast.js create mode 100644 public/js/validators.js create mode 100644 public/login.html create mode 100644 src/app.js create mode 100644 src/config/env.js create mode 100644 src/controllers/auth.controller.js create mode 100644 src/controllers/docs.controller.js create mode 100644 src/controllers/folder.controller.js create mode 100644 src/controllers/subdomain.controller.js create mode 100644 src/controllers/system.controller.js create mode 100644 src/controllers/user.controller.js create mode 100644 src/index.js create mode 100644 src/infrastructure/apache/apache.driver.interface.js create mode 100644 src/infrastructure/apache/driver.factory.js create mode 100644 src/infrastructure/apache/mock.apache.driver.js create mode 100644 src/infrastructure/apache/real.apache.driver.js create mode 100644 src/infrastructure/storage/user.store.js create mode 100644 src/middlewares/auth.middleware.js create mode 100644 src/middlewares/error.middleware.js create mode 100644 src/middlewares/rate-limit.middleware.js create mode 100644 src/routes/auth.routes.js create mode 100644 src/routes/docs.routes.js create mode 100644 src/routes/folder.routes.js create mode 100644 src/routes/index.js create mode 100644 src/routes/subdomain.routes.js create mode 100644 src/routes/system.routes.js create mode 100644 src/routes/user.routes.js create mode 100644 src/services/docs.service.js create mode 100644 src/services/folder.service.js create mode 100644 src/services/site.service.js create mode 100644 src/services/system.service.js create mode 100644 src/services/template.service.js create mode 100644 src/services/user.service.js create mode 100644 src/utils/crypto.util.js create mode 100644 src/utils/response.util.js create mode 100644 src/utils/validation.util.js create mode 100644 test/integration/api.test.js create mode 100644 test/integration/rollback.test.js create mode 100644 test/unit/crypto.test.js create mode 100644 test/unit/templates.test.js create mode 100644 test/unit/user-store.test.js create mode 100644 test/unit/validation.test.js diff --git a/.agents/mcp_config.json b/.agents/mcp_config.json new file mode 100644 index 0000000..236c095 --- /dev/null +++ b/.agents/mcp_config.json @@ -0,0 +1,9 @@ +{ + "mcpServers": { + "spline": { + "command": "npx", + "args": ["-y", "spline-mcp-server"] + } + } +} + diff --git a/.agents/skills/3d-web-experience/SKILL.md b/.agents/skills/3d-web-experience/SKILL.md new file mode 100644 index 0000000..f1ca075 --- /dev/null +++ b/.agents/skills/3d-web-experience/SKILL.md @@ -0,0 +1,259 @@ +--- +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 ..." +risk: unknown +source: "vibeship-spawner-skills (Apache 2.0)" +date_added: "2026-02-27" +--- + +# 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 ( + + ); +} +``` + +### 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 ; +} + +export default function Scene() { + return ( + + + + + + ); +} +``` +``` + +### 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 {progress.toFixed(0)}%; +} + +export default function Scene() { + return ( + + }> + + + + ); +} +``` +``` + +### 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 ...; +} + +export default function Scene() { + return ( + + + + + + ); +} +``` + +### 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` + +## When to Use +This skill is applicable to execute the workflow or actions described in the overview. diff --git a/.agents/skills/cpic-ui-design-and-templates/SKILL.md b/.agents/skills/cpic-ui-design-and-templates/SKILL.md new file mode 100644 index 0000000..85c9041 --- /dev/null +++ b/.agents/skills/cpic-ui-design-and-templates/SKILL.md @@ -0,0 +1,785 @@ +--- +name: cpic-ui-design-and-templates +description: >- + Definitive design system, color palette, responsive screen architecture (mobile to ultrawide), + glassmorphism tokens, and page templates for CPIC - Conecta (SENA Intranet). Use when creating, + refactoring, styling, or structuring pages, layouts, sidebars, modals, chat interfaces, + tables, or dashboards. +--- + +# CPIC - Conecta: Master UI Design System & Page Templates + +Guía canónica y definitiva del sistema de diseño visual, paleta cromática, arquitectura responsiva multi-pantalla y plantillas estructurales para el proyecto **Chatbot Intranet CPIC ("Conecta")** del **SENA (Centro de Procesos Industriales y Construcción)**. + +--- + +## 1. Identidad Visual y Principios de Diseño + +El sistema visual de CPIC combina **elegancia institucional del SENA** con una estética **Luxury Glassmorphism** moderna (estilo Linear / Apple / Vercel), optimizada para modo oscuro por defecto con soporte completo para modo claro y accesibilidad WCAG 2.1 AA/AAA. + +### Pilares Fundamentales: +1. **Verde Institucional SENA & Acentos Lime**: Verde esmeralda institucional (`#39A900`) y lima eléctrica (`#00FF00` / `#a3e635`) sobre fondos oscuros o alabastro. +2. **Elevación Glassmorphism en 3 Capas (3-Tier Glass Elevation)**: Jerarquía de profundidad mediante `backdrop-blur`, transparencias finas, bordes sutiles de 1px e iluminaciones interiores (`inset 0 1px 0`). +3. **Arquitectura Responsiva Mobile-First Real**: Estabilidad con `100dvh`, navegación off-canvas en pantallas táctiles, chips deslizables, tablas con scroll horizontal y modales convertibles a hojas inferiores (*bottom-sheets*). +4. **Micro-interacciones Táctiles y Fluidas**: Escalamiento sutil (`hover:scale-[1.01]`, `active:scale-[0.98]`), anillos de foco de alto contraste y barras de desplazamiento personalizadas de 5px. +5. **Inclusión y Accesibilidad Universal**: Cumplimiento WCAG, fuente OpenDyslexic, modo alto contraste, filtros para daltonismo y docks dedicados a Lengua de Señas Colombiana (LSC). + +--- + +## 2. Paleta de Colores y Tokens de Diseño + +### 2.1. Acentos Institucionales SENA & Lime + +| Token / Variable | Hex / Valor | Uso Principal | Modo Oscuro | Modo Claro | +| :--- | :--- | :--- | :--- | :--- | +| **SENA Verde Oficial** | `#39A900` | Marca institucional, títulos clave, viñetas activas | `#39A900` / `#50e93b` | `#39A900` / `#166534` | +| `--color-lime` | `#00FF00` | Acento primario, foco de alto impacto, luces de neón | `#00FF00` | `#16a34a` / `#15803d` | +| `--color-lime-dark` | `#00CC00` | Estados hover, bordes de acento | `#00CC00` | `#15803d` | +| `--color-lime-deep` | `#009900` | Texto de alto contraste en fondos claros | `#52ff52` | `#009900` | +| `--color-lime-light` | `#66FF66` | Anillos de loaders, bordes secundarios | `#66FF66` | `#22c55e` | +| `--color-lime-soft` | `#B3FFB3` | Fondos de selección suaves | `rgba(179,255,179,0.15)` | `rgba(179,255,179,0.3)` | +| `--color-lime-pale` | `#E6FFE6` | Resaltados de advertencias y tablas | `rgba(230,255,230,0.08)`| `#e6ffe6` | +| **Tailwind Lime 400** | `#a3e635` | Textos de acento en dark mode (`text-lime`) | `#a3e635` | `#15803d` | +| **Tailwind Lime 500** | `#84cc16` | Sombras resplandecientes, scrollbars activas | `#84cc16` | `#16a34a` | +| **Emerald 800** | `#166534` | Encabezados Markdown en modo claro | `#86efac` | `#166534` | +| **Emerald 700** | `#15803d` | Enlaces y botones de texto en modo claro | `#4ade80` | `#15803d` | + +### 2.2. Sistema de Elevación Glassmorphism (3-Tier Glass) + +``` +┌────────────────────────────────────────────────────────────────────────┐ +│ TIER 0: App Base Wallpaper (/background.webp + velo oscuro) │ +│ ┌──────────────────────────────────────────────────────────────────┐ │ +│ │ TIER 1: Ambient Glow Orbs (blur-[120px] de Lime y Emerald) │ │ +│ │ ┌────────────────────────────────────────────────────────────┐ │ │ +│ │ │ TIER 2: Contenedores Estructurales (Cards, Sidebars, Main) │ │ │ +│ │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ +│ │ │ │ TIER 3: Flotantes (Modales, Popovers, Toasts, Docks) │ │ │ │ +│ │ │ └──────────────────────────────────────────────────────┘ │ │ │ +│ │ └────────────────────────────────────────────────────────────┘ │ │ +│ └──────────────────────────────────────────────────────────────────┘ │ +└────────────────────────────────────────────────────────────────────────┘ +``` + +#### Tier 0 — Lienzo Base: +- **Fondo General**: `background-image: var(--app-bg-image, url('/background.webp'))` con `background-size: cover; background-position: center; background-attachment: fixed;`. +- **Velo de Profundidad**: `body::before { background: rgba(0, 0, 0, 0.2); }`. +- **Fondo Fallback Dark**: `#0a0a0a` / `#0a160a`. +- **Fondo Fallback Light**: `#f8fafc` (Slate 50) / `#f3f4f6`. + +#### Tier 1 — Ambient Glow Orbs: +Orbes desenfocados que crean atmósfera tridimensional detrás del contenido: +```jsx +