opencastle 0.1.0 → 0.3.0

package/src/orchestrator/agents/architect.agent.md

@@ -5,6 +5,8 @@ model: Claude Opus 4.6
 tools: ['search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'search', 'search/usages', 'execute/runInTerminal', 'execute/getTerminalOutput', 'read/terminalLastCommand', 'nx-mcp-server/nx_workspace', 'nx-mcp-server/nx_project_details', 'nx-mcp-server/nx_visualize_graph']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Software Architect
 
 You are a senior software architect specializing in strategic architecture decisions, roadmap planning, system design, and technology evaluation.

package/src/orchestrator/agents/content-engineer.agent.md

@@ -5,6 +5,8 @@ model: Gemini 3.1 Pro
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'sanity/get_schema', 'sanity/get_sanity_rules', 'sanity/list_sanity_rules', 'sanity/query_documents', 'sanity/get_document', 'sanity/create_documents_from_json', 'sanity/create_documents_from_markdown', 'sanity/patch_document_from_json', 'sanity/patch_document_from_markdown', 'sanity/deploy_schema', 'sanity/publish_documents', 'sanity/unpublish_documents', 'sanity/discard_drafts', 'sanity/list_projects', 'sanity/list_datasets', 'sanity/list_workspace_schemas', 'sanity/list_embeddings_indices', 'sanity/search_docs', 'sanity/read_docs', 'sanity/semantic_search', 'sanity/migration_guide', 'sanity/create_version', 'sanity/generate_image', 'sanity/transform_image', 'sanity/add_cors_origin']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Content Engineer
 
 You are a content engineer specializing in CMS schema design, content queries, content modeling, plugin development, and studio customization.

package/src/orchestrator/agents/copywriter.agent.md

@@ -5,6 +5,8 @@ model: GPT-5 mini
 tools: ['search/codebase', 'edit/editFiles', 'web/fetch', 'search', 'read/problems', 'search/usages', 'sanity/get_schema', 'sanity/query_documents', 'sanity/get_document', 'sanity/patch_document_from_json', 'sanity/patch_document_from_markdown', 'sanity/list_datasets', 'sanity/list_projects', 'resend/send-email']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Copywriter
 
 You are a copywriter specializing in user-facing text for web applications — UI microcopy, marketing copy, email content, SEO text, error messages, and content polish.

package/src/orchestrator/agents/data-expert.agent.md

@@ -5,6 +5,8 @@ model: GPT-5.3-Codex
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'sanity/get_schema', 'sanity/query_documents', 'sanity/create_documents_from_json', 'sanity/patch_document_from_json', 'sanity/get_document', 'sanity/list_datasets', 'sanity/list_projects']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Data Expert
 
 You are an expert in building ETL pipelines, web scrapers, data processors, and CLI tools for data ingestion.

package/src/orchestrator/agents/database-engineer.agent.md

@@ -5,6 +5,8 @@ model: Gemini 3.1 Pro
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'supabase/apply_migration', 'supabase/execute_sql', 'supabase/list_tables', 'supabase/list_migrations', 'supabase/list_extensions', 'supabase/get_logs', 'supabase/get_project', 'supabase/get_project_url', 'supabase/list_projects', 'supabase/search_docs', 'supabase/generate_typescript_types', 'supabase/get_advisors', 'supabase/create_branch', 'supabase/list_branches']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Database Engineer
 
 You are a database engineer specializing in schema design, migrations, row-level security, performance optimization, and auth integration.

package/src/orchestrator/agents/developer.agent.md

@@ -5,6 +5,8 @@ model: Gemini 3.1 Pro
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/newWorkspace', 'vscode/runCommand', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'nx-mcp-server/nx_project_details', 'nx-mcp-server/nx_workspace', 'nx-mcp-server/nx_generators']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Developer
 
 You are a full-stack developer specializing in building pages, components, routing, layouts, API routes, server-side logic, and feature implementation.

package/src/orchestrator/agents/devops-expert.agent.md

