@cubis/foundry 0.3.31 → 0.3.32

package/workflows/skills/vercel-cli/SKILL.md

@@ -1,85 +1,21 @@
 ---
 name: vercel-cli
-description: "Vercel CLI mastery: core commands, flags, MCP integration, microfrontend management, and project/domain/environment variable operations from the command line."
-license: MIT
+description: "Compatibility alias skill. Deprecated: use vercel-delivery."
 metadata:
-  author: cubis-foundry
-  version: "1.0.0"
-  domain: vercel
-  triggers: vercel cli, vercel command, npx vercel, vercel dev, vercel deploy, vercel env, vercel domains cli, vercel pull, vercel link, vercel mcp, vercel microfrontends cli
-  role: specialist
-  scope: implementation
-  output-format: checklist
-  related-skills: devops-engineer, wrangler, vercel-deployments, vercel-domains
-  consolidates: vercel-cli-core, vercel-cli-flags, vercel-cli-mcp, vercel-cli-microfrontends, vercel-cli-project-domain-env
+  deprecated: true
+  replaced_by: vercel-delivery
+  removal_target: v0.6.0
 ---
 
-# Vercel CLI
+# Vercel Cli
 
-## Purpose
+## Compatibility Alias
 
-Use the Vercel CLI for local development, deployments, environment management, domain operations, microfrontend orchestration, and MCP-based automation workflows.
+This skill is deprecated and kept for backward compatibility.
 
-## When To Use
+Use `vercel-delivery` as the canonical skill.
 
-- Running `vercel dev` for local development with edge function support.
-- Deploying with `vercel --prod` or `vercel deploy` from CI/CD.
-- Managing environment variables with `vercel env add/pull/rm`.
-- Managing domains and DNS with `vercel domains`.
-- Linking, inspecting, and managing project config with `vercel link`.
-- Using the Vercel MCP for agent-based CLI automation.
-- Managing microfrontend apps from the CLI.
+## Migration
 
-## Domain Areas
-
-### Core Commands
-
-| Command                    | Purpose                                    |
-| -------------------------- | ------------------------------------------ |
-| `vercel` / `vercel deploy` | Deploy current directory                   |
-| `vercel --prod`            | Deploy to production                       |
-| `vercel dev`               | Local dev server with edge emulation       |
-| `vercel build`             | Build locally (mirrors Vercel cloud build) |
-| `vercel inspect <url>`     | Inspect deployment details                 |
-| `vercel rollback`          | Instant rollback to previous deployment    |
-| `vercel link`              | Link local directory to Vercel project     |
-| `vercel pull`              | Pull project settings and env vars locally |
-
-### Flags
-
-- `--env`, `--build-env`, `--token`, `--scope`, `--yes`, `--no-wait`.
-- `--regions` for targeted regional deployment.
-- `--archive=tgz` for artifact-based deployments.
-
-### Project / Domain / Env
-
-- `vercel env add/pull/rm` — manage environment variables.
-- `vercel domains add/rm/inspect` — domain management.
-- `vercel alias set <url> <alias>` — assign deployment aliases.
-
-### MCP Integration
-
-- Use Vercel MCP server for agent-driven CLI automation.
-- Query deployment state, logs, and project config programmatically.
-
-### Microfrontends
-
-- `vercel microfrontends` commands for app group management.
-- Register and route microfrontend applications from CLI.
-
-## Operating Checklist
-
-1. Authenticate with `vercel login` and verify scope with `vercel whoami`.
-2. Link project with `vercel link` before running local commands.
-3. Pull env vars with `vercel env pull .env.local` for local dev.
-4. Use `vercel build` to validate build output before deploying.
-5. Automate deployments in CI with `--token` and `--yes` flags.
-6. Use `vercel rollback` as the immediate incident response action.
-
-## Output Contract
-
-- CLI authentication and project linking steps
-- Environment variable management workflow
-- CI/CD pipeline CLI integration commands
-- Relevant flags and flags rationale
-- Rollback procedure and verification steps
+1. Replace direct references to `vercel-cli` with `vercel-delivery`.
+2. Apply the full workflow from `vercel-delivery` for new work.

