npm - @cubis/foundry - Versions diffs - 0.3.62 → 0.3.64 - Mend

@cubis/foundry 0.3.62 → 0.3.64

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 (996) hide show

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/csharp-pro/SKILL.md CHANGED Viewed

@@ -9,7 +9,6 @@ metadata:
   stack: "csharp"
   baseline: "C# 14 / .NET 10"
 ---
 # C# Pro
 ## When to use
@@ -18,6 +17,12 @@ metadata:
 - Refactoring legacy C# into modern, testable architecture.
 - Improving async correctness and operational resilience.
+## When not to use
+- Frontend-only browser work with no .NET runtime.
+- Database-only tuning where query/schema evidence is the primary task.
+- Tiny scripting tasks better served by existing shell or project tooling.
 ## Core workflow
 1. Confirm target framework/runtime constraints.
@@ -33,6 +38,24 @@ metadata:
 - Use dependency injection with explicit lifetimes.
 - Keep API contracts versioned and backward-compatible.
+## Debugging and observability
+- Use structured logs with correlation/request IDs on service boundaries.
+- Keep exception-to-response mapping explicit and non-leaky.
+- Prefer `dotnet test`, analyzers, and targeted traces before speculative rewrites.
+## Performance and reliability
+- Measure allocation hotspots before changing data structures.
+- Propagate `CancellationToken` through request and worker paths.
+- Bound retries/timeouts explicitly for network and queue work.
+## References
+| File | Load when |
+| --- | --- |
+| `references/operational-baseline.md` | You need current async, logging, testing, and deployment guardrails for C#/.NET services. |
 ## Avoid
 - Sync-over-async (`.Result`, `.Wait()`) in request paths.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/csharp-pro/references/operational-baseline.md ADDED Viewed

@@ -0,0 +1,9 @@
+## Operational baseline
+Load when: service-level logging, async boundaries, dependency injection, or production verification need explicit guardrails.
+- Keep nullable reference types enabled and treat warnings as design feedback.
+- Use `CancellationToken` in public async APIs and propagate it through external I/O.
+- Prefer structured logging with request/job correlation IDs.
+- Keep transport contracts separate from domain and persistence models.
+- Validate with `dotnet test`, analyzers, and targeted profiling before shipping.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-design/SKILL.md CHANGED Viewed

@@ -1,9 +1,7 @@
 ---
 name: database-design
 description: Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.
-allowed-tools: Read, Write, Edit, Glob, Grep
 ---
 # Database Design
 > **Learn to THINK, not copy SQL patterns.**
@@ -14,12 +12,12 @@ allowed-tools: Read, Write, Edit, Glob, Grep
 | File | Description | When to Read |
 |------|-------------|--------------|
-| `database-selection.md` | PostgreSQL vs Neon vs Turso vs SQLite | Choosing database |
-| `orm-selection.md` | Drizzle vs Prisma vs Kysely | Choosing ORM |
-| `schema-design.md` | Normalization, PKs, relationships | Designing schema |
-| `indexing.md` | Index types, composite indexes | Performance tuning |
-| `optimization.md` | N+1, EXPLAIN ANALYZE | Query optimization |
-| `migrations.md` | Safe migrations, serverless DBs | Schema changes |
+| `references/database-selection.md` | PostgreSQL vs Neon vs Turso vs SQLite | Choosing database |
+| `references/orm-selection.md` | Drizzle vs Prisma vs Kysely | Choosing ORM |
+| `references/schema-design.md` | Normalization, PKs, relationships | Designing schema |
+| `references/indexing.md` | Index types, composite indexes | Performance tuning |
+| `references/optimization.md` | N+1, EXPLAIN ANALYZE | Query optimization |
+| `references/migrations.md` | Safe migrations, serverless DBs | Schema changes |
 ---

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-optimizer/SKILL.md CHANGED Viewed

@@ -2,8 +2,6 @@
 name: "database-optimizer"
 description: "Use for system-level database performance triage across engines: bottleneck analysis, indexing strategy, config tuning, partitioning, and lock contention."
 ---
 # Database Optimizer
 ## Overview
