@cubis/foundry 0.3.63 → 0.3.64

package/workflows/skills/database-skills/SKILL.md

@@ -84,7 +84,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/skills/design-system-builder/SKILL.md

@@ -140,9 +140,13 @@ When creating/reviewing a component:
 5. **Tests** (widget tests + golden ideas)
 6. **Migration Notes** (how to replace old widgets)
 
-## Steering Files
+## References
 
-- `component_api_guidelines.md` - API design best practices
+Load detailed guidance only when needed.
+
+| File | Load when |
+| --- | --- |
+| `references/component_api_guidelines.md` | Designing or reviewing a component API, variants, theming hooks, or token usage contracts |
 
 ## Templates
 

package/workflows/skills/error-ux-observability/SKILL.md

@@ -147,12 +147,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
 
-- `failure_to_ui.md` - Complete failure-to-message mapping guide
-- `logging_levels.md` - When to use each log level
+Load detailed guidance only when needed.
+
+| 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/skills/fastify-patterns/SKILL.md

@@ -14,7 +14,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 +150,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/skills/fix-review/SKILL.md

@@ -158,7 +158,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/skills/flutter-code-reviewer/SKILL.md

@@ -166,20 +166,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
 
-| 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      |
+Load detailed guidance only when needed.
+
+| 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/skills/flutter-security-reviewer/SKILL.md

@@ -189,16 +189,18 @@ logger.info('User login successful: userId=${user.id}');
 
 ---
 
-## Steering Files
+## References
 
-| 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              |
+Load detailed guidance only when needed.
+
+| 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/skills/frontend-design/SKILL.md

@@ -17,13 +17,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 +188,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 +219,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 +256,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 +287,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 +383,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
 
 ---
 

package/workflows/skills/golang-pro/SKILL.md

@@ -18,6 +18,12 @@ metadata:
 - Designing concurrency with goroutines/channels/context.
 - Optimizing latency, allocations, and reliability.
 
+## When not to use
+
+- Database-only tuning with no Go code change.
+- Browser/frontend tasks outside Go-backed services or tooling.
+- Small shell automation already well-covered by existing scripts.
+
 ## Core workflow
 
 1. Define package boundaries and interfaces.
@@ -41,6 +47,18 @@ metadata:
 - Use generics where they simplify, not where they obscure.
 - Benchmark hot paths (`testing.B`, `pprof`) before tuning.
 
+## Debugging and observability
+
+- Thread request IDs and trace context through handlers and workers.
+- Use structured logs that make cancellation, retries, and deadlines visible.
+- Reproduce concurrency issues with race tests and deterministic fixtures first.
+
+## Performance and reliability
+
+- Prefer bounded worker pools over unbounded goroutine fan-out.
+- Make timeout/cancellation behavior explicit at every network boundary.
+- Profile CPU, heap, and block contention before low-level rewrites.
+
 ## Avoid
 
 - Fire-and-forget goroutines without cancellation path.
@@ -49,8 +67,10 @@ metadata:
 
 ## Reference files
 
-- `references/concurrency.md`
-- `references/generics.md`
-- `references/interfaces.md`
-- `references/testing.md`
-- `references/project-structure.md`
+| File | Load when |
+| --- | --- |
+| `references/concurrency.md` | Concurrency ownership, channels, mutexes, or cancellation safety need detail. |
+| `references/generics.md` | Generics tradeoffs or reusable type-safe helpers are in scope. |
+| `references/interfaces.md` | Interface boundaries and package seams need review. |
+| `references/testing.md` | Test strategy, race checks, or benchmark setup is needed. |
+| `references/project-structure.md` | Package layout or service/module decomposition needs guidance. |

package/workflows/skills/gorouter-restoration/SKILL.md