package/workflows/skills/vercel-delivery/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: vercel-delivery
+description: "Canonical Vercel delivery skill covering deployments, domains, flags, and CLI-driven release operations."
+metadata:
+  deprecated: false
+  replaced_by: null
+  removal_target: null
+---
+
+# Vercel Delivery
+
+## Purpose
+
+Run reliable Vercel release operations end-to-end: build/deploy lifecycle, environment promotion, domain management, feature-flag rollout, and CLI automation.
+
+## Use This For
+
+- Deployment pipelines and promotion policy
+- Preview/production environment controls
+- Custom domains, DNS/SSL readiness
+- Controlled rollouts with feature flags
+- Vercel CLI operational workflows
+
+## Decision Flow
+
+1. Lock release target and rollback checkpoint.
+2. Choose rollout strategy (direct, staged, flag-gated).
+3. Verify domain/certificate/environment integrity.
+4. Execute release with post-deploy checks.
+
+## Verification
+
+- Deployment health is green in target environment.
+- Domain resolution and TLS are valid.
+- Rollback command/path is tested and documented.
+
+## Related Skills
+
+- `vercel-platform`
+- `vercel-runtime`
+- `vercel-security`
+- `devops-engineer`

package/workflows/skills/vercel-deployments/SKILL.md

@@ -1,101 +1,21 @@
 ---
 name: vercel-deployments
-description: "Vercel deployment lifecycle: git-triggered deployments, build pipeline, build output API, deployment promotion, environment management, preview/production protection, and generated URL patterns."
-license: MIT
+description: "Compatibility alias skill. Deprecated: use vercel-delivery."
 metadata:
-  author: cubis-foundry
-  version: "1.0.0"
-  domain: vercel
-  triggers: vercel, deployment, git deploy, build pipeline, build output api, deployment promotion, environments, preview, production, protection, generated urls, build image
-  role: specialist
-  scope: implementation
-  output-format: checklist
-  related-skills: devops-engineer, vercel-cli, vercel-caching, vercel-domains
-  consolidates: vercel-git-deployments, vercel-deployment-promotion, vercel-deployment-protection, vercel-protection-bypass-automation, vercel-environments, vercel-build-pipeline, vercel-build-output-api, vercel-build-image-upgrades, vercel-generated-urls
+  deprecated: true
+  replaced_by: vercel-delivery
+  removal_target: v0.6.0
 ---
 
 # Vercel Deployments
 
-## Purpose
+## Compatibility Alias
 
-Manage the full Vercel deployment lifecycle from git-triggered builds to production promotion, including environment management, deployment protection, build pipeline customization, and URL strategies.
+This skill is deprecated and kept for backward compatibility.
 
-## When To Use
+Use `vercel-delivery` as the canonical skill.
 
-- Setting up git-based automatic deployments (push-to-deploy).
-- Configuring build pipeline steps and custom build commands.
-- Using Build Output API for framework-agnostic output generation.
-- Promoting preview deployments to production.
-- Configuring deployment protection (password, SSO, Vercel Auth).
-- Automating protection bypass for CI/CD testing.
-- Managing multiple environments (production, preview, development).
-- Understanding and controlling generated deployment URL patterns.
-- Upgrading build image versions.
+## Migration
 
