@cubis/foundry 0.3.81 → 0.3.83

package/workflows/workflows/agent-environment-setup/platforms/{copilot/workflows/orchestrate.md → claude/generated-skills/orchestrate/SKILL.md}

@@ -1,9 +1,16 @@
 ---
-command: "/orchestrate"
+name: orchestrate
 description: "Coordinate multiple specialists to solve cross-cutting tasks with explicit ownership, validation gates, and repeat-until-good iteration."
-triggers: ["orchestrate", "coordinate", "multi-area", "cross-team", "handoff"]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "orchestrate"
+  platform: "Claude Code"
+  command: "/orchestrate"
+compatibility: Claude Code
 ---
-
+# orchestrate Workflow
 # Orchestrate Workflow
 
 ## When to use
@@ -13,19 +20,19 @@ Use this when a task spans multiple domains (backend + frontend, security + infr
 ## Routing
 
 - Primary coordinator: `@orchestrator`
-- Specialist routing determined by task decomposition — delegates to `@backend-specialist`, `@frontend-specialist`, `@database-architect`, `@security-auditor`, `@ci-cd-pipeline`, `@test-engineer`, `@mobile-developer`, or other specialist agents as needed.
+- Specialist routing determined by task decomposition — delegates to `@backend-specialist`, `@frontend-specialist`, `@database-architect`, `@security-auditor`, `@devops-engineer`, `@test-engineer`, `@mobile-developer`, or other specialist agents as needed.
 - Validation support: `@validator`
 
 ## Context notes
 
 - This workflow file, active platform rules, and selected agents or skills guide execution.
 - Attach the full task description, constraints, acceptance criteria, and relevant context when starting.
-- Read `ENGINEERING_RULES.md` and `TECH.md` before decomposing non-trivial work, then reuse any existing `docs/specs/<spec-id>/` pack as the handoff source of truth.
+- Read `ENGINEERING_RULES.md` and `docs/foundation/TECH.md` before decomposing non-trivial work. Check `docs/foundation/TECH.md` for build/validation commands and `docs/foundation/PRODUCT.md` for domain glossary. Then reuse any existing `docs/specs/<spec-id>/` pack as the handoff source of truth.
 
 ## Skill Routing
 
 - Primary skills: `system-design`, `api-design`
-- Supporting skills (optional): `database-design`, `deep-research`, `mcp-server-builder`, `tech-doc`, `prompt-engineering`, `skill-creator`
+- Supporting skills (optional): `database-design`, `deep-research`, `mcp-server-builder`, `openai-docs`, `prompt-engineering`, `skill-creator`
 - Start with `system-design` for system design coordination and `api-design` for integration contracts. Add `deep-research` before implementation when the coordination challenge depends on fresh external facts or public comparison.
 
 ## Workflow steps
@@ -68,4 +75,4 @@ ORCHESTRATE_WORKFLOW_RESULT:
   doc_impact: none | tech | rules | both
   remaining_risks: [<string>] | []
   follow_up_actions: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/{copilot/workflows/plan.md → claude/generated-skills/plan/SKILL.md}

@@ -1,20 +1,16 @@
 ---
-command: "/plan"
+name: plan
 description: "Build a decision-complete implementation plan with interfaces, failure modes, and acceptance criteria."
-triggers:
-  [
-    "plan",
-    "design",
-    "roadmap",
-    "acceptance",
-    "brainstorm",
-    "idea",
-    "options",
-    "tradeoff",
-    "approach",
-  ]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "plan"
+  platform: "Claude Code"
+  command: "/plan"
+compatibility: Claude Code
 ---
-
+# plan Workflow
 # Plan Workflow
 
 ## When to use
@@ -31,13 +27,13 @@ Use this when starting a new feature, project, or significant change that needs
 
 - This workflow file, active platform rules, and selected agents or skills guide execution.
 - Attach the feature request, problem statement, constraints, and any existing design documents.
-- Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before finalizing a non-trivial plan.
+- Read `ENGINEERING_RULES.md` first and `docs/foundation/TECH.md` next when they exist before finalizing a non-trivial plan. Also check `docs/foundation/PRODUCT.md` for domain glossary and `docs/foundation/ARCHITECTURE.md` for crosscutting concerns and dependency rules.
 - Reuse an existing `docs/specs/<spec-id>/` pack when the change already has one instead of creating a parallel planning track.
 
 ## Skill Routing
 
 - Primary skills: `system-design`, `api-design`
-- Supporting skills (optional): `database-design`, `deep-research`, `mcp-server-builder`, `tech-doc`, `prompt-engineering`, `skill-creator`
+- Supporting skills (optional): `database-design`, `deep-research`, `mcp-server-builder`, `openai-docs`, `prompt-engineering`, `skill-creator`
 - Start with `system-design` for system design and `api-design` for API contracts. Add `database-design` when data modeling is central, `deep-research` when fresh external knowledge or public comparison is needed.
 
 ## Workflow steps
@@ -85,4 +81,4 @@ PLAN_WORKFLOW_RESULT:
   doc_impact: none | tech | rules | both
   traceability_status: complete | partial | blocked
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/{copilot/workflows/refactor.md → claude/generated-skills/refactor/SKILL.md}

@@ -1,9 +1,16 @@
 ---
-command: "/refactor"
+name: refactor
 description: "Improve maintainability while preserving behavior through incremental safe refactoring."
-triggers: ["refactor", "cleanup", "maintainability", "debt", "modularize"]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "refactor"
+  platform: "Claude Code"
+  command: "/refactor"
+compatibility: Claude Code
 ---
-
+# refactor Workflow
 # Refactor Workflow
 
 ## When to use
@@ -20,13 +27,13 @@ Use this when improving code structure, reducing tech debt, or modularizing with
 
 - This workflow file, active platform rules, and selected agents or skills guide execution.
 - Attach the target code, pain points, and any constraints on what can change.
-- Read `ENGINEERING_RULES.md` and `TECH.md` first so behavior-preserving structure changes do not drift from the accepted architecture contract.
+- Read `ENGINEERING_RULES.md` and `docs/foundation/TECH.md` first so behavior-preserving structure changes do not drift from the accepted architecture contract. Check `docs/foundation/ARCHITECTURE.md` for `## Dependency Rules` and `## Crosscutting Concerns` before restructuring.
 
 ## Skill Routing
 
-- Primary skills: `code-review`, `system-design`
-- Supporting skills (optional): `unit-testing`, `system-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`
-- Start with `code-review` for automated code quality assessment. Add `system-design` for modernization patterns. Add `unit-testing` when refactoring needs test coverage to proceed safely.
+- Primary skills: `static-analysis`, `legacy-modernizer`
+- Supporting skills (optional): `testing-patterns`, `system-design`, `typescript-pro`, `javascript-pro`, `python-pro`, `golang-pro`
+- Start with `static-analysis` for automated code quality assessment. Add `legacy-modernizer` for modernization patterns. Add `testing-patterns` when refactoring needs test coverage to proceed safely.
 
 ## Workflow steps
 
@@ -50,8 +57,8 @@ Use this when improving code structure, reducing tech debt, or modularizing with
 REFACTOR_WORKFLOW_RESULT:
   primary_agent: code-archaeologist
   supporting_agents: [backend-specialist?, frontend-specialist?, test-engineer?, validator?]
-  primary_skills: [code-review, system-design]
-  supporting_skills: [unit-testing?, system-design?]
+  primary_skills: [static-analysis, legacy-modernizer]
+  supporting_skills: [testing-patterns?, system-design?]
   refactoring_summary:
     targets: [<string>]
     changes_applied: [<string>]
@@ -62,4 +69,4 @@ REFACTOR_WORKFLOW_RESULT:
   doc_impact: none | tech | rules | both
   tests_added: [<test-file-path>] | []
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/{copilot/workflows/release.md → claude/generated-skills/release/SKILL.md}

@@ -1,9 +1,16 @@
 ---
-command: "/release"
+name: release
 description: "Prepare and execute release with rollout guardrails, verification, and rollback plan."
-triggers: ["release", "deploy", "rollout", "ship", "go-live"]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "release"
+  platform: "Claude Code"
+  command: "/release"
+compatibility: Claude Code
 ---
-
+# release Workflow
 # Release Workflow
 
 ## When to use
@@ -12,7 +19,7 @@ Use this when preparing a release, deploying to production, or managing a rollou
 
 ## Routing
 
-- Primary coordinator: `@ci-cd-pipeline`
+- Primary coordinator: `@devops-engineer`
 - Release verification: `@test-engineer`, `@validator`
 - Documentation: `@documentation-writer`
 
@@ -20,13 +27,13 @@ Use this when preparing a release, deploying to production, or managing a rollou
 
 - This workflow file, active platform rules, and selected agents or skills guide execution.
 - Attach the release scope, version number, changelog draft, and deployment target.
-- Read `ENGINEERING_RULES.md` and `TECH.md` before release if the shipped changes touched architecture, scaling assumptions, or design-system rules.
+- Read `ENGINEERING_RULES.md` and `docs/foundation/TECH.md` before release if the shipped changes touched architecture, scaling assumptions, or design-system rules. Check `docs/foundation/TECH.md` for `## Build And Validation` and `## CI CD Pipeline` steps to verify the release pipeline.
 
 ## Skill Routing
 
-- Primary skills: `ci-cd-pipeline`, `git-workflow`
-- Supporting skills (optional): `tech-doc`, `ci-cd-pipeline`, `observability`, `kubernetes-deploy`, `observability`, `ci-cd-pipeline`, `typescript-best-practices`, `javascript-best-practices`
-- Start with `ci-cd-pipeline` for deployment automation and `git-workflow` for release branching. Add `tech-doc` for release notes.
+- Primary skills: `ci-cd-pipelines`, `git-workflow`
+- Supporting skills (optional): `changelog-generator`, `devops-engineer`, `sre-engineer`, `docker-kubernetes`, `observability`, `serverless-patterns`, `typescript-pro`, `javascript-pro`
+- Start with `ci-cd-pipelines` for deployment automation and `git-workflow` for release branching. Add `changelog-generator` for release notes.
 
 ## Workflow steps
 
@@ -50,10 +57,10 @@ Use this when preparing a release, deploying to production, or managing a rollou
 
 ```yaml
 RELEASE_WORKFLOW_RESULT:
-  primary_agent: ci-cd-pipeline
+  primary_agent: devops-engineer
   supporting_agents: [test-engineer?, validator?, documentation-writer?]
-  primary_skills: [ci-cd-pipeline, git-workflow]
-  supporting_skills: [tech-doc?, ci-cd-pipeline?, observability?]
+  primary_skills: [ci-cd-pipelines, git-workflow]
+  supporting_skills: [changelog-generator?, devops-engineer?, sre-engineer?]
   release:
     version: <string>
     changelog: <string>
@@ -65,4 +72,4 @@ RELEASE_WORKFLOW_RESULT:
   rollback_plan: <string>
   doc_impact: none | tech | rules | both
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/claude/{workflows/review.md → generated-skills/review/SKILL.md}

@@ -1,9 +1,16 @@
 ---
-command: "/review"
+name: review
 description: "Run a strict review for bugs, regressions, accessibility issues, security risk, and code quality with prioritized findings."
-triggers: ["review", "audit", "pr", "quality", "security review"]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "review"
+  platform: "Claude Code"
+  command: "/review"
+compatibility: Claude Code
 ---
-
+# review Workflow
 # Review Workflow
 
 ## When to use
@@ -24,9 +31,9 @@ Use this for code review, PR review, or quality audit of existing code changes.
 
 ## Skill Routing
 
-- Primary skills: `code-review`, `code-review`, `unit-testing`
-- Supporting skills (optional): `owasp-security-review`, `owasp-security-review`, `performance-testing`, `react`, `nextjs`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`
-- Start with `code-review` for UI code or `code-review` for backend code. Add `unit-testing` when evaluating test quality. Add `owasp-security-review` for security-sensitive changes.
+- Primary skills: `frontend-code-review`, `static-analysis`, `testing-patterns`
+- Supporting skills (optional): `security-engineer`, `vulnerability-scanner`, `web-perf`, `react-expert`, `nextjs-developer`, `typescript-pro`, `javascript-pro`, `python-pro`, `golang-pro`
+- Start with `frontend-code-review` for UI code or `static-analysis` for backend code. Add `testing-patterns` when evaluating test quality. Add `security-engineer` for security-sensitive changes.
 
 ## Workflow steps
 
@@ -50,8 +57,8 @@ Use this for code review, PR review, or quality audit of existing code changes.
 REVIEW_WORKFLOW_RESULT:
   primary_agent: <frontend-specialist | backend-specialist>
   supporting_agents: [security-auditor?, validator?, test-engineer?]
-  primary_skills: [code-review?, code-review?, unit-testing?]
-  supporting_skills: [owasp-security-review?, owasp-security-review?, performance-testing?]
+  primary_skills: [frontend-code-review?, static-analysis?, testing-patterns?]
+  supporting_skills: [security-engineer?, vulnerability-scanner?, web-perf?]
   findings:
     - severity: critical | high | medium | low
       category: correctness | security | accessibility | performance | style
@@ -61,4 +68,4 @@ REVIEW_WORKFLOW_RESULT:
   overall_assessment: approve | request_changes | reject
   positive_observations: [<string>] | []
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/claude/{workflows/security.md → generated-skills/security/SKILL.md}

@@ -1,9 +1,16 @@
 ---
-command: "/security"
+name: security
 description: "Run security-focused analysis and remediation planning with exploitability-first triage."
-triggers: ["security", "vulnerability", "owasp", "auth", "hardening"]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "security"
+  platform: "Claude Code"
+  command: "/security"
+compatibility: Claude Code
 ---
-
+# security Workflow
 # Security Workflow
 
 ## When to use
@@ -24,9 +31,9 @@ Use this for security audits, vulnerability assessments, threat modeling, or sec
 
 ## Skill Routing
 
-- Primary skills: `owasp-security-review`, `owasp-security-review`
-- Supporting skills (optional): `owasp-security-review`, `code-review`, `api-design`, `api-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `rust-best-practices`
-- Start with `owasp-security-review` for OWASP methodology and threat modeling. Add `owasp-security-review` for authentication/authorization review. Add `owasp-security-review` for dependency scanning and CVE triage.
+- Primary skills: `security-engineer`, `auth-architect`
+- Supporting skills (optional): `vulnerability-scanner`, `static-analysis`, `api-design`, `graphql-architect`, `typescript-pro`, `javascript-pro`, `python-pro`, `golang-pro`, `rust-pro`
+- Start with `security-engineer` for OWASP methodology and threat modeling. Add `auth-architect` for authentication/authorization review. Add `vulnerability-scanner` for dependency scanning and CVE triage.
 
 ## Workflow steps
 
@@ -50,8 +57,8 @@ Use this for security audits, vulnerability assessments, threat modeling, or sec
 SECURITY_WORKFLOW_RESULT:
   primary_agent: security-auditor
   supporting_agents: [penetration-tester?, backend-specialist?, frontend-specialist?, validator?]
-  primary_skills: [owasp-security-review, owasp-security-review]
-  supporting_skills: [owasp-security-review?, code-review?, api-design?]
+  primary_skills: [security-engineer, auth-architect]
+  supporting_skills: [vulnerability-scanner?, static-analysis?, api-design?]
   threat_model:
     assets: [<string>]
     threats: [<string>]
@@ -64,4 +71,4 @@ SECURITY_WORKFLOW_RESULT:
   compliance_notes: [<string>] | []
   remaining_risks: [<string>] | []
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/claude/{workflows/spec.md → generated-skills/spec/SKILL.md}

@@ -1,19 +1,16 @@
 ---
-command: "/spec"
+name: spec
 description: "Create or refresh a Git-tracked spec pack for non-trivial work, including acceptance criteria, traceability, architecture impact, and next-route handoff."
-triggers:
-  [
-    "spec",
-    "sdd",
-    "source of truth",
-    "traceability",
-    "acceptance criteria",
-    "openspec",
-    "requirements",
-    "architecture impact",
-  ]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "spec"
+  platform: "Claude Code"
+  command: "/spec"
+compatibility: Claude Code
 ---
-
+# spec Workflow
 # Spec Workflow
 
 ## When to use
@@ -38,7 +35,7 @@ Use this for non-trivial work that needs durable planning in Git before implemen
 1. Determine whether the task is non-trivial enough to justify a spec pack.
 2. Find an existing `docs/specs/<spec-id>/` pack or create a new stable `spec_id`.
 3. Write or refresh the spec pack with brief, acceptance, tasks, traceability, and handoff files.
-4. Record `architecture_impact`, `doc_impact`, and any required updates to `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, `ENGINEERING_RULES.md`, or `docs/foundation/TECH.md`.
+4. Record `architecture_impact`, `doc_impact`, and any required updates to `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, `ENGINEERING_RULES.md`, or `docs/foundation/TECH.md`. If the change adds new terms, update the `## Domain Glossary` in `docs/foundation/PRODUCT.md`. If the change introduces new crosscutting patterns or tech debt, flag updates needed in `docs/foundation/ARCHITECTURE.md`.
 5. Identify the next execution route and hand off without replanning the same work.
 
 ## Context notes
@@ -76,4 +73,4 @@ SPEC_WORKFLOW_RESULT:
     updated: [<path>] | []
   next_route: </create | /implement-track | /orchestrate | /architecture | direct>
   gaps: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/claude/{workflows/test.md → generated-skills/test/SKILL.md}

@@ -1,9 +1,16 @@
 ---
-command: "/test"
+name: test
 description: "Design and execute verification strategy aligned to user risk, release confidence, and regression evidence."
-triggers: ["test", "verify", "coverage", "qa", "regression"]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "test"
+  platform: "Claude Code"
+  command: "/test"
+compatibility: Claude Code
 ---
-
+# test Workflow
 # Test Workflow
 
 ## When to use
@@ -24,9 +31,9 @@ Use this when writing new tests, improving coverage, debugging test failures, or
 
 ## Skill Routing
 
-- Primary skills: `unit-testing`, `integration-testing`
-- Supporting skills (optional): `playwright-interactive`, `observability`, `systematic-debugging`, `code-review`, `code-review`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`
-- Start with `unit-testing` for test strategy and architecture. Add `integration-testing` for implementation. Add `playwright-interactive` for E2E automation. Add `observability` for testing error states.
+- Primary skills: `testing-patterns`, `webapp-testing`
+- Supporting skills (optional): `playwright-e2e`, `error-ux-observability`, `debugging-strategies`, `frontend-code-review`, `static-analysis`, `typescript-pro`, `javascript-pro`, `python-pro`, `golang-pro`, `java-pro`
+- Start with `testing-patterns` for test strategy and architecture. Add `webapp-testing` for implementation. Add `playwright-e2e` for E2E automation. Add `error-ux-observability` for testing error states.
 
 ## Workflow steps
 
@@ -49,8 +56,8 @@ Use this when writing new tests, improving coverage, debugging test failures, or
 TEST_WORKFLOW_RESULT:
   primary_agent: test-engineer
   supporting_agents: [qa-automation-engineer?, backend-specialist?, frontend-specialist?, validator?]
-  primary_skills: [unit-testing, integration-testing]
-  supporting_skills: [playwright-interactive?, observability?, systematic-debugging?]
+  primary_skills: [testing-patterns, webapp-testing]
+  supporting_skills: [playwright-e2e?, error-ux-observability?, debugging-strategies?]
   test_strategy:
     unit: <number of tests>
     integration: <number of tests>
@@ -61,4 +68,4 @@ TEST_WORKFLOW_RESULT:
     after: <percentage or description>
   gaps_remaining: [<string>] | []
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/claude/{workflows/vercel.md → generated-skills/vercel/SKILL.md}

@@ -1,18 +1,16 @@
 ---
-command: "/vercel"
+name: vercel
 description: "Drive Vercel implementation and operations via vercel-expert with deployment, runtime, security, and observability guardrails."
-triggers:
-  [
-    "vercel",
-    "deployment",
-    "preview",
-    "edge",
-    "functions",
-    "domains",
-    "vercel cli",
-  ]
+license: MIT
+metadata:
+  author: cubis-foundry
+  route-kind: "workflow"
+  route-id: "vercel"
+  platform: "Claude Code"
+  command: "/vercel"
+compatibility: Claude Code
 ---
-
+# vercel Workflow
 # Vercel Workflow
 
 ## When to use
@@ -22,7 +20,7 @@ Use this for Vercel-specific deployment, configuration, runtime optimization, or
 ## Routing
 
 - Primary specialist: `@vercel-expert`
-- Infrastructure support: `@ci-cd-pipeline`
+- Infrastructure support: `@devops-engineer`
 - Verification support: `@test-engineer`
 
 ## Context notes
@@ -32,9 +30,9 @@ Use this for Vercel-specific deployment, configuration, runtime optimization, or
 
 ## Skill Routing
 
-- Primary skills: `nextjs`, `ci-cd-pipeline`
-- Supporting skills (optional): `performance-testing`, `react`, `frontend-design`, `javascript-best-practices`, `typescript-best-practices`, `javascript-best-practices`
-- Start with `nextjs` for Next.js on Vercel and `ci-cd-pipeline` for runtime behavior. Add `performance-testing` for performance optimization.
+- Primary skills: `nextjs-developer`, `serverless-patterns`
+- Supporting skills (optional): `web-perf`, `react-expert`, `tailwind-patterns`, `nodejs-best-practices`, `typescript-pro`, `javascript-pro`
+- Start with `nextjs-developer` for Next.js on Vercel and `serverless-patterns` for runtime behavior. Add `web-perf` for performance optimization.
 
 ## Workflow steps
 
@@ -57,9 +55,9 @@ Use this for Vercel-specific deployment, configuration, runtime optimization, or
 ```yaml
 VERCEL_WORKFLOW_RESULT:
   primary_agent: vercel-expert
-  supporting_agents: [ci-cd-pipeline?, test-engineer?]
-  primary_skills: [nextjs, ci-cd-pipeline]
-  supporting_skills: [performance-testing?, react?]
+  supporting_agents: [devops-engineer?, test-engineer?]
+  primary_skills: [nextjs-developer, serverless-patterns]
+  supporting_skills: [web-perf?, react-expert?]
   deployment:
     project: <string>
     runtime: <edge | serverless | static>
@@ -71,4 +69,4 @@ VERCEL_WORKFLOW_RESULT:
     caching: <string>
   monitoring: <string>
   follow_up_items: [<string>] | []
-```
+```

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/api-design/SKILL.md

@@ -84,5 +84,12 @@ Load only what the current task requires.
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/architecture-doc/SKILL.md

@@ -79,5 +79,12 @@ Load on demand. Do not preload all reference files.
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/ci-cd-pipeline/SKILL.md

@@ -76,5 +76,12 @@ Provide complete pipeline configuration files with inline comments explaining no
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/code-review/SKILL.md

@@ -70,5 +70,12 @@ When conducting a code review, provide:
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/csharp-best-practices/SKILL.md

@@ -83,5 +83,12 @@ No helper scripts are required for this skill right now. Keep execution in `SKIL
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/database-design/SKILL.md

@@ -79,5 +79,12 @@ Load on demand. Do not preload all reference files.
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/SKILL.md

@@ -91,5 +91,12 @@ Use these when the task shape already matches.
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/django-drf/SKILL.md

@@ -68,5 +68,12 @@ No helper scripts are required for this skill right now. Keep execution in `SKIL
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.

package/workflows/workflows/agent-environment-setup/platforms/claude/skills/docker-compose-dev/SKILL.md

@@ -76,5 +76,12 @@ Provide complete `docker-compose.yml` and `Dockerfile` content with inline comme
 - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
 - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
 - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
+- Custom subagents in `.claude/agents/*.md` support YAML frontmatter: `name`, `description`, `tools`, `model`, `maxTurns`, `memory`, `handoffs`.
+- Use `model` field in agent frontmatter to select model per subagent (e.g., `model: opus` for complex analysis).
+- Set `maxTurns` to prevent runaway iterations (default: 25, orchestrator: 30).
+- Key agents support `memory: project` for cross-session learning (orchestrator, debugger, researcher, project-planner).
+- Hook templates in `.claude/hooks/` provide lifecycle event integration at `UserPromptSubmit` and other events.
+- Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
 - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
 - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
+- Workflow skills can be compiled to `.claude/skills/<workflow-id>/SKILL.md` as `generatedSkills`.