@@ -5,6 +5,8 @@ model: GPT-5.3-Codex
 tools: ["search/changes", "search/codebase", "edit/editFiles", "web/fetch", "vscode/getProjectSetupInfo", "vscode/installExtension", "vscode/newWorkspace", "vscode/runCommand", "read/problems", "execute/getTerminalOutput", "execute/runInTerminal", "read/terminalLastCommand", "read/terminalSelection", "search", "execute/testFailure", "search/usages", "vercel/deploy_to_vercel", "vercel/get_deployment", "vercel/get_deployment_build_logs", "vercel/get_project", "vercel/get_runtime_logs", "vercel/list_deployments", "vercel/list_projects", "vercel/list_teams", "vercel/search_vercel_documentation", "vercel/check_domain_availability_and_price", "nx-mcp-server/nx_project_details", "nx-mcp-server/nx_workspace", "nx-mcp-server/nx_workspace_path"]
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # DevOps Expert
 
 You are a DevOps expert specializing in Vercel deployments, CI/CD pipelines, cron jobs, security headers, caching strategies, and build optimization.

package/src/orchestrator/agents/documentation-writer.agent.md

@@ -5,6 +5,8 @@ model: GPT-5 mini
 tools: ['search/codebase', 'edit/editFiles', 'web/fetch', 'search', 'read/problems']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Documentation Writer
 
 You are a technical documentation specialist. You maintain project documentation, roadmaps, architecture records, and technical guides.

package/src/orchestrator/agents/performance-expert.agent.md

@@ -5,6 +5,8 @@ model: Gemini 3.1 Pro
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'chrome-devtools/*', 'nx-mcp-server/nx_project_details', 'nx-mcp-server/nx_workspace']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Performance Expert
 
 You are an expert in frontend and backend performance optimization.

package/src/orchestrator/agents/release-manager.agent.md

@@ -5,6 +5,8 @@ model: GPT-5.3-Codex
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'vercel/get_deployment', 'vercel/get_deployment_build_logs', 'vercel/get_runtime_logs', 'vercel/list_deployments', 'vercel/list_projects', 'nx-mcp-server/nx_project_details', 'nx-mcp-server/nx_workspace', 'nx-mcp-server/nx_workspace_path']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Release Manager
 
 You are a release manager responsible for pre-release verification, changelog generation, version management, regression checks, and coordinating the release process.

package/src/orchestrator/agents/researcher.agent.md

@@ -5,6 +5,8 @@ model: GPT-5 mini
 tools: ['search/codebase', 'search/textSearch', 'search/fileSearch', 'search/usages', 'read/readFile', 'search/listDirectory', 'web/fetch', 'execute/runInTerminal', 'read/terminalLastCommand']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Researcher
 
 You are a codebase exploration specialist. Your job is to **find information, map patterns, and report back** — never to implement changes. You are the team's scout: fast, thorough, and focused on delivering actionable intelligence.

package/src/orchestrator/agents/reviewer.agent.md