@@ -79,9 +77,3 @@ When optimizing database performance, provide:
 ## Knowledge Reference
 PostgreSQL (pg_stat_statements, EXPLAIN ANALYZE, indexes, VACUUM, partitioning), MySQL (slow query log, EXPLAIN, InnoDB, query cache), query optimization, index design, execution plans, configuration tuning, replication, sharding, caching strategies
-## Related Powers
-- **Backend Developer** - Query pattern optimization
-- **DevOps Engineer** - Infrastructure and resource tuning
-- **Data Engineer** - ETL and analytical query optimization

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/SKILL.md CHANGED Viewed

@@ -1,13 +1,11 @@
 ---
 name: database-skills
 description: Unified database skill hub with engine-specific packs for PostgreSQL, MySQL, Vitess, Neki, MongoDB (Mongoose), SQLite, Supabase, and Redis.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 metadata:
   version: "2.0.0"
   domain: data
   triggers: database, sql, postgres, mysql, vitess, neki, mongodb, mongoose, sqlite, supabase, redis, schema, migration, index, query, performance, pagination, replication, pooling, sharding, cache
 ---
 # Database Skills Hub
 Use this as the primary database hub. Keep `database-design`, `database-optimizer`, and `drift-flutter` available for specialized/legacy-compatible flows. Load the target engine's `SKILL.md` from `skills/<engine>/`, then load relevant `references/*` files.
@@ -84,7 +82,7 @@ skills/
 ## Required flow
-1. Read `LATEST_VERSIONS.md` before proposing version-specific behavior.
+1. Read `references/LATEST_VERSIONS.md` before proposing version-specific behavior.
 2. Use engine selection table above to pick the target engine.
 3. Load the target engine `SKILL.md` and relevant `references/*` files — read the ones that match the task (indexing, migrations, replication, etc.).
 4. Provide an optimization or implementation plan that includes:

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/mongodb/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: mongodb
 description: MongoDB and Mongoose modeling, indexing, pagination, query tuning, and transaction guidance.
 ---
 # MongoDB and Mongoose
 ## Optimization workflow

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/mysql/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: mysql
 description: MySQL/InnoDB schema design, indexing, pagination, query tuning, and operational safety.
 ---
 # MySQL
 ## Version posture

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/neki/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: neki
 description: Neki planning guidance for sharded Postgres architecture decisions and operational guardrails.
 ---
 # Neki
 Neki is currently pre-GA (announced and under active development), so guidance is architecture-first and risk-aware.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/postgres/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: postgres
 description: PostgreSQL schema, indexing, pagination, query optimization, migrations, and operations.
 ---
 # Postgres
 ## Optimization workflow

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/redis/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: redis
 description: Redis data modeling, caching strategy, throughput/latency optimization, and operational safety.
 ---
 # Redis
 ## Optimization workflow

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/sqlite/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: sqlite
 description: SQLite local/edge data strategy, schema/index design, query planning, and WAL tuning.
 ---
 # SQLite
 ## Optimization workflow

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/supabase/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: supabase
 description: Supabase/Postgres patterns for RLS, indexing, query optimization, pooling, and safe migrations.
 ---
 # Supabase
 ## Optimization workflow

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/database-skills/skills/vitess/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: vitess
 description: Vitess sharding strategy, VSchema/vindex design, routing, and scale operations.
 ---
 # Vitess
 ## Primary focus

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/debugging-wizard/SKILL.md CHANGED Viewed

@@ -6,7 +6,6 @@ metadata:
   replaced_by: systematic-debugging
   removal_target: v0.6.0
 ---
 # Debugging Wizard
 ## Compatibility Alias

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deployment-procedures/SKILL.md CHANGED Viewed

@@ -6,7 +6,6 @@ metadata:
   replaced_by: devops-engineer
   removal_target: v0.6.0
 ---
 # Deployment Procedures
 ## Compatibility Alias

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/design-system-builder/SKILL.md CHANGED Viewed

