npm - opencastle - Versions diffs - 0.20.0 → 0.21.0 - Mend

opencastle 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (146) hide show

package/src/orchestrator/agent-workflows/schema-changes.md CHANGED Viewed

@@ -1,10 +1,10 @@
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Workflow: Schema / CMS Changes
 Structured workflow for CMS schema modifications, query updates, and content model changes.
-> **Project config:** For CMS-specific paths, schema locations, and query library details, see the relevant CMS customization file in `customizations/stack/`.
+> **Project config:** For CMS-specific paths, schema locations, and query library details, see the relevant CMS customization file in `.opencastle/stack/`.
 ## Phases

package/src/orchestrator/agent-workflows/security-audit.md CHANGED Viewed

@@ -1,4 +1,4 @@
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Workflow: Security Audit
@@ -31,8 +31,8 @@ Follow the **Delivery Outcome** in `general.instructions.md` and the **Branch Ow
 ### Steps
 1. Define audit scope (full audit vs. targeted area)
-2. Read `.github/customizations/project.instructions.md` security sections
-3. Read `.github/customizations/KNOWN-ISSUES.md` for existing security items
+2. Read `.opencastle/project.instructions.md` security sections
+3. Read `.opencastle/KNOWN-ISSUES.md` for existing security items
 4. Check current CSP configuration in `next.config.js`
 5. Review auth flow (see database/auth customization for library paths)
 6. Map all API routes and Server Actions
@@ -130,7 +130,7 @@ Follow the **Delivery Outcome** in `general.instructions.md` and the **Branch Ow
 2. Create separate tracker issues for Medium/Low findings if not fixing now
 3. Run verification after each fix
 4. Re-run panel review if initial panel BLOCKed
-5. Update `.github/customizations/KNOWN-ISSUES.md` for any accepted risks
+5. Update `.opencastle/KNOWN-ISSUES.md` for any accepted risks
 ### Exit Criteria

package/src/orchestrator/agent-workflows/shared-delivery-phase.md CHANGED Viewed

@@ -1,4 +1,4 @@
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Shared Delivery Phase

package/src/orchestrator/agents/api-designer.agent.md CHANGED Viewed

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # API Designer
@@ -21,7 +21,7 @@ You are an API designer specializing in route architecture, endpoint conventions
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

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