@@ -1,3 +1,5 @@
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 ```chatagent
 ---
 description: 'Mandatory fast reviewer that validates every agent delegation output before acceptance. Checks acceptance criteria, file partitions, regressions, type safety, and security basics.'

package/src/orchestrator/agents/security-expert.agent.md

@@ -5,6 +5,8 @@ model: Claude Opus 4.6
 tools: ["search/changes", "search/codebase", "edit/editFiles", "web/fetch", "vscode/getProjectSetupInfo", "vscode/installExtension", "vscode/newWorkspace", "vscode/runCommand", "read/problems", "execute/getTerminalOutput", "execute/runInTerminal", "read/terminalLastCommand", "read/terminalSelection", "search", "execute/testFailure", "search/usages", "supabase/execute_sql", "supabase/list_tables", "supabase/get_advisors", "supabase/list_migrations", "supabase/get_project"]
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Security Expert
 
 You are a security expert specializing in authentication, authorization, security headers, input validation, API security, and vulnerability management for Next.js applications with Supabase.

package/src/orchestrator/agents/seo-specialist.agent.md

@@ -5,6 +5,8 @@ model: GPT-5 mini
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'search', 'search/usages', 'chrome-devtools/*']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # SEO Specialist
 
 You are an SEO specialist focused on technical SEO implementation — meta tags, structured data, sitemaps, Open Graph, crawlability, and search performance for web applications.

package/src/orchestrator/agents/team-lead.agent.md

@@ -71,6 +71,8 @@ handoffs:
     send: true
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Team Lead
 
 You are a **team lead and task orchestrator**. You do **not** implement code yourself. Your role is to:

package/src/orchestrator/agents/testing-expert.agent.md

@@ -5,6 +5,8 @@ model: GPT-5.3-Codex
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'chrome-devtools/*']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Testing Expert
 
 You are an expert tester who validates UI changes using Chrome DevTools MCP automation and writes E2E/integration test suites.
@@ -49,7 +51,7 @@ Every test suite must cover:
 - Verify server-side behavior — confirm filter changes trigger new server requests
 - Start the dev server before browser testing
 - Reload between major test flows to prevent stale state
-- **MANDATORY: Test every UI change at all three responsive breakpoints (Mobile 375px, Tablet 768px, Desktop 1440px) — never test at desktop only. Use `mcp_chrome-devtoo_resize_page()` to switch viewports. See the browser-testing skill for exact commands and per-breakpoint checklists.**
+- **MANDATORY: Test every UI change at all responsive breakpoints defined in the project's testing config — never test at desktop only. Use `mcp_chrome-devtoo_resize_page()` to switch viewports. See the browser-testing skill for exact commands and per-breakpoint checklists.**
 
 ## Critical Rules
 

package/src/orchestrator/agents/ui-ux-expert.agent.md

@@ -5,6 +5,8 @@ model: Gemini 3.1 Pro
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/newWorkspace', 'vscode/runCommand', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search', 'execute/testFailure', 'search/usages', 'chrome-devtools/*']
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # UI/UX Expert
 
 You are an expert UI/UX developer specializing in building accessible, visually consistent React components based on a design system template.
@@ -29,7 +31,7 @@ Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
 ## Guidelines
 
 - Design with mobile-first responsive approach
-- **Validate every UI change at all three breakpoints:** Mobile (375px), Tablet (768px), Desktop (1440px) — load the **e2e-testing** skill (resolved via matrix) for resize commands and per-breakpoint checklists
+- **Validate every UI change at all responsive breakpoints** defined in the project's testing config — load the **e2e-testing** skill (resolved via matrix) for resize commands and per-breakpoint checklists
 - Use semantic HTML before adding ARIA
 - Test with keyboard-only navigation
 - Implement hover, focus, and active states for all interactive elements
@@ -38,7 +40,7 @@ Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
 
 ## Done When
 
-- Components render correctly at all three breakpoints (375px, 768px, 1440px)
+- Components render correctly at all project-defined responsive breakpoints
 - WCAG 2.2 AA compliance verified (keyboard navigation, contrast, semantics)
 - Components are exported from the UI library index
 - Hover, focus, and active states are implemented for all interactive elements
@@ -57,7 +59,7 @@ When completing a task, return a structured summary:
 
 1. **Components** — List components created/modified with purpose
 2. **Accessibility** — WCAG checks performed and results
-3. **Responsive** — Breakpoints tested (mobile 375px, tablet 768px, desktop 1440px)
+3. **Responsive** — Breakpoints tested (per project testing config)
 4. **Visual Evidence** — Screenshots at each breakpoint
 
 See **Base Output Contract** in `general.instructions.md` for the standard closing items (Discovered Issues + Lessons Applied).

package/src/orchestrator/copilot-instructions.md

@@ -1,3 +1,5 @@
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Copilot Instructions
 
 All conventions, architecture, and project context live in `.github/instructions/`. Read those files before making changes.

package/src/orchestrator/instructions/ai-optimization.instructions.md

@@ -3,6 +3,8 @@ description: 'AI assistant optimization techniques for efficient context usage a
 applyTo: '**'
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # AI Assistant Optimization Instructions
 
 ## Batch Processing

package/src/orchestrator/instructions/general.instructions.md

@@ -2,6 +2,8 @@
 applyTo: '**'
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Coding Standards
 
 ## Constitution

package/src/orchestrator/prompts/bootstrap-customizations.prompt.md

@@ -3,6 +3,8 @@ description: 'Bootstrap the .github/customizations/ directory for a new project.
 agent: Researcher
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Bootstrap Project Customizations
 
 You are setting up the AI agent framework for a new project. Your job is to **discover** the project's structure, tech stack, and configuration, then **generate** the customization files that skills reference for project-specific context.

package/src/orchestrator/prompts/brainstorm.prompt.md

@@ -3,6 +3,8 @@ description: 'Collaborative brainstorm to explore requirements, approaches, and
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Brainstorm
 
 You are the Team Lead. Before planning or writing any code, run a structured brainstorm to explore the request described below. The goal is to **surface assumptions, alternative approaches, and trade-offs** before locking in a plan.

package/src/orchestrator/prompts/bug-fix.prompt.md

@@ -3,6 +3,8 @@ description: 'Investigate and fix a reported bug with proper triage, root cause
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Fix Bug
 
 You are the Team Lead. Investigate and fix the bug described below. Bugs are real defects that affect users — treat them seriously with proper triage, tracking, and verification.

package/src/orchestrator/prompts/create-skill.prompt.md

@@ -3,6 +3,8 @@ description: 'Scaffold a new skill directory with proper frontmatter, structure,
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Create Skill
 
 Scaffold a new skill for the AI agent configuration. Skills encode domain-specific knowledge that agents load on demand.

package/src/orchestrator/prompts/generate-task-spec.prompt.md

@@ -3,6 +3,8 @@ description: 'Generate a valid opencastle.tasks.yml spec file for autonomous ove
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Generate Task Spec for Autonomous Run
 
 You are the Team Lead. The user wants to run `opencastle run` to execute a batch of tasks autonomously (e.g., overnight). Your job is to produce a valid `opencastle.tasks.yml` file they can feed to the CLI.

package/src/orchestrator/prompts/implement-feature.prompt.md

@@ -3,6 +3,8 @@ description: 'Instruct the Team Lead to implement a specific task from the post-
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Implement Roadmap Task
 
 You are the Team Lead. Implement the roadmap task described below following this strict workflow. The task comes from `docs/ROADMAP-POST-MVP.md`.

package/src/orchestrator/prompts/metrics-report.prompt.md

@@ -3,6 +3,8 @@ description: 'Collect and report metrics from agent logs, GitHub PRs, Linear iss
 agent: Researcher
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Metrics Report
 
 Generate a comprehensive metrics dashboard from all project data sources.

package/src/orchestrator/prompts/quick-refinement.prompt.md

@@ -3,6 +3,8 @@ description: 'Handle follow-up refinements after a roadmap task — bug fixes, U
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Follow-Up Refinement
 
 You are the Team Lead. Handle the follow-up refinement described below. This is a **post-task adjustment** — a bug fix, UI tweak, or polish item that came up after reviewing a completed roadmap task. It does NOT require Linear tracking.

package/src/orchestrator/prompts/resolve-pr-comments.prompt.md

@@ -3,6 +3,8 @@ description: 'Resolve GitHub PR review comments by reading them, grouping by fil
 agent: Team Lead
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Resolve PR Comments
 
 You are the Team Lead. A pull request has review comments that need to be resolved. Read the comments, group them by file, and delegate fixes efficiently.

package/src/orchestrator/skills/accessibility-standards/SKILL.md

@@ -3,6 +3,8 @@ name: accessibility-standards
 description: "WCAG 2.2 Level AA accessibility patterns for React/HTML/CSS. Use when creating or modifying UI components, forms, navigation, tables, images, or any user-facing elements. Covers keyboard navigation, screen reader semantics, low vision contrast, voice access, and inclusive language."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Accessibility Standards
 
 Code must conform to [WCAG 2.2 Level AA](https://www.w3.org/TR/WCAG22/). Go beyond minimal conformance wherever possible.

package/src/orchestrator/skills/agent-hooks/SKILL.md

@@ -3,6 +3,8 @@ name: agent-hooks
 description: "Lifecycle hooks for AI agent sessions — reusable actions that run at specific points (session start, session end, pre-delegation, post-delegation). Defines what to do at each lifecycle event so agents behave consistently."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Agent Lifecycle Hooks
 
 Hooks are **standardized actions** that agents execute at specific points during their lifecycle. They enforce consistency across sessions and prevent common oversights (missing lessons, forgotten checkpoints, untracked issues).

package/src/orchestrator/skills/agent-memory/SKILL.md

@@ -3,6 +3,8 @@ name: agent-memory
 description: "Agent expertise tracking and cross-session knowledge graph. Use when delegating tasks to track agent strengths/weaknesses, or when building context about file relationships and patterns."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Agent Memory Protocol
 
 ## Purpose

package/src/orchestrator/skills/api-patterns/SKILL.md

@@ -3,6 +3,8 @@ name: api-patterns
 description: "API design patterns for route handlers, Server Actions, Zod validation, and external API integration. Use when creating API routes, Server Actions, or integrating external services."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # API Patterns
 
 Generic API design patterns for Next.js App Router projects. For project-specific endpoints, actions, and external API inventory, see [api-config.md](../../customizations/stack/api-config.md).

package/src/orchestrator/skills/browser-testing/SKILL.md

@@ -3,6 +3,8 @@ name: browser-testing
 description: "Chrome DevTools MCP automation patterns for validating UI changes in real browsers. Use when performing E2E browser testing, validating visual changes, testing user interactions, or debugging UI issues with Chrome DevTools."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Browser Testing with Chrome DevTools MCP
 
 Generic browser testing methodology using Chrome DevTools MCP. For project-specific test app, selectors, suites, and breakpoint config, see [testing-config.md](../../customizations/stack/testing-config.md).
@@ -123,48 +125,34 @@ mcp_chrome-devtoo_list_console_messages()
 
 ### 6. Responsive Breakpoint Testing (MANDATORY)
 
-**Every UI change MUST be tested at all three breakpoints.** Do not test at desktop only — most layout bugs surface at mobile or tablet widths. See [testing-config.md](../../customizations/stack/testing-config.md) for project-specific breakpoint values.
+**Every UI change MUST be tested at all responsive breakpoints.** Do not test at desktop only — most layout bugs surface at smaller viewports. Define your breakpoints in your project's testing config (e.g., `testing-config.md`).
 
 #### How to Resize
 
 ```javascript