-## Domain Areas
-
-### Git Deployments
-
-- Branch → environment mapping (main → production, etc.).
-- Ignored build step configuration.
-- Monorepo detection and build filtering.
-
-### Build Pipeline
-
-- Custom `buildCommand`, `outputDirectory`, `installCommand`.
-- Build caching and artifact reuse.
-- Build environment variable injection.
-
-### Build Output API
-
-- Framework-agnostic output format: static files, functions, middleware.
-- `config.json`, `routes`, and prerender configs.
-
-### Build Image Upgrades
-
-- Choose and lock Node.js / system dependency versions.
-- Upgrade strategy and regression testing plan.
-
-### Deployment Promotion
-
-- Promote preview to production via CLI or dashboard.
-- Instant rollback to previous production deployment.
-
-### Deployment Protection
-
-- Configure Vercel Authentication, password protection, or IP allowlists for previews.
-- Set per-environment protection levels.
-
-### Protection Bypass Automation
-
-- Use `VERCEL_AUTOMATION_BYPASS_SECRET` for CI access to protected deployments.
-- Rotate secrets and audit bypass usage.
-
-### Environments
-
-- Manage production, preview, and development environment variables.
-- Scope secrets per target environment.
-- Use environment variable groups for shared config.
-
-### Generated URLs
-
-- Understand deployment URL anatomy (`project-hash-team.vercel.app`).
-- Configure custom domains alongside generated URLs.
-- Use deployment URLs in CI testing pipelines.
-
-## Operating Checklist
-
-1. Validate git branch → environment mapping before first deploy.
-2. Test build pipeline locally with `vercel build` before pushing.
-3. Set deployment protection for preview environments.
-4. Configure protection bypass secret for CI/CD pipelines.
-5. Stage → promote workflow: test on preview, promote to production.
-6. Verify instant rollback readiness before any risky deploy.
-
-## Output Contract
-
-- Build pipeline configuration (`vercel.json` / framework config)
-- Environment variable structure per environment tier
-- Deployment protection settings and bypass secret rotation plan
-- Promotion runbook with rollback steps
-- Residual risks and follow-up actions
+1. Replace direct references to `vercel-deployments` with `vercel-delivery`.
+2. Apply the full workflow from `vercel-delivery` for new work.

package/workflows/skills/vercel-domains/SKILL.md

@@ -1,80 +1,21 @@
 ---
 name: vercel-domains
-description: "Vercel domain management: custom domains, DNS records, nameservers, SSL certificates, domain ownership verification, and static IP configuration."
-license: MIT
+description: "Compatibility alias skill. Deprecated: use vercel-delivery."
 metadata:
-  author: cubis-foundry
-  version: "1.0.0"
-  domain: vercel
-  triggers: vercel, domain, dns, nameservers, ssl, certificate, custom domain, cname, static ip, domain ownership
-  role: specialist
-  scope: implementation
-  output-format: checklist
-  related-skills: devops-engineer, vercel-deployments, vercel-platform
-  consolidates: vercel-dns-records, vercel-nameservers, vercel-ssl-certificates, vercel-domain-ownership-claims, vercel-static-ips
+  deprecated: true
+  replaced_by: vercel-delivery
+  removal_target: v0.6.0
 ---
 
 # Vercel Domains
 
-## Purpose
+## Compatibility Alias
 
-Manage custom domains on Vercel including DNS configuration, nameserver delegation, SSL certificate provisioning, domain ownership verification, and static IP assignment.
+This skill is deprecated and kept for backward compatibility.
 
-## When To Use
+Use `vercel-delivery` as the canonical skill.
 
-- Adding a custom domain to a Vercel project.
-- Configuring DNS records (A, CNAME, TXT, MX) for a domain.
-- Delegating nameservers to Vercel for full DNS management.
-- Troubleshooting SSL certificate provisioning failures.
-- Claiming domain ownership for enterprise configurations.
-- Assigning dedicated static IPs for allowlist-based firewall rules.
+## Migration
 