@@ -114,10 +114,14 @@ MaterialApp.router(
 
 ## Steering Files
 
-- `guard_patterns.md` - Guard decision rules and anti-loop checks
-- `tab_preservation.md` - StatefulShellRoute and restoration patterns
+| File | Load when |
+| --- | --- |
+| `references/guard_patterns.md` | Designing guard logic, redirect rules, or anti-loop checks. |
+| `references/tab_preservation.md` | Preserving `StatefulShellRoute` branches and restoration state. |
 
 ## Templates
 
-- `guard_redirect` - Guard redirect function skeleton
-- `stateful_shell_skeleton` - Tab shell starter
+| File | Load when |
+| --- | --- |
+| `templates/guard_redirect.md` | Starting a redirect/guard function skeleton. |
+| `templates/stateful_shell_skeleton.md` | Starting a shell/tab restoration scaffold. |

package/workflows/skills/java-pro/SKILL.md

@@ -18,6 +18,12 @@ metadata:
 - Designing JVM architecture for high-throughput systems.
 - Improving reliability, observability, and maintainability.
 
+## When not to use
+
+- Frontend-only tasks with no JVM component.
+- Pure schema/index work better handled as database design or optimization.
+- Low-level native systems work where Rust/Go is the actual project stack.
+
 ## Core workflow
 
 1. Clarify runtime target and deployment constraints.
@@ -33,6 +39,24 @@ metadata:
 - Use structured logging and trace propagation.
 - Enforce dependency and API compatibility checks in CI.
 
+## Debugging and observability
+
+- Capture request/job correlation IDs in logs and traces.
+- Keep exception handling consistent between transport, service, and persistence layers.
+- Reproduce performance or memory issues with focused benchmarks/profilers before redesigning.
+
+## Performance and reliability
+
+- Prefer explicit timeouts, bulkheads, and retry budgets at I/O boundaries.
+- Keep thread/virtual-thread usage bounded and observable.
+- Separate transport DTOs from domain and persistence models to reduce cascade failures.
+
+## References
+
+| File | Load when |
+| --- | --- |
+| `references/operational-baseline.md` | You need current Java service guardrails for logging, testing, dependency hygiene, and runtime operations. |
+
 ## Avoid
 
 - Monolithic service classes with mixed responsibilities.

package/workflows/skills/java-pro/references/operational-baseline.md

@@ -0,0 +1,9 @@
+## Operational baseline
+
+Load when: JVM service reliability, logging, dependency hygiene, or runtime guardrails need explicit guidance.
+
+- Use structured logging and trace propagation at service boundaries.
+- Keep timeout/retry budgets explicit for external I/O.
+- Separate API contracts from persistence entities.
+- Prefer focused benchmark/profiler evidence before redesigning hot paths.
+- Validate with tests and compatibility checks in CI.

package/workflows/skills/javascript-pro/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: "javascript-pro"
-description: "Use for modern JavaScript architecture and implementation across browser, Node, and edge runtimes with ES2025+ practices."
+description: "Use for modern JavaScript architecture and implementation across browser, Node, and edge runtimes with runtime-aware production practices."
 license: MIT
 metadata:
   version: "2.0.0"
   domain: "language"
   role: "specialist"
   stack: "javascript"
-  baseline: "ES2025+"
+  baseline: "Runtime-policy baseline (Node/browser/edge)"
 ---
 
 # JavaScript Pro
@@ -18,6 +18,12 @@ metadata:
 - Refactoring legacy JS toward modern modules and async flows.
 - Improving performance and reliability in browser/Node runtimes.
 
+## When not to use
+
+- Type-driven architecture work where TypeScript is the actual project language.
+- Database-only investigation with no JavaScript runtime behavior involved.
+- One-off shell automation that should remain shell-native.
+
 ## Core workflow
 
 1. Confirm runtime constraints (browser targets, Node/edge version).
@@ -40,6 +46,18 @@ metadata:
 - Use streams for large payloads to avoid memory spikes.
 - Use feature detection, not UA sniffing, in browser code.
 
+## Debugging and observability
+
+- Reproduce runtime-specific failures in the exact target environment: browser, Node, or edge.
+- Surface async failures with structured errors and explicit logging context.
+- Use performance tooling before redesigning hot paths or caching strategy.
+
+## Performance and reliability
+
+- Keep bundle/runtime boundaries explicit so shared code does not assume unavailable APIs.
+- Bound parallelism and cancellation for network-heavy flows.
+- Prefer streaming, chunking, and incremental parsing for large payloads.
+
 ## Avoid
 
 - Silent promise rejections.
@@ -48,8 +66,10 @@ metadata:
 
 ## Reference files
 
-- `references/modern-syntax.md`
-- `references/async-patterns.md`
-- `references/modules.md`
-- `references/browser-apis.md`
-- `references/node-essentials.md`
+| File | Load when |
+| --- | --- |
+| `references/modern-syntax.md` | Choosing modern syntax/features for current runtime targets. |
+| `references/async-patterns.md` | Cancellation, retries, concurrency, or promise orchestration needs detail. |
+| `references/modules.md` | ESM/CJS/module-boundary tradeoffs are in scope. |
+| `references/browser-apis.md` | Browser-specific APIs, capability checks, or UX/runtime constraints matter. |
+| `references/node-essentials.md` | Node runtime behavior, streams, files, or process concerns matter. |

package/workflows/skills/kotlin-pro/SKILL.md

@@ -18,6 +18,12 @@ metadata:
 - Designing coroutine-based async flows.
 - Improving null-safety and domain model clarity.
 
+## When not to use
+
+- Frontend-only work with no Kotlin/JVM/Android/shared module in scope.
+- Database-only tuning without Kotlin code changes.
+- Tiny scripts that should stay in existing project tooling.
+
 ## Core workflow
 
 1. Establish target platform (JVM/Android/multiplatform).
@@ -33,6 +39,24 @@ metadata:
 - Keep serialization and transport models separate from domain.
 - Use dependency boundaries that support modular testing.
 
+## Debugging and observability
+
+- Keep coroutine context, dispatcher use, and cancellation visible in logs/traces.
+- Reproduce lifecycle-related failures with focused tests before broader rewrites.
+- Prefer deterministic `Flow`/coroutine tests for race-prone logic.
+
+## Performance and reliability
+
+- Bound coroutine fan-out and avoid hidden blocking on default dispatchers.
+- Keep Android/shared/JVM boundaries explicit to avoid platform leakage.
+- Favor allocation-light data flows in hot paths and measure before micro-optimizing.
+
+## References
+
+| File | Load when |
+| --- | --- |
+| `references/operational-baseline.md` | You need Kotlin coroutine, modularity, testing, and production guardrails. |
+
 ## Avoid
 
 - Coroutine launches without lifecycle ownership.

package/workflows/skills/kotlin-pro/references/operational-baseline.md

@@ -0,0 +1,9 @@
+## Operational baseline
+
+Load when: coroutine ownership, modularity, testing, or production guardrails need explicit guidance.
+
+- Keep coroutine scope ownership explicit and lifecycle-aware.
+- Avoid hidden blocking on shared/default dispatchers.
+- Keep shared/domain modules isolated from platform-specific details.
+- Use deterministic tests for `Flow`, coroutine, and lifecycle behavior.
+- Prefer structured logs and traces that show dispatcher/cancellation context.

package/workflows/skills/microservices-architect/SKILL.md

@@ -83,11 +83,3 @@ When designing microservices architecture, provide:
 ## Knowledge Reference
 
 Domain-driven design, bounded contexts, event storming, REST/gRPC, message queues (Kafka, RabbitMQ), service mesh (Istio, Linkerd), Kubernetes, circuit breakers, saga patterns, event sourcing, CQRS, distributed tracing (Jaeger, Zipkin), API gateways, eventual consistency, CAP theorem
-
-## Related Powers
-
-- **DevOps Engineer** - Container orchestration and CI/CD pipelines
-- **Kubernetes Specialist** - Advanced K8s patterns and operators
-- **GraphQL Architect** - Federation for distributed schemas
-- **Architecture Designer** - High-level system design
-- **Monitoring Expert** - Observability implementation

package/workflows/skills/mobile-design/SKILL.md

@@ -29,16 +29,16 @@ allowed-tools: Read, Glob, Grep, Bash
 
 | File | Content | Status |
 |------|---------|--------|
-| **[mobile-design-thinking.md](mobile-design-thinking.md)** | **⚠️ ANTI-MEMORIZATION: Forces thinking, prevents AI defaults** | **⬜ CRITICAL FIRST** |
-| **[touch-psychology.md](touch-psychology.md)** | **Fitts' Law, gestures, haptics, thumb zone** | **⬜ CRITICAL** |
-| **[mobile-performance.md](mobile-performance.md)** | **RN/Flutter performance, 60fps, memory** | **⬜ CRITICAL** |
-| **[mobile-backend.md](mobile-backend.md)** | **Push notifications, offline sync, mobile API** | **⬜ CRITICAL** |
-| **[mobile-testing.md](mobile-testing.md)** | **Testing pyramid, E2E, platform-specific** | **⬜ CRITICAL** |
-| **[mobile-debugging.md](mobile-debugging.md)** | **Native vs JS debugging, Flipper, Logcat** | **⬜ CRITICAL** |
-| [mobile-navigation.md](mobile-navigation.md) | Tab/Stack/Drawer, deep linking | ⬜ Read |
-| [mobile-typography.md](mobile-typography.md) | System fonts, Dynamic Type, a11y | ⬜ Read |
-| [mobile-color-system.md](mobile-color-system.md) | OLED, dark mode, battery-aware | ⬜ Read |
-| [decision-trees.md](decision-trees.md) | Framework/state/storage selection | ⬜ Read |
+| **[mobile-design-thinking.md](references/mobile-design-thinking.md)** | **⚠️ ANTI-MEMORIZATION: Forces thinking, prevents AI defaults** | **⬜ CRITICAL FIRST** |
+| **[touch-psychology.md](references/touch-psychology.md)** | **Fitts' Law, gestures, haptics, thumb zone** | **⬜ CRITICAL** |
+| **[mobile-performance.md](references/mobile-performance.md)** | **RN/Flutter performance, 60fps, memory** | **⬜ CRITICAL** |
+| **[mobile-backend.md](references/mobile-backend.md)** | **Push notifications, offline sync, mobile API** | **⬜ CRITICAL** |
+| **[mobile-testing.md](references/mobile-testing.md)** | **Testing pyramid, E2E, platform-specific** | **⬜ CRITICAL** |
+| **[mobile-debugging.md](references/mobile-debugging.md)** | **Native vs JS debugging, Flipper, Logcat** | **⬜ CRITICAL** |
+| [mobile-navigation.md](references/mobile-navigation.md) | Tab/Stack/Drawer, deep linking | ⬜ Read |
+| [mobile-typography.md](references/mobile-typography.md) | System fonts, Dynamic Type, a11y | ⬜ Read |
+| [mobile-color-system.md](references/mobile-color-system.md) | OLED, dark mode, battery-aware | ⬜ Read |
+| [decision-trees.md](references/decision-trees.md) | Framework/state/storage selection | ⬜ Read |
 
 > 🧠 **mobile-design-thinking.md is PRIORITY!** This file ensures AI thinks instead of using memorized patterns.
 
@@ -46,8 +46,8 @@ allowed-tools: Read, Glob, Grep, Bash
 
 | Platform | File | Content | When to Read |
 |----------|------|---------|--------------|
-| **iOS** | [platform-ios.md](platform-ios.md) | Human Interface Guidelines, SF Pro, SwiftUI patterns | Building for iPhone/iPad |
-| **Android** | [platform-android.md](platform-android.md) | Material Design 3, Roboto, Compose patterns | Building for Android |
+| **iOS** | [platform-ios.md](references/platform-ios.md) | Human Interface Guidelines, SF Pro, SwiftUI patterns | Building for iPhone/iPad |
+| **Android** | [platform-android.md](references/platform-android.md) | Material Design 3, Roboto, Compose patterns | Building for Android |
 | **Cross-Platform** | Both above | Platform divergence points | React Native / Flutter |
 
 > 🔴 **If building for iOS → Read platform-ios.md FIRST!**
@@ -193,7 +193,7 @@ Mobile:  Finger is imprecise (~7mm contact area)
 | Large viewport | Limited space, scroll vertical |
 | Stable attention | Interrupted constantly |
 
-For deep dive: [touch-psychology.md](touch-psychology.md)
+For deep dive: [touch-psychology.md](references/touch-psychology.md)
 
 ---
 
@@ -266,7 +266,7 @@ GPU-accelerated (FAST):     CPU-bound (SLOW):
                             └── (AVOID animating these)
 ```
 
-For complete guide: [mobile-performance.md](mobile-performance.md)
+For complete guide: [mobile-performance.md](references/mobile-performance.md)
 
 ---
 
@@ -336,7 +336,7 @@ WHAT ARE YOU BUILDING?
             └── ✅ Flutter
 ```
 
-For complete decision trees: [decision-trees.md](decision-trees.md)
+For complete decision trees: [decision-trees.md](references/decision-trees.md)
 
 ---
 
@@ -379,15 +379,15 @@ For deeper guidance on specific areas:
 
 | File | When to Use |
 |------|-------------|
-| [mobile-design-thinking.md](mobile-design-thinking.md) | **FIRST! Anti-memorization, forces context-based thinking** |
-| [touch-psychology.md](touch-psychology.md) | Understanding touch interaction, Fitts' Law, gesture design |
-| [mobile-performance.md](mobile-performance.md) | Optimizing RN/Flutter, 60fps, memory/battery |
-| [platform-ios.md](platform-ios.md) | iOS-specific design, HIG compliance |
-| [platform-android.md](platform-android.md) | Android-specific design, Material Design 3 |
-| [mobile-navigation.md](mobile-navigation.md) | Navigation patterns, deep linking |
-| [mobile-typography.md](mobile-typography.md) | Type scale, system fonts, accessibility |
-| [mobile-color-system.md](mobile-color-system.md) | OLED optimization, dark mode, battery |
-| [decision-trees.md](decision-trees.md) | Framework, state, storage decisions |
+| [mobile-design-thinking.md](references/mobile-design-thinking.md) | **FIRST! Anti-memorization, forces context-based thinking** |
+| [touch-psychology.md](references/touch-psychology.md) | Understanding touch interaction, Fitts' Law, gesture design |
+| [mobile-performance.md](references/mobile-performance.md) | Optimizing RN/Flutter, 60fps, memory/battery |
+| [platform-ios.md](references/platform-ios.md) | iOS-specific design, HIG compliance |
+| [platform-android.md](references/platform-android.md) | Android-specific design, Material Design 3 |
+| [mobile-navigation.md](references/mobile-navigation.md) | Navigation patterns, deep linking |
+| [mobile-typography.md](references/mobile-typography.md) | Type scale, system fonts, accessibility |
+| [mobile-color-system.md](references/mobile-color-system.md) | OLED optimization, dark mode, battery |
+| [decision-trees.md](references/decision-trees.md) | Framework, state, storage decisions |
 
 ---
 

package/workflows/skills/nestjs-expert/SKILL.md

@@ -14,7 +14,7 @@ Senior NestJS specialist with deep expertise in enterprise-grade, scalable TypeS
 
 You are a senior Node.js engineer with 10+ years of backend experience. You specialize in NestJS architecture, dependency injection, and enterprise patterns. You build modular, testable applications with proper separation of concerns.
 
-## When to Use This Power
+## When to Use This Skill
 
 - Building NestJS REST APIs with Fastify
 - Implementing modules, controllers, and services
@@ -105,10 +105,3 @@ When implementing NestJS features, provide:
 ## Knowledge Reference
 
 NestJS, TypeScript, Mongoose, Fastify, @fastify/secure-session, class-validator, class-transformer, Swagger/OpenAPI, Jest, Supertest, Guards, Interceptors, Pipes, Filters
-
-## Related Powers
-
-- **Fastify Patterns** - Fastify adapter and session configuration
-- **Mongoose NestJS** - MongoDB integration patterns
-- **Test Master** - Comprehensive testing strategies
-- **Security Reviewer** - Security auditing

package/workflows/skills/nestjs-expert/references/authentication.md

@@ -457,5 +457,5 @@ getMyOrg(@SessionUser('organizationId') orgId: string) {
 
 ## Related Reference Files
 
-- `references/secure-sessions.md` (Fastify Patterns) - Detailed session configuration
-- `references/services-di.md` - Dependency injection patterns
+- [secure-sessions.md](secure-sessions.md) (Fastify Patterns) - Detailed session configuration
+- [services-di.md](services-di.md) - Dependency injection patterns

package/workflows/skills/nestjs-expert/references/migration-from-express.md

@@ -989,7 +989,7 @@ describe('UsersController (e2e)', () => {
 
 Gradually replace Express routes with NestJS while both run simultaneously.
 
-**Cross-reference:** See `references/strangler-fig-pattern.md` for detailed implementation.
+**Cross-reference:** See [strangler-fig-pattern.md](strangler-fig-pattern.md) for detailed implementation.
 
 ```typescript
 // main.ts - Running both Express and NestJS

package/workflows/skills/nestjs-expert/references/secure-sessions.md

@@ -52,5 +52,5 @@ Do not store tokens, passwords, raw PII, or authorization policy blobs.
 
 ## Related
 
-- `references/authentication.md`
-- `references/services-di.md`
+- [authentication.md](authentication.md)
+- [services-di.md](services-di.md)

package/workflows/skills/nestjs-expert/references/strangler-fig-pattern.md

@@ -43,5 +43,5 @@ Move route groups from legacy to NestJS in controlled slices while preserving be
 
 ## Related
 
-- `references/migration-from-express.md`
-- `references/authentication.md`
+- [migration-from-express.md](migration-from-express.md)
+- [authentication.md](authentication.md)