@@ -1,19 +1,7 @@
 ---
 name: "design-system-builder"
-displayName: "Design System Builder"
 description: "Create and review design system components: API design, token usage, theming, variants, and documentation"
-keywords:
-  [
-    "design system",
-    "components",
-    "component design",
-    "tokens",
-    "theming",
-    "variants",
-    "widget api",
-  ]
 ---
 # Design System Builder
 ## Overview
@@ -140,9 +128,13 @@ When creating/reviewing a component:
 5. **Tests** (widget tests + golden ideas)
 6. **Migration Notes** (how to replace old widgets)
-## Steering Files
+## References
+Load detailed guidance only when needed.
-- `component_api_guidelines.md` - API design best practices
+| File | Load when |
+| --- | --- |
+| `references/component_api_guidelines.md` | Designing or reviewing a component API, variants, theming hooks, or token usage contracts |
 ## Templates

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/devops-engineer/SKILL.md CHANGED Viewed

@@ -2,8 +2,6 @@
 name: "devops-engineer"
 description: "Use when setting up CI/CD pipelines, containerizing applications, or managing infrastructure as code. Invoke for pipelines, Docker, Kubernetes, cloud platforms, GitOps."
 ---
 # DevOps Engineer
 ## Overview

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/documentation-templates/SKILL.md CHANGED Viewed

@@ -1,9 +1,7 @@
 ---
 name: documentation-templates
 description: Documentation templates and structure guidelines. README, API docs, code comments, and AI-friendly documentation.
-allowed-tools: Read, Glob, Grep
 ---
 # Documentation Templates
 > Templates and structure guidelines for common documentation types.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/drift-flutter/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: "drift-flutter"
 description: "Use when implementing Flutter local persistence with Drift: schema design, DAOs, migrations, transactions, and repository integration"
 ---
 # Drift Flutter
 ## When to Use

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/error-ux-observability/SKILL.md CHANGED Viewed

@@ -1,19 +1,7 @@
 ---
 name: "error-ux-observability"
-displayName: "Error UX & Observability"
 description: "Map backend failures to user-friendly messages, implement proper logging levels, and ensure observable error handling"
-keywords:
-  [
-    "error handling",
-    "error messages",
-    "logging",
-    "observability",
-    "user feedback",
-    "failure mapping",
-    "error ux",
-  ]
 ---
 # Error UX & Observability
 ## Overview