@@ -6,7 +6,7 @@ tools: ['search/codebase', 'edit/editFiles', 'web/fetch', 'read/problems', 'sear
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Software Architect
@@ -33,7 +33,7 @@ When reviewing plans or proposals, **challenge assumptions before implementing**
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Architecture Decision Records (ADRs)

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Content Engineer
@@ -20,7 +20,7 @@ You are a content engineer specializing in CMS schema design, content queries, c
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

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

@@ -6,7 +6,7 @@ tools: ['search/codebase', 'edit/editFiles', 'web/fetch', 'search', 'read/proble
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Copywriter
@@ -21,7 +21,7 @@ You are a copywriter specializing in user-facing text for web applications — U
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Text Categories

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Data Expert
@@ -14,7 +14,7 @@ You are an expert in building ETL pipelines, web scrapers, data processors, and
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Critical Rules

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Database Engineer
@@ -21,7 +21,7 @@ You are a database engineer specializing in schema design, migrations, row-level
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'vsc
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Developer
@@ -14,7 +14,7 @@ You are a full-stack developer specializing in building pages, components, routi
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Mandatory Verification

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

@@ -6,7 +6,7 @@ tools: ["search/changes", "search/codebase", "edit/editFiles", "web/fetch", "vsc
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # DevOps Expert
@@ -20,7 +20,7 @@ You are a DevOps expert specializing in deployments, CI/CD pipelines, cron jobs,
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

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

@@ -6,7 +6,7 @@ tools: ['search/codebase', 'edit/editFiles', 'web/fetch', 'search', 'read/proble
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Documentation Writer
@@ -14,7 +14,7 @@ You are a technical documentation specialist. You maintain project documentation
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Critical Rules

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Performance Expert
@@ -20,7 +20,7 @@ You are an expert in frontend and backend performance optimization.
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Release Manager
@@ -21,7 +21,7 @@ You are a release manager responsible for pre-release verification, changelog ge
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Release Process

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

@@ -6,7 +6,7 @@ tools: ['search/codebase', 'search/textSearch', 'search/fileSearch', 'search/usa
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Researcher
@@ -14,7 +14,7 @@ You are a codebase exploration specialist. Your job is to **find information, ma
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Critical Rules
@@ -69,8 +69,8 @@ Given a feature request, answer:
 Given a bug report, answer:
 - Where does the relevant code live? (entry points → data flow)
 - What does the git history show? (recent changes that might have caused it)
-- Are there related known issues in `.github/customizations/KNOWN-ISSUES.md`?
-- Are there related lessons in `.github/customizations/LESSONS-LEARNED.md`?
+- Are there related known issues in `.opencastle/KNOWN-ISSUES.md`?
+- Are there related lessons in `.opencastle/LESSONS-LEARNED.md`?
 - What test coverage exists for the affected area?
 ### 3. Pattern Audit

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

@@ -6,7 +6,7 @@ user-invocable: false
 tools: [read/readFile, search/codebase, search/fileSearch, search/textSearch, search/listDirectory, read/problems]
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Reviewer

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

@@ -6,7 +6,7 @@ tools: ["search/changes", "search/codebase", "edit/editFiles", "web/fetch", "vsc
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Security Expert
@@ -24,7 +24,7 @@ You are a security expert specializing in authentication, authorization, securit
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # SEO Specialist
@@ -21,7 +21,7 @@ You are an SEO specialist focused on technical SEO implementation — meta tags,
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

package/src/orchestrator/agents/session-guard.agent.md CHANGED Viewed

@@ -30,9 +30,9 @@ Run ALL checks. Report each as ✅ or ❌.
 ### 1. Delegation Records
-For each delegation in the session summary, verify a matching record exists in `.github/customizations/logs/events.ndjson` (type=delegation).
+For each delegation in the session summary, verify a matching record exists in `.opencastle/logs/events.ndjson` (type=delegation).
-**How:** `grep '"type":"delegation"' .github/customizations/logs/events.ndjson | tail -20` and match agent + task against the summary.
+**How:** `grep '"type":"delegation"' .opencastle/logs/events.ndjson | tail -20` and match agent + task against the summary.
 **Fix:** Load the **observability-logging** skill and run the delegation record command (includes a verify step).
@@ -40,29 +40,29 @@ Also verify each delegation record includes `session_id` (branch name). Records
 ### 2. Session Record
-Verify a session record exists in `.github/customizations/logs/events.ndjson` (type=session) for the current task.
+Verify a session record exists in `.opencastle/logs/events.ndjson` (type=session) for the current task.
-**How:** `grep '"type":"session"' .github/customizations/logs/events.ndjson | tail -5` and match task description.
+**How:** `grep '"type":"session"' .opencastle/logs/events.ndjson | tail -5` and match task description.
 **Fix:** Load the **observability-logging** skill and run the session record command (includes a verify step).
 ### 3. Lessons Captured
-If the session summary indicates retries occurred, verify new entries exist in `.github/customizations/LESSONS-LEARNED.md`.
+If the session summary indicates retries occurred, verify new entries exist in `.opencastle/LESSONS-LEARNED.md`.
-**How:** `grep -c "^### LES-" .github/customizations/LESSONS-LEARNED.md` — compare count with expected.
+**How:** `grep -c "^### LES-" .opencastle/LESSONS-LEARNED.md` — compare count with expected.
 ### 4. Discovered Issues Tracked
 If the session summary lists discovered issues, verify they appear in:
-- `.github/customizations/KNOWN-ISSUES.md`, OR
+- `.opencastle/KNOWN-ISSUES.md`, OR
 - A task tracker ticket referenced in the summary
 ### 5. Review & Panel Records
-If the session summary mentions fast reviews or panel reviews, verify matching records exist in `.github/customizations/logs/events.ndjson` (type=review and/or type=panel).
+If the session summary mentions fast reviews or panel reviews, verify matching records exist in `.opencastle/logs/events.ndjson` (type=review and/or type=panel).
-**How:** `grep '"type":"review"' .github/customizations/logs/events.ndjson | tail -10` and/or `grep '"type":"panel"' .github/customizations/logs/events.ndjson | tail -5`.
+**How:** `grep '"type":"review"' .opencastle/logs/events.ndjson | tail -10` and/or `grep '"type":"panel"' .opencastle/logs/events.ndjson | tail -5`.
 **Fix:** Load the **observability-logging** skill and run the review/panel record command as applicable (includes a verify step).
@@ -82,7 +82,7 @@ If the session involved running a convoy (check for `.opencastle/convoy.db` or r
 **Verify convoy tasks logged:**
 - Each completed convoy task should have a corresponding event in the NDJSON log
-- Check: `grep '"type":"session"' .github/customizations/logs/events.ndjson | tail -10`
+- Check: `grep '"type":"session"' .opencastle/logs/events.ndjson | tail -10`
 **Fix:** If convoy export is missing, the engine should have auto-exported. Manual export: run `opencastle run --status` to verify the convoy completed.

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

@@ -28,7 +28,7 @@ handoffs:
     prompt: 'Use the resolve-pr-comments prompt to resolve the GitHub PR review comments on this PR:'
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Team Lead (OpenCastle)
@@ -109,7 +109,7 @@ When calling `runSubagent`, always specify which custom agent to use by name: *"
 **After each sub-agent returns**, log the delegation record before doing anything else (before review, before verification). This is a **⛔ hard gate** — do NOT proceed to review or any other action until the delegation is logged. Use the **observability-logging** skill's delegation record command (`--mechanism sub-agent`).
-> **`model` and `tier` must come from the agent registry** — not the Team Lead's own model. Look up the agent in [agent-registry.md](../customizations/agents/agent-registry.md) and use their assigned model and tier. For example, delegating to Developer → `"model":"claude-sonnet-4-6","tier":"quality"`, not the Team Lead's `claude-opus-4-6`.
+> **`model` and `tier` must come from the agent registry** — not the Team Lead's own model. Look up the agent in [agent-registry.md](../.opencastle/agents/agent-registry.md) and use their assigned model and tier. For example, delegating to Developer → `"model":"claude-sonnet-4-6","tier":"quality"`, not the Team Lead's `claude-opus-4-6`.
 ### Background Agents — Delegate Session
@@ -264,7 +264,7 @@ See [shared-delivery-phase.md](../agent-workflows/shared-delivery-phase.md) for
 1. Verify all issues Done or Cancelled
 2. Final build/lint/test across affected projects
-3. Update roadmap (`.github/customizations/project/roadmap.md`)
+3. Update roadmap (`.opencastle/project/roadmap.md`)
 4. Commit to feature branch with issue IDs — Team Lead creates the branch, sub-agents work on it directly, background agents use isolated worktrees
 5. Push and open PR (`GH_PAGER=cat gh pr create ...`). **Do NOT merge.**
 6. Link PR in tracker issue

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Testing Expert
@@ -14,7 +14,7 @@ You are an expert tester who validates UI changes using browser automation and w
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Context Management

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

@@ -6,7 +6,7 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'vsc
 user-invocable: false
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # UI/UX Expert
@@ -20,7 +20,7 @@ You are an expert UI/UX developer specializing in building accessible, visually
 ## Skills
-Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
+Resolve all skills (slots and direct) via [skill-matrix.json](.opencastle/agents/skill-matrix.json).
 ## Guidelines

package/src/orchestrator/copilot-instructions.md CHANGED Viewed

@@ -1,4 +1,4 @@
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # Copilot Instructions

package/src/orchestrator/customizations/AGENT-PERFORMANCE.md CHANGED Viewed

@@ -6,44 +6,44 @@ Tracks agent success rates across panel reviews and delegated tasks to inform mo
 ## Data Sources
 Performance data is collected automatically via NDJSON session logs:
-- **All events:** `.github/customizations/logs/events.ndjson` — unified log for all event types (sessions, delegations, reviews, panels, disputes), appended via `opencastle log`
+- **All events:** `.opencastle/logs/events.ndjson` — unified log for all event types (sessions, delegations, reviews, panels, disputes), appended via `opencastle log`
 - **Dashboard:** Run `npx opencastle dashboard` to visualize agent performance
 ## Quick Queries
 ```bash
 # Sessions per agent
-jq -r 'select(.type == "session") | .agent' .github/customizations/logs/events.ndjson | sort | uniq -c | sort -rn
+jq -r 'select(.type == "session") | .agent' .opencastle/logs/events.ndjson | sort | uniq -c | sort -rn
 # Success rate by agent
-jq -r 'select(.type == "session") | [.agent, .outcome] | @tsv' .github/customizations/logs/events.ndjson | sort | uniq -c
+jq -r 'select(.type == "session") | [.agent, .outcome] | @tsv' .opencastle/logs/events.ndjson | sort | uniq -c
 # Delegation tier distribution
-jq -r 'select(.type == "delegation") | .tier' .github/customizations/logs/events.ndjson | sort | uniq -c
+jq -r 'select(.type == "delegation") | .tier' .opencastle/logs/events.ndjson | sort | uniq -c
 # Failed delegations
-jq 'select(.type == "delegation" and .outcome == "failed")' .github/customizations/logs/events.ndjson
+jq 'select(.type == "delegation" and .outcome == "failed")' .opencastle/logs/events.ndjson
 ```
 ## Panel Review Performance
-Panel review data is collected automatically in `.github/customizations/logs/events.ndjson` with `type: "panel"` (appended by the panel runner after each review — see step 7 in the panel majority vote skill).
+Panel review data is collected automatically in `.opencastle/logs/events.ndjson` with `type: "panel"` (appended by the panel runner after each review — see step 7 in the panel majority vote skill).
 ```bash
 # Total panel reviews
-jq 'select(.type == "panel")' .github/customizations/logs/events.ndjson | wc -l
+jq 'select(.type == "panel")' .opencastle/logs/events.ndjson | wc -l
 # Pass vs block rate
-jq -r 'select(.type == "panel") | .verdict' .github/customizations/logs/events.ndjson | sort | uniq -c
+jq -r 'select(.type == "panel") | .verdict' .opencastle/logs/events.ndjson | sort | uniq -c
 # Reviews by panel key
-jq -r 'select(.type == "panel") | .panel_key' .github/customizations/logs/events.ndjson | sort | uniq -c | sort -rn
+jq -r 'select(.type == "panel") | .panel_key' .opencastle/logs/events.ndjson | sort | uniq -c | sort -rn
 # Reviews that required retries (attempt > 1)
-jq 'select(.type == "panel" and .attempt > 1)' .github/customizations/logs/events.ndjson
+jq 'select(.type == "panel" and .attempt > 1)' .opencastle/logs/events.ndjson
 # Average SHOULD-FIX items per review
-jq -s '[.[] | select(.type == "panel")] | if length > 0 then (map(.should_fix) | add) / length else 0 end' .github/customizations/logs/events.ndjson
+jq -s '[.[] | select(.type == "panel")] | if length > 0 then (map(.should_fix) | add) / length else 0 end' .opencastle/logs/events.ndjson
 ```
 ## Usage

package/src/orchestrator/customizations/DISPUTES.md CHANGED Viewed

@@ -85,8 +85,8 @@ Which option the Team Lead recommends and why. Include specific next steps:
 #### Artifacts
 Links to evidence for human review:
-- Panel report: `.github/customizations/logs/panel/[panel-key].md`
-- Review log entries: `.github/customizations/logs/events.ndjson` (filter by `type: "review"` and issue)
+- Panel report: `.opencastle/logs/panel/[panel-key].md`
+- Review log entries: `.opencastle/logs/events.ndjson` (filter by `type: "review"` and issue)
 - Changed files: [list of files in the last attempt]
 - DLQ entry (if any): `DLQ-XXX`
 ```

package/src/orchestrator/customizations/README.md CHANGED Viewed

@@ -6,7 +6,7 @@ Project-specific configuration for the AI agent framework. Everything in this fo
 Skills and instructions contain generic methodology (how to write migrations, how to test in a browser, how to run a panel review). This folder holds the concrete values those skills operate on — project IDs, table schemas, team UUIDs, endpoint inventories, and similar configuration that changes per project.
-Skills reference these files with relative links like `../../customizations/stack/api-config.md`, so agents automatically load project context when they load a skill.
+Skills reference these files with relative links like `../../.opencastle/stack/api-config.md`, so agents automatically load project context when they load a skill.
 ## Contents

package/src/orchestrator/customizations/logs/README.md CHANGED Viewed

@@ -175,7 +175,7 @@ Run `opencastle log --help` for full options.
   "attempt": 1,
   "tracker_issue": "PRJ-57",
   "artifacts_count": 14,
-  "report_path": ".github/customizations/logs/panel/instruction-refactoring.md"
+  "report_path": ".opencastle/logs/panel/instruction-refactoring.md"
 }
 ```

package/src/orchestrator/customizations/project/docs-structure.md CHANGED Viewed

@@ -4,19 +4,19 @@
 Project-specific documentation layout referenced by the `documentation-standards` skill.
-Documentation files live in the `.github/customizations/` directory alongside other project-specific configuration. Key documentation files:
+Documentation files live in the `.opencastle/` directory alongside other project-specific configuration. Key documentation files:
-- `.github/customizations/KNOWN-ISSUES.md` — Tracked issues, limitations, and accepted risks
-- `.github/customizations/project/roadmap.md` — Project roadmap and feature status
-- `.github/customizations/project/decisions.md` — Architecture Decision Records
-- `.github/customizations/LESSONS-LEARNED.md` — Agent knowledge base of retries and workarounds
+- `.opencastle/KNOWN-ISSUES.md` — Tracked issues, limitations, and accepted risks
+- `.opencastle/project/roadmap.md` — Project roadmap and feature status
+- `.opencastle/project/decisions.md` — Architecture Decision Records
+- `.opencastle/LESSONS-LEARNED.md` — Agent knowledge base of retries and workarounds
 ## Directory Tree
 <!-- Map your project's documentation directory here if one exists -->
 ```
-.github/customizations/
+.opencastle/
 ├── KNOWN-ISSUES.md            — Tracked issues and limitations
 ├── LESSONS-LEARNED.md         — Agent knowledge base
 └── project/

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

@@ -3,7 +3,7 @@ description: 'AI assistant optimization patterns for efficient context usage and
 applyTo: '**'
 ---
-<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .github/customizations/ directory instead. -->
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
 # AI Optimization