-## Domain Areas
-
-### Custom Domains
-
-- Add domains in Vercel project settings.
-- Configure redirect from www ↔ apex and production ↔ preview.
-
-### DNS Records
-
-- Manage A, AAAA, CNAME, TXT, MX, SRV records via Vercel DNS.
-- Priority ordering for MX and SRV records.
-
-### Nameservers
-
-- Delegate domain to Vercel nameservers for managed DNS.
-- Validate propagation with `dig`/`nslookup`.
-
-### SSL Certificates
-
-- Automatic cert provisioning via Let's Encrypt.
-- Troubleshoot DNS validation challenges.
-- Wildcard cert requirements for multi-tenant setups.
-
-### Domain Ownership Claims
-
-- Verify domain ownership using TXT record DNS challenges.
-- Required for enterprise team domain assignment.
-
-### Static IPs
-
-- Enable dedicated static egress IPs for firewall allowlisting.
-- Document IPs for downstream system configuration.
-
-## Operating Checklist
-
-1. Confirm ownership and DNS authority for each managed domain.
-2. Apply changes with TTL and propagation windows accounted for.
-3. Validate SSL cert provisioning and auto-renewal is active.
-4. Complete domain ownership claim if required by enterprise team.
-5. Document static IPs and communicate to downstream firewall owners.
-6. Prepare rollback records for every production DNS change.
-
-## Output Contract
-
-- DNS record configuration plan with TTL values
-- SSL certificate provisioning status and validation method
-- Nameserver delegation steps and verification commands
-- Static IP assignments and downstream firewall change requests
-- Residual risks (propagation delays, cert failures)
+1. Replace direct references to `vercel-domains` with `vercel-delivery`.
+2. Apply the full workflow from `vercel-delivery` for new work.

package/workflows/skills/vercel-firewall/SKILL.md

@@ -1,72 +1,21 @@
 ---
 name: vercel-firewall
-description: "Vercel security controls: WAF core, custom firewall rules, rate limiting, bot management, and BotID fingerprinting for DDoS protection, abuse prevention, and traffic filtering."
-license: MIT
+description: "Compatibility alias skill. Deprecated: use vercel-security."
 metadata:
-  author: cubis-foundry
-  version: "1.0.0"
-  domain: vercel
-  triggers: vercel, firewall, waf, rate limiting, bot protection, botid, ddos, abuse, traffic filtering, custom rules
-  role: specialist
-  scope: implementation
-  output-format: checklist
-  related-skills: secure-code-guardian, security-reviewer, vercel-observability, vercel-domains
-  consolidates: vercel-firewall-core, vercel-waf-custom-rules, vercel-waf-rate-limiting, vercel-bot-management, vercel-botid
+  deprecated: true
+  replaced_by: vercel-security
+  removal_target: v0.6.0
 ---
 
 # Vercel Firewall
 
-## Purpose
+## Compatibility Alias
 
-Protect Vercel deployments from abuse, DDoS, bots, and malicious traffic using WAF custom rules, rate limiting, bot management, and BotID fingerprinting.
+This skill is deprecated and kept for backward compatibility.
 
-## When To Use
+Use `vercel-security` as the canonical skill.
 
-- Setting up WAF rules to block or challenge malicious requests.
-- Implementing rate limiting to prevent API abuse.
-- Detecting and blocking bad bots while allowing good bots.
-- Using BotID for persistent bot fingerprinting.
-- Configuring IP allowlists/blocklists and geo-based rules.
+## Migration
 