-// Mobile (iPhone-like)
-mcp_chrome-devtoo_resize_page({ width: 375, height: 812 })
-
-// Tablet (iPad-like)
-mcp_chrome-devtoo_resize_page({ width: 768, height: 1024 })
-
-// Desktop (standard)
-mcp_chrome-devtoo_resize_page({ width: 1440, height: 900 })
+// Example breakpoints — adjust to your project's testing config
+mcp_chrome-devtoo_resize_page({ width: 375, height: 812 })   // Mobile
+mcp_chrome-devtoo_resize_page({ width: 768, height: 1024 })  // Tablet
+mcp_chrome-devtoo_resize_page({ width: 1440, height: 900 })  // Desktop
 ```
 
 #### Per-Breakpoint Verification
 
-At **each** viewport size, verify:
+#### Per-Breakpoint Verification
 
-**Mobile (375 x 812):**
-- [ ] Sidebar/filter panel hidden — accessible via drawer/hamburger
-- [ ] Cards stack vertically, no horizontal overflow
-- [ ] Text truncates or wraps cleanly — no overflow or overlap
-- [ ] Touch targets >= 44px
-- [ ] Badges, tags, and pills wrap without horizontal scroll
-- [ ] Map/list toggle works
+At **each** breakpoint, check:
 
-**Tablet (768 x 1024):**
-- [ ] Layout adapts — may show 2-column grid or collapsed sidebar
-- [ ] Interactive elements have adequate spacing
+- [ ] Layout adapts correctly — no horizontal overflow
+- [ ] Text truncates or wraps cleanly — no overlap
+- [ ] Interactive elements have adequate spacing and touch targets
+- [ ] Navigation and panels collapse/expand as expected
 - [ ] Images and cards resize proportionally
 
-**Desktop (1440 x 900):**
-- [ ] Full layout visible — sidebar + content columns
-- [ ] Filter sidebar, content area, and any panels properly aligned
-- [ ] No excessive whitespace or stretched elements
-
 #### Responsive Testing Anti-Patterns
 
 | Anti-Pattern | Correct Approach |
 |---|---|
-| Testing only at desktop width | Test at all 3 breakpoints (Mobile -> Tablet -> Desktop) |
+| Testing only at desktop width | Test at all project-defined breakpoints |
 | Skipping resize because "it uses Tailwind" | Tailwind classes can be wrong — always verify visually |
 | Only checking layout, not interactions | Test filter drawers, dropdowns, and modals at each size |
 | Taking 3 screenshots (one per breakpoint) | Use `evaluate_script()` to check layout; save screenshots for failures |

package/src/orchestrator/skills/code-commenting/SKILL.md

@@ -3,6 +3,8 @@ name: code-commenting
 description: "Guidelines for writing self-explanatory code with minimal comments. Covers when to comment (WHY not WHAT), anti-patterns to avoid, annotation tags, and public API documentation. Use when writing or reviewing code comments."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Self-explanatory Code Commenting
 
 ## Core Principle

package/src/orchestrator/skills/contentful-cms/SKILL.md

@@ -3,6 +3,8 @@ name: contentful-cms
 description: "Contentful CMS development patterns, GraphQL/REST API usage, content modeling, and migration best practices. Use when working with Contentful content types, entries, assets, or the Management API."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Contentful CMS
 
 Generic Contentful CMS development methodology. For project-specific configuration, content types, and API keys, see [cms-config.md](../../customizations/stack/cms-config.md).

package/src/orchestrator/skills/context-map/SKILL.md

@@ -3,6 +3,8 @@ name: context-map
 description: "Generate a structured file impact map before making changes. Identifies all files that will be affected, their relationships, and cascade effects — improving file partitioning for parallel work and reducing unexpected side effects."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Skill: Context Map
 
 Generate a structured **file impact map** before any code changes begin. This map identifies all files that will be touched, their relationships, and cascade effects — directly improving the Team Lead's file partitioning for parallel agents.

package/src/orchestrator/skills/convex-database/SKILL.md

@@ -3,6 +3,8 @@ name: convex-database
 description: "Convex reactive database patterns, schema design, real-time queries, mutations, actions, and deployment best practices. Use when designing Convex schemas, writing queries/mutations, or managing the Convex backend."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Convex Database
 
 Generic Convex development methodology. For project-specific schema, functions, and deployment details, see [database-config.md](../../customizations/stack/database-config.md).

package/src/orchestrator/skills/data-engineering/SKILL.md

@@ -3,6 +3,8 @@ name: data-engineering
 description: "Data pipeline ETL workflows, web scraping with Puppeteer, NDJSON processing, and CMS data import. Use when building scrapers, processing data, running CLI tools, or importing to a CMS."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Data Engineering
 
 Generic data pipeline patterns and scraping methodology. For project-specific pipeline architecture, sources, CLI commands, and data status, see [data-pipeline-config.md](../../customizations/stack/data-pipeline-config.md).

package/src/orchestrator/skills/deployment-infrastructure/SKILL.md

@@ -3,6 +3,8 @@ name: deployment-infrastructure
 description: "Deployment architecture, environment variables, cron jobs, security headers, and caching patterns. Use when configuring deployments, managing environment variables, setting up cron jobs, or troubleshooting build/deployment issues."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Deployment Infrastructure
 
 All deployment configuration is project-specific. See [deployment-config.md](../../customizations/stack/deployment-config.md) for the full architecture, environment variables, cron jobs, caching headers, and key files.

package/src/orchestrator/skills/documentation-standards/SKILL.md

@@ -3,6 +3,8 @@ name: documentation-standards
 description: "Documentation templates, structure, and standards for project docs, roadmaps, ADRs, and known issues. Use when writing or updating documentation files."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Documentation Standards
 
 Generic documentation templates and writing standards. For project-specific directory structure and practices, see [docs-structure.md](../../customizations/project/docs-structure.md).

package/src/orchestrator/skills/fast-review/SKILL.md

@@ -1,3 +1,5 @@
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 ````skill
 ---
 name: fast-review

package/src/orchestrator/skills/frontend-design/SKILL.md

@@ -4,6 +4,8 @@ description: "Create distinctive, production-grade frontend interfaces with high
 license: Complete terms in LICENSE.txt
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
 
 The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.

package/src/orchestrator/skills/jira-management/SKILL.md

@@ -3,6 +3,8 @@ name: jira-management
 description: "Jira board conventions for tracking feature work — issue naming, labels, priorities, status workflow, and session continuity via Atlassian Rovo MCP. Use when decomposing features into tasks or resuming interrupted sessions."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Task Management with Jira
 
 Conventions for tracking feature work on Jira via the Atlassian Rovo MCP server. For project-specific project keys, workflow state IDs, and board configuration, see [jira-config.md](../../customizations/project/jira-config.md).

package/src/orchestrator/skills/memory-merger/SKILL.md

@@ -3,6 +3,8 @@ name: memory-merger
 description: "Protocol for graduating mature lessons from LESSONS-LEARNED.md into permanent instruction and skill files. Closes the self-improvement loop by codifying validated knowledge at the source level."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Skill: Memory Merger
 
 This skill automates the final step of the self-improvement cycle: promoting validated lessons into the instruction and skill files where they have structural, permanent impact.

package/src/orchestrator/skills/nextjs-patterns/SKILL.md

@@ -3,6 +3,8 @@ name: nextjs-patterns
 description: "Next.js App Router best practices for server/client components, routing, API routes, and project structure. Use when creating or modifying Next.js pages, layouts, route handlers, or Server Actions."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Next.js Patterns (2025)
 
 ## Project Structure

package/src/orchestrator/skills/nx-workspace/SKILL.md

@@ -3,6 +3,8 @@ name: nx-workspace
 description: "NX monorepo commands, conventions, code generation, and task running patterns. Use when running builds, tests, linting, code generation, or any development commands."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # NX Workspace
 
 ## Commands

package/src/orchestrator/skills/panel-majority-vote/SKILL.md

@@ -3,6 +3,8 @@ name: panel-majority-vote
 description: "Run 3 isolated reviewer sub-agents against the same question and decide PASS/BLOCK by majority vote (2/3 wins). Use when deterministic verification is insufficient."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Skill: Panel majority vote (3 reviewers)
 
 Use this skill when deterministic verification is unavailable and you need a panel to decide PASS/BLOCK for a single question against a declared artifact scope.

package/src/orchestrator/skills/panel-majority-vote/panel-report.template.md

@@ -1,3 +1,5 @@
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Panel Report
 
 ## Context

package/src/orchestrator/skills/performance-optimization/SKILL.md

@@ -3,6 +3,8 @@ name: performance-optimization
 description: "Frontend and backend performance optimization patterns including rendering, asset optimization, JavaScript performance, caching, profiling, and code review checklist. Use when optimizing components, reviewing code for performance, or analyzing bundle size and Core Web Vitals."
 ---
 
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the customizations/ directory instead. -->
+
 # Performance Optimization
 
 ## General Principles