@@ -147,12 +135,15 @@ ref.listen(controllerProvider, (prev, next) {
 4. **Log at appropriate levels** (debug/info/warning/error/fatal)
 5. **Include stack traces for errors**
-## Steering Files
+## References
+Load detailed guidance only when needed.
-- `failure_to_ui.md` - Complete failure-to-message mapping guide
-- `logging_levels.md` - When to use each log level
+| File | Load when |
+| --- | --- |
+| `references/failure_to_ui.md` | Mapping backend/domain failures into user-facing messages and screen states |
+| `references/logging_levels.md` | Deciding which log level and structure to use for an event or failure |
 ## Templates
 - `failure_message_mapper` - Failure to UI message mapper template

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/fastapi-expert/SKILL.md CHANGED Viewed

@@ -12,7 +12,6 @@ metadata:
   output-format: code
   related-skills: fullstack-guardian, django-expert, test-master
 ---
 # FastAPI Expert
 Senior FastAPI specialist with deep expertise in async Python, Pydantic V2, and production-grade API development.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/fastify-patterns/SKILL.md CHANGED Viewed

@@ -2,8 +2,6 @@
 name: "fastify-patterns"
 description: "NestJS + Fastify integration patterns including secure sessions, cookie authentication, performance optimization, and plugin configuration. Use for high-performance API development."
 ---
 # Fastify Patterns
 ## Overview
@@ -14,7 +12,7 @@ Expert guidance for building high-performance NestJS applications with Fastify a
 You are a backend performance specialist with deep expertise in Fastify and NestJS integration. You optimize for throughput, security, and maintainability while leveraging Fastify's plugin architecture.
-## When to Use This Power
+## When to Use This Skill
 - Setting up NestJS with Fastify adapter
 - Implementing cookie-based session authentication
@@ -150,9 +148,3 @@ await app.register(secureSession, {
 | Requests/sec  | ~17,000 | ~30,000 | ~76% faster |
 | Latency (avg) | 5.8ms   | 3.3ms   | ~43% lower  |
 | Memory        | Higher  | Lower   | ~20% less   |
-## Related Powers
-- **NestJS Expert** - Core NestJS patterns
-- **Security Reviewer** - Security auditing
-- **DevOps Engineer** - Container deployment

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/feature-forge/SKILL.md CHANGED Viewed

@@ -12,7 +12,6 @@ metadata:
   output-format: document
   related-skills: fullstack-guardian, spec-miner, test-master
 ---
 # Feature Forge
 Requirements specialist conducting structured workshops to define comprehensive feature specifications.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/find-bugs/SKILL.md CHANGED Viewed

@@ -2,7 +2,6 @@
 name: find-bugs
 description: Find bugs, security vulnerabilities, and code quality issues in local branch changes. Use when asked to review changes, find bugs, security review, or audit code on the current branch.
 ---
 # Find Bugs
 Review changes on this branch for bugs, security vulnerabilities, and code quality issues.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/fix-review/SKILL.md CHANGED Viewed

@@ -1,15 +1,7 @@
 ---
 name: fix-review
 description: Verify remediation commits against security audit findings and confirm fixes without introducing regressions.
-allowed-tools:
-  - Read
-  - Write
-  - Grep
-  - Glob
-  - Bash
-  - WebFetch
 ---
 # Fix Review
 Differential analysis to verify commits address security findings without introducing bugs.
@@ -158,7 +150,7 @@ See `references/finding-matching.md` for detailed matching strategies.
 Generate two outputs:
-**1. Report file (`FIX_REVIEW_REPORT.md`):**
+**1. Report file (`FIX_REVIEW_REPORT` markdown artifact):**
 ```markdown
 # Fix Review Report

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/flutter-code-reviewer/SKILL.md CHANGED Viewed

@@ -1,21 +1,7 @@
 ---
 name: "flutter-code-reviewer"
-displayName: "Flutter/Dart Code Reviewer"
 description: "Perform strict, actionable code reviews for Flutter/Dart projects enforcing architecture boundaries, Riverpod patterns, testing, and performance"
-keywords:
-  [
-    "code review",
-    "pr review",
-    "flutter review",
-    "dart review",
-    "riverpod review",
-    "architecture",
-    "clean code",
-    "testing",
-    "performance",
-  ]
 ---
 # Flutter/Dart Code Reviewer
 ## Overview
@@ -166,20 +152,22 @@ Minimum:
 - 1 unit test for failure path
 - Widget test for loading/error/data (or override repo)
-See: `steering/testing_expectations.md`
+See: `references/testing_expectations.md`
 ---
-## Steering Files
+## References
+Load detailed guidance only when needed.
-| File                       | Load When                              |
-| -------------------------- | -------------------------------------- |
-| `review_checklist.md`      | Starting a review, categories          |
-| `testing_expectations.md`  | Checking test requirements             |
-| `common-issues.md`         | N+1 queries, magic numbers, patterns   |
-| `feedback-examples.md`     | Writing good feedback                  |
-| `strict-rules.md`          | Enforcing strict review standards      |
+| File | Load when |
+| --- | --- |
+| `references/review_checklist.md` | Starting a review and needing the full category-by-category checklist |
+| `references/testing_expectations.md` | Checking whether controller, widget, or regression tests are sufficient |
+| `references/common-issues.md` | Looking for recurring Flutter/Riverpod review smells and anti-patterns |
+| `references/feedback-examples.md` | Writing concise, high-signal review feedback with clear fixes |
+| `references/strict-rules.md` | Applying stricter merge-blocking review standards |
 ## Templates
-- `review_response.md` - Code review response template
+- `templates/review_response.md` - Code review response template

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/flutter-expert/SKILL.md CHANGED Viewed

@@ -1,20 +1,7 @@
 ---
 name: "flutter-expert"
-displayName: "Flutter Expert"
 description: "Flutter app architecture coordinator for Clean Architecture projects; delegates state, routing, persistence, testing, and security to specialized skills"
-keywords:
-  [
-    "flutter",
-    "clean architecture",
-    "modular",
-    "feature",
-    "coordination",
-    "riverpod",
-    "gorouter",
-    "drift",
-  ]
 ---
 # Flutter Expert
 ## Overview

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/flutter-security-reviewer/SKILL.md CHANGED Viewed

@@ -1,24 +1,7 @@
 ---
 name: "flutter-security-reviewer"
-displayName: "Flutter/Dart Security Reviewer"
 description: "Review Flutter/Dart code for security vulnerabilities: secure storage, network hardening, log redaction, and data protection"
-keywords:
-  [
-    "security",
-    "flutter security",
-    "dart security",
-    "secure storage",
-    "encryption",
-    "log redaction",
-    "network security",
-    "data protection",
-    "pii",
-    "sensitive data",
-    "authentication",
-    "authorization",
-  ]
 ---
 # Flutter/Dart Security Reviewer
 ## Overview
@@ -189,16 +172,18 @@ logger.info('User login successful: userId=${user.id}');
 ---
-## Steering Files
+## References
+Load detailed guidance only when needed.
-| File                        | Load When                              |
-| --------------------------- | -------------------------------------- |
-| `secure_storage_policy.md`  | What to store where                    |
-| `network_hardening.md`      | Network security best practices        |
-| `log_redaction.md`          | How to redact sensitive data from logs |
-| `vulnerability-patterns.md` | SQL injection, XSS, IDOR patterns      |
-| `secret-scanning.md`        | Finding hardcoded secrets              |
+| File | Load when |
+| --- | --- |
+| `references/secure_storage_policy.md` | Deciding where tokens, credentials, or sensitive user data may be stored |
+| `references/network_hardening.md` | Reviewing TLS, certificate handling, interceptor logging, or retry policy |
+| `references/log_redaction.md` | Redacting PII, tokens, and secrets from logs, analytics, and crash reports |
+| `references/vulnerability-patterns.md` | Checking for common auth, injection, IDOR, or trust-boundary weaknesses |
+| `references/secret-scanning.md` | Hunting for hardcoded secrets or unsafe configuration material |
 ## Templates
-- `security_review_response.md` - Security review report template
+- `templates/security_review_response.md` - Security review report template

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/flutter-test-master/SKILL.md CHANGED Viewed

@@ -1,23 +1,7 @@
 ---
 name: "flutter-test-master"
-displayName: "Flutter Test Master"
 description: "Comprehensive Flutter testing guide covering unit tests, widget tests, integration tests, golden tests, and Riverpod provider testing with mocktail"
-keywords:
-  [
-    "flutter",
-    "test",
-    "testing",
-    "unit test",
-    "widget test",
-    "integration test",
-    "golden test",
-    "riverpod",
-    "mocktail",
-    "tdd",
-  ]
-author: "OneUp HR Team"
 ---
 # Flutter Test Master
 ## Overview

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/frontend-design/SKILL.md CHANGED Viewed

@@ -1,9 +1,7 @@
 ---
 name: frontend-design
 description: Design thinking and decision-making for web UI. Use when designing components, layouts, color schemes, typography, or creating aesthetic interfaces. Teaches principles, not fixed values.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 ---
 # Frontend Design System
 > **Philosophy:** Every pixel has purpose. Restraint is luxury. User psychology drives decisions.
@@ -17,13 +15,13 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 | File | Status | When to Read |
 |------|--------|--------------|
-| [ux-psychology.md](ux-psychology.md) | 🔴 **REQUIRED** | Always read first! |
-| [color-system.md](color-system.md) | ⚪ Optional | Color/palette decisions |
-| [typography-system.md](typography-system.md) | ⚪ Optional | Font selection/pairing |
-| [visual-effects.md](visual-effects.md) | ⚪ Optional | Glassmorphism, shadows, gradients |
-| [animation-guide.md](animation-guide.md) | ⚪ Optional | Animation needed |
-| [motion-graphics.md](motion-graphics.md) | ⚪ Optional | Lottie, GSAP, 3D |
-| [decision-trees.md](decision-trees.md) | ⚪ Optional | Context templates |
+| [ux-psychology.md](references/ux-psychology.md) | 🔴 **REQUIRED** | Always read first! |
+| [color-system.md](references/color-system.md) | ⚪ Optional | Color/palette decisions |
+| [typography-system.md](references/typography-system.md) | ⚪ Optional | Font selection/pairing |
+| [visual-effects.md](references/visual-effects.md) | ⚪ Optional | Glassmorphism, shadows, gradients |
+| [animation-guide.md](references/animation-guide.md) | ⚪ Optional | Animation needed |
+| [motion-graphics.md](references/motion-graphics.md) | ⚪ Optional | Lottie, GSAP, 3D |
+| [decision-trees.md](references/decision-trees.md) | ⚪ Optional | Context templates |
 > 🔴 **ux-psychology.md = ALWAYS READ. Others = only if relevant.**
@@ -188,7 +186,7 @@ All spacing and sizing in multiples of 8:
 3. **Light or dark mode?** (sets foundation)
 4. **ASK USER** if not specified
-For detailed color theory: [color-system.md](color-system.md)
+For detailed color theory: [color-system.md](references/color-system.md)
 ---
@@ -219,7 +217,7 @@ Contrast + Harmony:
 - **Contrast**: Check WCAG requirements
 - **Size**: 16px+ for body on web
-For detailed typography: [typography-system.md](typography-system.md)
+For detailed typography: [typography-system.md](references/typography-system.md)
 ---
@@ -256,7 +254,7 @@ Harmonious gradients:
 └── VARY from project to project radically
 ```
-For complete effects guide: [visual-effects.md](visual-effects.md)
+For complete effects guide: [visual-effects.md](references/visual-effects.md)
 ---
@@ -287,7 +285,7 @@ Duration based on:
 - Respect reduced-motion preference
 - Test on low-end devices
-For animation patterns: [animation-guide.md](animation-guide.md), for advanced: [motion-graphics.md](motion-graphics.md)
+For animation patterns: [animation-guide.md](references/animation-guide.md), for advanced: [motion-graphics.md](references/motion-graphics.md)
 ---
@@ -383,13 +381,13 @@ For EVERY design task:
 For deeper guidance on specific areas:
-- [color-system.md](color-system.md) - Color theory and selection process
-- [typography-system.md](typography-system.md) - Font pairing and scale decisions
-- [visual-effects.md](visual-effects.md) - Effects principles and techniques
-- [animation-guide.md](animation-guide.md) - Motion design principles
-- [motion-graphics.md](motion-graphics.md) - Advanced: Lottie, GSAP, SVG, 3D, Particles
-- [decision-trees.md](decision-trees.md) - Context-specific templates
-- [ux-psychology.md](ux-psychology.md) - User psychology deep dive
+- [color-system.md](references/color-system.md) - Color theory and selection process
+- [typography-system.md](references/typography-system.md) - Font pairing and scale decisions
+- [visual-effects.md](references/visual-effects.md) - Effects principles and techniques
+- [animation-guide.md](references/animation-guide.md) - Motion design principles
+- [motion-graphics.md](references/motion-graphics.md) - Advanced: Lottie, GSAP, SVG, 3D, Particles
+- [decision-trees.md](references/decision-trees.md) - Context-specific templates
+- [ux-psychology.md](references/ux-psychology.md) - User psychology deep dive
 ---