-## Domain Areas
-
-### WAF Core & Custom Rules
-
-- Create IP-based, header-based, path-based, and geo-based rules.
-- Actions: `deny`, `challenge`, `log`, `redirect`.
-- Set rule priority and conflict resolution order.
-
-### Rate Limiting
-
-- Configure request rate limits per IP, route, or user segment.
-- Define burst allowances and penalty durations.
-- Use sliding window vs fixed window strategies.
-
-### Bot Management
-
-- Distinguish good bots (crawlers, monitors) from bad bots.
-- Apply challenge pages or blocks for detected bots.
-- Maintain an up-to-date allowed bot list.
-
-### BotID
-
-- Enable persistent bot fingerprinting via BotID header.
-- Use BotID signals in downstream application logic.
-- Monitor and tune BotID confidence thresholds.
-
-## Operating Checklist
-
-1. Audit current attack patterns and abuse vectors before rule creation.
-2. Define rule priorities and test in log-only mode first.
-3. Set rate limits with appropriate burst allowances to avoid false positives.
-4. Enable and tune bot management; validate good-bot pass-through.
-5. Monitor firewall metrics post-deploy for false positive spikes.
-6. Document all rules with justification for future maintenance.
-
-## Output Contract
-
-- WAF rule set definition with priorities and actions
-- Rate limiting configuration per route/IP
-- Bot management policy and BotID integration plan
-- Monitoring thresholds and alert definitions
-- False positive mitigation strategy
+1. Replace direct references to `vercel-firewall` with `vercel-security`.
+2. Apply the full workflow from `vercel-security` for new work.

package/workflows/skills/vercel-flags/SKILL.md

@@ -1,73 +1,21 @@
 ---
 name: vercel-flags
-description: "Vercel Feature Flags: SDK integration, platform setup, CLI workflows, dashboard management, explorer UI, and OpenFeature compatibility for safe, targeted rollouts."
-license: MIT
+description: "Compatibility alias skill. Deprecated: use vercel-delivery."
 metadata:
-  author: cubis-foundry
-  version: "1.0.0"
-  domain: vercel
-  triggers: vercel, feature flags, flags sdk, flags platform, openfeature, flags dashboard, flags explorer, feature toggle, rollout, a/b test
-  role: specialist
-  scope: implementation
-  output-format: checklist
-  related-skills: nextjs-developer, vercel-deployments, vercel-cli
-  consolidates: vercel-flags-platform, vercel-flags-sdk, vercel-flags-cli-workflows, vercel-flags-dashboard, vercel-flags-explorer, vercel-flags-openfeature
+  deprecated: true
+  replaced_by: vercel-delivery
+  removal_target: v0.6.0
 ---
 
 # Vercel Flags
 
-## Purpose
+## Compatibility Alias
 
-Implement Vercel Feature Flags end-to-end: platform configuration, SDK integration in application code, CLI management workflows, dashboard visibility, explorer UX for teams, and OpenFeature provider compatibility.
+This skill is deprecated and kept for backward compatibility.
 
-## When To Use
+Use `vercel-delivery` as the canonical skill.
 
-- Setting up feature flags on Vercel platform.
-- Integrating `@vercel/flags` SDK into Next.js or other frameworks.
-- Managing flags via CLI for automated rollout pipelines.
-- Using the Flags Dashboard or Explorer for team visibility.
-- Implementing OpenFeature-compatible providers for portability.
+## Migration
 
-## Domain Areas
-
-### Platform Setup
-
-- Configure flag definitions and environments in Vercel dashboard.
-- Assign targeting rules, rollout percentages, and user segments.
-
-### SDK Integration
-
-- Install `@vercel/flags` and configure provider.
-- Use `unstable_flag`, `flag()`, and edge-compatible evaluation.
-- Integrate with Next.js middleware and React Server Components.
-
-### CLI Workflows
-
-- `vercel flags ls`, `vercel flags pull`, `vercel flags push`.
-- Automate flag state changes in CI/CD pipelines.
-
-### Dashboard & Explorer
-
-- Monitor flag state, overrides, and exposure metrics.
-- Use the Toolbar and Explorer for local override during development.
-
-### OpenFeature Compatibility
-
-- Register Vercel as an OpenFeature provider.
-- Maintain provider-agnostic flag evaluation logic.
-
-## Operating Checklist
-
-1. Define flag schema and targeting rules before implementation.
-2. Integrate SDK with appropriate edge/server evaluation context.
-3. Implement safe defaults for all flags (fail-closed).
-4. Validate flag exposure in dashboard before broad rollout.
-5. Automate flag lifecycle (create, rollout, cleanup) in CI.
-
-## Output Contract
-
-- Flag schema definitions and targeting rule design
-- SDK integration code and Next.js adapter config
-- CLI workflow scripts for CI/CD pipelines
-- Dashboard monitoring setup and exposure validation
-- Residual risks and cleanup checklist
+1. Replace direct references to `vercel-flags` with `vercel-delivery`.
+2. Apply the full workflow from `vercel-delivery` for new work.

package/workflows/skills/vercel-functions/SKILL.md

@@ -1,81 +1,21 @@
 ---
 name: vercel-functions
-description: "Vercel Serverless and Edge Functions: core patterns, Node.js and Python runtimes, edge runtime, Fluid Compute for long-running tasks, and function configuration."
-license: MIT
+description: "Compatibility alias skill. Deprecated: use vercel-runtime."
 metadata:
-  author: cubis-foundry
-  version: "1.0.0"
-  domain: vercel
-  triggers: vercel, serverless, functions, edge function, nodejs runtime, python runtime, fluid compute, function config, api route, edge runtime
-  role: specialist
-  scope: implementation
-  output-format: checklist
-  related-skills: nodejs-best-practices, fastapi-expert, vercel-routing, vercel-caching
-  consolidates: vercel-functions-core, vercel-functions-edge-runtime, vercel-functions-nodejs, vercel-functions-python, vercel-function-config, vercel-fluid-compute
+  deprecated: true
+  replaced_by: vercel-runtime
+  removal_target: v0.6.0
 ---
 
 # Vercel Functions
 
-## Purpose
+## Compatibility Alias
 
-Design and implement Vercel Serverless and Edge Functions with the correct runtime selection, configuration, and compute strategy for each use case.
+This skill is deprecated and kept for backward compatibility.
 
-## When To Use
+Use `vercel-runtime` as the canonical skill.
 
-- Writing Vercel API routes or serverless function handlers.
-- Choosing between Edge Runtime and Node.js runtime.
-- Configuring Python serverless functions on Vercel.
-- Implementing long-running tasks or streaming with Fluid Compute.
-- Tuning function memory, regions, timeout, and concurrency config.
+## Migration
 
-## Domain Areas
-
-### Core Patterns
-
-- Request/response handler structure for Vercel functions.
-- Environment-aware error handling and status codes.
-- Cold start mitigation strategies.
-
-### Node.js Runtime
-
-- Use `@vercel/node` and standard Node.js APIs.
-- Streaming responses with `Response` and `ReadableStream`.
-
-### Python Runtime
-
-- Configure `requirements.txt` and handler conventions.
-- Use WSGI/ASGI adapters where needed.
-
-### Edge Runtime
-
-- Use Web Standard APIs only (no Node.js built-ins).
-- Optimize for global low-latency execution at the edge.
-- Middleware-friendly patterns.
-
-### Fluid Compute
-
-- Enable for long-running tasks exceeding standard limits.
-- Stream output progressively for large responses.
-- Configure max duration and concurrency appropriately.
-
-### Function Config (`vercel.json`)
-
-- Set `runtime`, `regions`, `maxDuration`, `memory` per function.
-- Use `rewrites` to map routes to specific functions.
-
-## Operating Checklist
-
-1. Choose runtime (Edge vs Node.js vs Python) based on latency, API, and duration needs.
-2. Set explicit `maxDuration` and `memory` for non-default requirements.
-3. Implement structured error responses with proper HTTP status codes.
-4. Test cold-start behavior and streaming in staging environment.
-5. Validate regional deployment targets match latency requirements.
-6. Run regression checks before promoting to production.
-
-## Output Contract
-
-- Runtime selection rationale and tradeoffs
-- Handler implementation with error handling and streaming
-- `vercel.json` function config section
-- Performance validation (cold start, p99 latency targets)
-- Residual risks and follow-up actions
+1. Replace direct references to `vercel-functions` with `vercel-runtime`.
+2. Apply the full workflow from `vercel-runtime` for new work.