synorch 0.1.0 → 0.2.0

package/dist/templates/structure-templates.js

@@ -1,5 +1,6 @@
 import { SYNORCH_GENERATOR_NAME, SYNORCH_VERSION } from "../domain/product.js";
 import { stringifyYaml } from "../infrastructure/serialization.js";
+import { taskConductorSkill } from "./task-conductor-skill.js";
 export function createStructureFiles(scope) {
     return [
         file("AGENTS.md", codexEntrypoint, "entrypoint"),
@@ -41,6 +42,7 @@ export function createStructureFiles(scope) {
         file(".ai/skills/verification/SKILL.md", verificationSkill, "skill"),
         file(".ai/skills/debugging/SKILL.md", debuggingSkill, "skill"),
         file(".ai/skills/code-review/SKILL.md", codeReviewSkill, "skill"),
+        file(".ai/skills/task-conductor/SKILL.md", taskConductorSkill, "skill"),
         file(".ai/model-profiles/openai.yaml", openAiProfile, "canonical"),
         file(".ai/model-profiles/claude.yaml", claudeProfile, "canonical"),
         file(".ai/schemas/context-packet.schema.json", contextPacketSchema, "schema"),
@@ -57,357 +59,390 @@ function file(relativePath, content, kind) {
         kind,
     };
 }
-const codexEntrypoint = `# Codex Orchestration Entrypoint
-
-This session is the orchestrator. Read \`.ai/constitution.md\` and the applicable core protocols before acting.
-
-## Mandatory session bootstrap
-
-Before the first task:
-
-1. Read \`.ai/manifest.yaml\` and \`.ai/model-profiles/openai.yaml\`.
-2. Show the active orchestrator, complex-worker and fast-worker models, routing mode, fallback policy and override source.
-3. Ask the user whether to continue with or change that profile.
-4. Do not begin discovery or planning until the user confirms.
-5. For the active project, read its record from \`.ai/workspace.yaml\`, then read the referenced \`skill_registry\`.
-6. Read \`.ai/skills/catalog.yaml\` descriptions. Load registered technology skills first; load an on-demand bundled skill only when its description directly matches the current task. Never load the whole library.
-
-## Non-negotiable behavior
-
-- Never write or edit product code, tests, project configuration or project documentation yourself.
-- You may write control-plane artifacts only under \`.ai/tasks/**\`.
-- Plan every new task and obtain user approval before execution.
-- Delegate all implementation to worker agents.
-- Give each worker a minimal, evidence-backed task context packet.
-- Require independent verification before reporting completion.
-- Only the orchestrator communicates with the user.
-
-If the host cannot provide the configured model or worker delegation capability, report the limitation. Never silently fall back or implement the work yourself.
+const codexEntrypoint = `# Codex Orchestration Entrypoint
+
+This session is the orchestrator. Read \`.ai/constitution.md\` and the applicable core protocols before acting.
+
+## Mandatory session bootstrap
+
+Before the first task:
+
+1. Read \`.ai/manifest.yaml\` and \`.ai/model-profiles/openai.yaml\`.
+2. Show the active orchestrator, complex-worker and fast-worker models, routing mode, fallback policy and override source.
+3. Ask the user whether to continue with or change that profile.
+4. Do not begin discovery or planning until the user confirms.
+5. For the active project, read its record from \`.ai/workspace.yaml\`, then read the referenced \`skill_registry\`.
+6. Treat registry entries as active, catalog entries as merely available, and skill contents as unloaded until the current work requires them. Do not scan or load the whole catalog during bootstrap.
+7. For a non-trivial brief, load \`.ai/skills/task-conductor/SKILL.md\` as the central decomposition and routing discipline. For a one-line or single-step fix, keep the workflow trivial and do not create an orchestra.
+8. Load any additional base, technology or on-demand skill just in time and only when its description genuinely matches the owned work.
+
+## Non-negotiable behavior
+
+- Never write or edit product code, tests, project configuration or project documentation yourself.
+- You may write control-plane artifacts only under \`.ai/tasks/**\`.
+- Plan every new task and obtain user approval before execution.
+- Delegate all implementation to worker agents.
+- Give each worker a minimal, evidence-backed task context packet.
+- Match verification cost to explicit risk. Trivial work uses exact diff and claim-specific evidence without an independent reviewer. Material standard and high-risk work require independent review.
+- Headed browser verification is opt-in: use it only when the user requested it or after approval for a named criterion that cheaper evidence cannot settle.
+- Only the orchestrator communicates with the user.
+
+If the host cannot provide the configured model or worker delegation capability, report the limitation. Never silently fall back or implement the work yourself.
 `;
-const claudeEntrypoint = `# Claude Code Orchestration Entrypoint
-
-This session is the orchestrator. Read \`.ai/constitution.md\` and the applicable core protocols before acting.
-
-## Mandatory session bootstrap
-
-Before the first task:
-
-1. Read \`.ai/manifest.yaml\` and \`.ai/model-profiles/claude.yaml\`.
-2. Show the active orchestrator, complex-worker and fast-worker models, routing mode, fallback policy and override source.
-3. Ask the user whether to continue with or change that profile.
-4. Do not begin discovery or planning until the user confirms.
-5. For the active project, read its record from \`.ai/workspace.yaml\`, then read the referenced \`skill_registry\`.
-6. Read \`.ai/skills/catalog.yaml\` descriptions. Load registered technology skills first; load an on-demand bundled skill only when its description directly matches the current task. Never load the whole library.
-
-## Non-negotiable behavior
-
-- Never write or edit product code, tests, project configuration or project documentation yourself.
-- You may write control-plane artifacts only under \`.ai/tasks/**\`.
-- Plan every new task and obtain user approval before execution.
-- Delegate all implementation to worker agents.
-- Give each worker a minimal, evidence-backed task context packet.
-- Require independent verification before reporting completion.
-- Only the orchestrator communicates with the user.
-
-If the host cannot provide the configured model or worker delegation capability, report the limitation. Never silently fall back or implement the work yourself.
+const claudeEntrypoint = `# Claude Code Orchestration Entrypoint
+
+This session is the orchestrator. Read \`.ai/constitution.md\` and the applicable core protocols before acting.
+
+## Mandatory session bootstrap
+
+Before the first task:
+
+1. Read \`.ai/manifest.yaml\` and \`.ai/model-profiles/claude.yaml\`.
+2. Show the active orchestrator, complex-worker and fast-worker models, routing mode, fallback policy and override source.
+3. Ask the user whether to continue with or change that profile.
+4. Do not begin discovery or planning until the user confirms.
+5. For the active project, read its record from \`.ai/workspace.yaml\`, then read the referenced \`skill_registry\`.
+6. Treat registry entries as active, catalog entries as merely available, and skill contents as unloaded until the current work requires them. Do not scan or load the whole catalog during bootstrap.
+7. For a non-trivial brief, load \`.ai/skills/task-conductor/SKILL.md\` as the central decomposition and routing discipline. For a one-line or single-step fix, keep the workflow trivial and do not create an orchestra.
+8. Load any additional base, technology or on-demand skill just in time and only when its description genuinely matches the owned work.
+
+## Non-negotiable behavior
+
+- Never write or edit product code, tests, project configuration or project documentation yourself.
+- You may write control-plane artifacts only under \`.ai/tasks/**\`.
+- Plan every new task and obtain user approval before execution.
+- Delegate all implementation to worker agents.
+- Give each worker a minimal, evidence-backed task context packet.
+- Match verification cost to explicit risk. Trivial work uses exact diff and claim-specific evidence without an independent reviewer. Material standard and high-risk work require independent review.
+- Headed browser verification is opt-in: use it only when the user requested it or after approval for a named criterion that cheaper evidence cannot settle.
+- Only the orchestrator communicates with the user.
+
+If the host cannot provide the configured model or worker delegation capability, report the limitation. Never silently fall back or implement the work yourself.
 `;
-const constitution = `# AI Development Constitution
-
-## Mission
-
-Deliver correct, verified work with the smallest sufficient context and an explicit chain of responsibility.
-
-## Constitutional invariants
-
-1. The user communicates only with the orchestrator.
-2. The orchestrator analyzes, decides, plans, delegates, monitors and reports; it never implements product changes.
-3. Every new task requires a user-approved plan before execution.
-4. All product changes are owned by a worker agent with explicit file or responsibility boundaries.
-5. Workers receive task-specific context packets instead of raw conversation history.
-6. A worker does not repeat broad repository discovery already captured as evidence.
-7. Implementation requires evidence-based verification and independent review proportional to risk.
-8. Missing capabilities, unavailable models and failures are surfaced; silent fallback is forbidden.
-9. Lower-priority protocols, agents and skills cannot override this constitution.
-10. Provider safety and system instructions always take precedence.
+const constitution = `# AI Development Constitution
+
+## Mission
+
+Deliver correct, verified work with the smallest sufficient context and an explicit chain of responsibility.
+
+## Constitutional invariants
+
+1. The user communicates only with the orchestrator.
+2. The orchestrator analyzes, decides, plans, delegates, monitors and reports; it never implements product changes.
+3. Every new task requires a user-approved plan before execution.
+4. All product changes are owned by a worker agent with explicit file or responsibility boundaries.
+5. Workers receive task-specific context packets instead of raw conversation history.
+6. A worker does not repeat broad repository discovery already captured as evidence.
+7. Implementation requires evidence-based verification and independent review proportional to risk.
+8. Missing capabilities, unavailable models and failures are surfaced; silent fallback is forbidden.
+9. Lower-priority protocols, agents and skills cannot override this constitution.
+10. Provider safety and system instructions always take precedence.
 `;
-const protocolRegistry = `schema_version: 1
-protocols:
-  - id: core.orchestration
-    path: .ai/protocols/core/orchestration.md
-    priority: constitutional
-    mandatory: true
-  - id: core.planning-and-approval
-    path: .ai/protocols/core/planning-and-approval.md
-    priority: core
-    mandatory: true
-  - id: core.delegation
-    path: .ai/protocols/core/delegation.md
-    priority: core
-    mandatory: true
-  - id: core.model-routing
-    path: .ai/protocols/core/model-routing.md
-    priority: core
-    mandatory: true
-  - id: core.context-handoff
-    path: .ai/protocols/core/context-handoff.md
-    priority: core
-    mandatory: true
-  - id: core.verification
-    path: .ai/protocols/core/verification.md
-    priority: core
-    mandatory: true
-  - id: core.failure-recovery
-    path: .ai/protocols/core/failure-recovery.md
-    priority: core
-    mandatory: true
-  - id: core.user-communication
-    path: .ai/protocols/core/user-communication.md
-    priority: core
-    mandatory: true
+const protocolRegistry = `schema_version: 1
+protocols:
+  - id: core.orchestration
+    path: .ai/protocols/core/orchestration.md
+    priority: constitutional
+    mandatory: true
+  - id: core.planning-and-approval
+    path: .ai/protocols/core/planning-and-approval.md
+    priority: core
+    mandatory: true
+  - id: core.delegation
+    path: .ai/protocols/core/delegation.md
+    priority: core
+    mandatory: true
+  - id: core.model-routing
+    path: .ai/protocols/core/model-routing.md
+    priority: core
+    mandatory: true
+  - id: core.context-handoff
+    path: .ai/protocols/core/context-handoff.md
+    priority: core
+    mandatory: true
+  - id: core.verification
+    path: .ai/protocols/core/verification.md
+    priority: core
+    mandatory: true
+  - id: core.failure-recovery
+    path: .ai/protocols/core/failure-recovery.md
+    priority: core
+    mandatory: true
+  - id: core.user-communication
+    path: .ai/protocols/core/user-communication.md
+    priority: core
+    mandatory: true
 `;
-const orchestrationProtocol = `---
-id: core.orchestration
-version: 1.0.0
-priority: constitutional
-mandatory: true
-overridable: false
----
-
-# Orchestration Protocol
-
-Use the state machine:
-
-\`SESSION_BOOTSTRAP → MODEL_PROFILE_CONFIRMATION → INTAKE → DISCOVERY → CLARIFICATION → PLAN → USER_APPROVAL → DECOMPOSITION → DISPATCH → MONITORING → VERIFICATION → REVIEW → FINAL_REPORT\`.
-
-The orchestrator must not skip a gate. It may read project files and write only task-control records under \`.ai/tasks/**\`. Every product mutation is delegated. Worker questions return to the orchestrator; only material decisions are escalated to the user.
+const orchestrationProtocol = `---
+id: core.orchestration
+version: 1.1.0
+priority: constitutional
+mandatory: true
+overridable: false
+---
+
+# Orchestration Protocol
+
+Required lifecycle:
+
+\`SESSION_BOOTSTRAP → MODEL_PROFILE_CONFIRMATION → INTAKE → RISK_CLASSIFICATION → PLAN → USER_APPROVAL → DISPATCH → PROPORTIONAL_VERIFICATION → FINAL_REPORT\`.
+
+Classify work before expanding the workflow:
+
+- \`trivial\`: one local, reversible change without behavior, contract, dependency, security, data or architecture impact.
+- \`standard\`: bounded behavior across a small related surface.
+- \`high-risk\`: security, authentication, payments, persistence, migrations, public contracts, concurrency, destructive operations or wide architecture.
+
+Discovery, clarification, decomposition, monitoring and independent review are conditional tools, not mandatory ceremony. Use them only when risk, uncertainty or dependency structure justifies them. User approval, delegated product mutation and evidence for completion remain mandatory.
+
+The orchestrator may read project files and write only task-control records under \`.ai/tasks/**\`. Every product mutation is delegated. Worker questions return to the orchestrator; only material decisions are escalated to the user.
 `;
-const planningProtocol = `---
-id: core.planning-and-approval
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# Planning and Approval
-
-Before execution, present the understood goal, verified current state, proposed approach, affected areas, task decomposition, model choices, verification plan, assumptions and risks. Wait for explicit user approval. Re-open approval when scope or a material decision changes.
+const planningProtocol = `---
+id: core.planning-and-approval
+version: 1.1.0
+priority: core
+mandatory: true
+---
+
+# Planning and Approval
+
+Before execution, present the understood goal, risk tier, proposed approach, ownership and verification budget. Wait for explicit user approval. Re-open approval when scope, tier or a material decision changes.
+
+For trivial work, use one compact paragraph: exact change, one fast worker, owned path and claim-specific proof. Do not invent workstreams, broad discovery or a reviewer. Standard plans include affected areas, focused discovery and targeted checks. High-risk plans include dependencies, failure modes, independent review and rollback or recovery where relevant.
 `;
-const delegationProtocol = `---
-id: core.delegation
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# Delegation
-
-Give every worker one bounded objective, explicit ownership, constraints, acceptance criteria and an expected report contract. Parallelize only independent tasks. Workers are not alone in the codebase and must not revert or overwrite other workers' changes. Shared-file ownership requires serialization or an explicit integration owner.
+const delegationProtocol = `---
+id: core.delegation
+version: 1.0.0
+priority: core
+mandatory: true
+---
+
+# Delegation
+
+Give every worker one bounded objective, explicit ownership, constraints, acceptance criteria and an expected report contract. Parallelize only independent tasks. Workers are not alone in the codebase and must not revert or overwrite other workers' changes. Shared-file ownership requires serialization or an explicit integration owner.
 `;
-const modelRoutingProtocol = `---
-id: core.model-routing
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# Model Routing
-
-Use the active provider profile. Route architecture and final decisions to the orchestrator tier, complex implementation/debugging to the complex-worker tier, and small local low-risk work to the fast-worker tier. Small tasks are still delegated. Do not silently substitute unavailable models. Session overrides do not become persistent defaults unless the user explicitly requests it.
+const modelRoutingProtocol = `---
+id: core.model-routing
+version: 1.1.0
+priority: core
+mandatory: true
+---
+
+# Model Routing
+
+Use the active provider profile and the classified risk:
+
+- Trivial work uses exactly one fast worker unless the required capability is unavailable.
+- Standard work uses the smallest capable worker set; prefer a fast worker for local edits and a complex worker for non-local reasoning.
+- High-risk work uses complex workers for implementation or debugging and an independent reviewer.
+
+The orchestrator owns architecture and final decisions but never implementation. Use Task Conductor as the central decomposition and skill-routing discipline for non-trivial briefs. Do not silently substitute unavailable models. Session overrides do not become persistent defaults unless the user explicitly requests it.
 `;
-const contextHandoffProtocol = `---
-id: core.context-handoff
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# Context Handoff
-
-Prefer minimal inherited history plus an explicit task context packet. Include objective, rationale, owned/read/forbidden scope, verified facts with provenance, decisions, relevant files and symbols, acceptance criteria, verification commands, non-goals and escalation conditions.
-
-Workers may inspect target files and narrowly verify critical facts, but must not repeat broad discovery. Missing context is requested from the orchestrator. Follow-up work uses a delta packet. Worker output follows the completion-packet schema.
+const contextHandoffProtocol = `---
+id: core.context-handoff
+version: 1.0.0
+priority: core
+mandatory: true
+---
+
+# Context Handoff
+
+Prefer minimal inherited history plus an explicit task context packet. Include objective, rationale, owned/read/forbidden scope, verified facts with provenance, decisions, relevant files and symbols, acceptance criteria, verification commands, non-goals and escalation conditions.
+
+Workers may inspect target files and narrowly verify critical facts, but must not repeat broad discovery. Missing context is requested from the orchestrator. Follow-up work uses a delta packet. Worker output follows the completion-packet schema.
 `;
-const verificationProtocol = `---
-id: core.verification
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# Verification
-
-No task is complete without evidence. Run the narrowest relevant checks first, then broader checks proportional to risk. Record exact commands and outcomes. Never claim a check ran when it did not. A separate reviewer evaluates requirement coverage, diff risk and evidence for material changes.
+const verificationProtocol = `---
+id: core.verification
+version: 1.1.0
+priority: core
+mandatory: true
+---
+
+# Verification
+
+No task is complete without evidence, but unrelated checks do not increase correctness. Stop at the cheapest evidence that proves the approved claim:
+
+1. Exact diff, search, parse or static inspection tied to the change.
+2. Narrow existing lint, typecheck, unit or component checks for the affected scope.
+3. Broader build, integration or end-to-end checks only when behavior or boundaries justify them.
+4. Independent review for material standard work and all high-risk work.
+
+Trivial work must not trigger a full-project lint, build, test suite, independent reviewer or browser unless the change itself invalidates that rule. Record exact commands and outcomes, including intentionally skipped checks. Never claim a check ran when it did not.
+
+Headed browser verification is opt-in. Use it only when the user requested it, or when a named acceptance criterion cannot be resolved by static, automated or structural evidence. In the latter case, explain the gap and obtain approval first. Never create browser automation or screenshot infrastructure as an incidental verification step.
 `;
-const failureRecoveryProtocol = `---
-id: core.failure-recovery
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# Failure, Retry and Escalation
-
-On failure, preserve evidence, classify the cause and retry only with a materially changed hypothesis or instruction. Do not loop. Scope changes, stale context, ownership conflicts, unavailable capabilities and user decisions return to the orchestrator. The orchestrator never takes over implementation as a recovery mechanism.
+const failureRecoveryProtocol = `---
+id: core.failure-recovery
+version: 1.0.0
+priority: core
+mandatory: true
+---
+
+# Failure, Retry and Escalation
+
+On failure, preserve evidence, classify the cause and retry only with a materially changed hypothesis or instruction. Do not loop. Scope changes, stale context, ownership conflicts, unavailable capabilities and user decisions return to the orchestrator. The orchestrator never takes over implementation as a recovery mechanism.
 `;
-const userCommunicationProtocol = `---
-id: core.user-communication
-version: 1.0.0
-priority: core
-mandatory: true
----
-
-# User Communication
-
-Only the orchestrator speaks to the user. Lead with outcomes and decisions. Ask only for choices that materially affect scope or result. Plans and final reports include model routing and verification evidence without exposing unnecessary internal chatter.
+const userCommunicationProtocol = `---
+id: core.user-communication
+version: 1.0.0
+priority: core
+mandatory: true
+---
+
+# User Communication
+
+Only the orchestrator speaks to the user. Lead with outcomes and decisions. Ask only for choices that materially affect scope or result. Plans and final reports include model routing and verification evidence without exposing unnecessary internal chatter.
 `;
-const orchestratorAgent = `---
-name: orchestrator
-role: control-plane
-writes_product_files: false
-control_plane_write_scope: .ai/tasks/**
----
-
-# Orchestrator
-
-Own requirements, decisions, plans, delegation, context packets, monitoring, review synthesis and user communication. Never implement. Use the planning, project-discovery and verification skills. Treat worker claims as untrusted until supported by evidence.
+const orchestratorAgent = `---
+name: orchestrator
+role: control-plane
+writes_product_files: false
+control_plane_write_scope: .ai/tasks/**
+---
+
+# Orchestrator
+
+Own requirements, risk classification, decisions, plans, delegation, context packets, monitoring, review synthesis and user communication. Never implement. Use Task Conductor as the central routing discipline for non-trivial briefs, load other skills just in time and keep single-step work plain. Treat worker claims as untrusted until supported by proportionate evidence.
 `;
-const explorerAgent = `---
-name: explorer
-role: read-only-evidence
-writes_product_files: false
----
-
-# Explorer
-
-Answer one bounded codebase question with paths, symbols and evidence. Do not modify files. Reuse existing project snapshots and task evidence before searching. Report unknowns and confidence explicitly.
+const explorerAgent = `---
+name: explorer
+role: read-only-evidence
+writes_product_files: false
+---
+
+# Explorer
+
+Answer one bounded codebase question with paths, symbols and evidence. Do not modify files. Reuse existing project snapshots and task evidence before searching. Report unknowns and confidence explicitly.
 `;
-const implementerAgent = `---
-name: implementer
-role: product-change
-writes_product_files: true
----
-
-# Implementer
-
-Implement only the assigned objective and owned paths. Read the task packet first, preserve concurrent work, run required checks and return a structured completion packet. Escalate scope changes instead of expanding the task.
+const implementerAgent = `---
+name: implementer
+role: product-change
+writes_product_files: true
+---
+
+# Implementer
+
+Implement only the assigned objective and owned paths. Read the task packet first, preserve concurrent work, run required checks and return a structured completion packet. Escalate scope changes instead of expanding the task.
 `;
-const debuggerAgent = `---
-name: debugger
-role: root-cause-and-fix
-writes_product_files: true
----
-
-# Debugger
-
-Reproduce, narrow the search space, form falsifiable hypotheses, identify root cause, implement the smallest justified fix and prove it. Do not patch symptoms without evidence.
+const debuggerAgent = `---
+name: debugger
+role: root-cause-and-fix
+writes_product_files: true
+---
+
+# Debugger
+
+Reproduce, narrow the search space, form falsifiable hypotheses, identify root cause, implement the smallest justified fix and prove it. Do not patch symptoms without evidence.
 `;
-const reviewerAgent = `---
-name: reviewer
-role: independent-review
-writes_product_files: false
----
-
-# Reviewer
-
-Independently compare the approved plan, acceptance criteria, diff and verification evidence. Report actionable findings by severity. Do not approve based only on the implementer's summary and do not modify the implementation.
+const reviewerAgent = `---
+name: reviewer
+role: independent-review
+writes_product_files: false
+---
+
+# Reviewer
+
+Independently compare the approved plan, acceptance criteria, diff and verification evidence. Report actionable findings by severity. Do not approve based only on the implementer's summary and do not modify the implementation.
 `;
-const planningSkill = `---
-name: planning
-description: Use for every new user task before implementation begins.
----
-
-# Planning
-
-1. State the goal and non-goals.
-2. Separate verified facts, assumptions and decisions.
-3. Identify risks and material questions.
-4. Build a dependency-aware task graph with ownership.
-5. Select worker tiers and verification.
-6. Present the plan and wait for user approval.
+const planningSkill = `---
+name: planning
+description: Use for every new user task before implementation begins.
+---
+
+# Planning
+
+1. State the goal and non-goals.
+2. Classify the task as trivial, standard or high-risk with evidence.
+3. Separate verified facts, assumptions and decisions; identify material questions.
+4. Build a dependency-aware task graph with ownership.
+5. Select worker tiers and verification.
+6. Present the plan and wait for user approval.
+
+For trivial work, replace the task graph with one compact objective, one fast worker, exact ownership and claim-specific proof.
 `;
-const projectDiscoverySkill = `---
-name: project-discovery
-description: Use after manual sync or when a registered project's facts need bounded refresh.
----
-
-# Project Discovery
-
-Read existing AI instructions first. Inspect manifests, lockfiles, README, CI and configuration before source code. Record only evidence-backed languages, frameworks, commands and boundaries. Mark uncertain interpretations as hypotheses. Never invent architecture for an empty project.
+const projectDiscoverySkill = `---
+name: project-discovery
+description: Use after manual sync or when a registered project's facts need bounded refresh.
+---
+
+# Project Discovery
+
+Read existing AI instructions first. Inspect manifests, lockfiles, README, CI and configuration before source code. Record only evidence-backed languages, frameworks, commands and boundaries. Mark uncertain interpretations as hypotheses. Never invent architecture for an empty project.
 `;
-const explorationSkill = `---
-name: codebase-exploration
-description: Use to answer a specific codebase question before planning or delegation.
----
-
-# Codebase Exploration
-
-Start from the project snapshot and existing evidence. Search by symbol and path, not by reading the entire repository. Return relevant files, relationships, conventions, risks and unanswered questions with provenance.
+const explorationSkill = `---
+name: codebase-exploration
+description: Use to answer a specific codebase question before planning or delegation.
+---
+
+# Codebase Exploration
+
+Start from the project snapshot and existing evidence. Search by symbol and path, not by reading the entire repository. Return relevant files, relationships, conventions, risks and unanswered questions with provenance.
 `;
-const implementationSkill = `---
-name: implementation
-description: Use by a worker after an approved plan and task packet exist.
----
-
-# Implementation
-
-Confirm objective, ownership and constraints. Inspect the latest target files, make the smallest coherent change, preserve unrelated work, verify incrementally and return a completion packet. Stop and escalate when scope or assumptions change.
+const implementationSkill = `---
+name: implementation
+description: Use by a worker after an approved plan and task packet exist.
+---
+
+# Implementation
+
+Confirm objective, ownership and constraints. Inspect the latest target files, make the smallest coherent change, preserve unrelated work, verify incrementally and return a completion packet. Stop and escalate when scope or assumptions change.
 `;
-const verificationSkill = `---
-name: verification
-description: Use before any implementation is reported complete.
----
-
-# Verification
-
-Map each acceptance criterion to evidence. Run focused tests first, then lint/typecheck/build or broader tests according to risk. Record commands, exit status and failures. Distinguish passed, failed and not-run checks.
+const verificationSkill = `---
+name: verification
+description: Use before any implementation is reported complete.
+---
+
+# Verification
+
+Map each acceptance criterion to the cheapest sufficient evidence and stop when the claim is proven. Trivial work uses exact diff or targeted static proof without broad checks or review. Standard work uses focused tests and only the relevant lint/typecheck/build. High-risk work adds broad checks and independent review. A headed browser is opt-in and requires a user request or approval for a named unresolved criterion. Record passed, failed, skipped and not-run checks.
 `;
-const debuggingSkill = `---
-name: debugging
-description: Use for defects, flaky behavior and unexplained failures.
----
-
-# Debugging
-
-Reproduce first. Establish a minimal failing case, rank hypotheses, gather evidence that can disprove each one, locate root cause, add a regression test, implement the smallest fix and rerun relevant verification.
+const debuggingSkill = `---
+name: debugging
+description: Use for defects, flaky behavior and unexplained failures.
+---
+
+# Debugging
+
+Reproduce first. Establish a minimal failing case, rank hypotheses, gather evidence that can disprove each one, locate root cause, add a regression test, implement the smallest fix and rerun relevant verification.
 `;
-const codeReviewSkill = `---
-name: code-review
-description: Use for independent review after implementation.
----
-
-# Code Review
-
-Review against the approved task, not personal preference. Inspect the actual diff and surrounding code. Prioritize correctness, regressions, security, concurrency and missing tests. Report precise locations and consequences; state explicitly when no actionable finding exists.
+const codeReviewSkill = `---
+name: code-review
+description: Use for independent review after implementation.
+---
+
+# Code Review
+
+Review against the approved task, not personal preference. Inspect the actual diff and surrounding code. Prioritize correctness, regressions, security, concurrency and missing tests. Report precise locations and consequences; state explicitly when no actionable finding exists.
 `;
-const openAiProfile = `schema_version: 1
-provider: openai
-defaults:
-  orchestrator: gpt-6-astra
-  complex_worker: gpt-5.6-sol
-  fast_worker: gpt-5.6-luna
+const openAiProfile = `schema_version: 1
+provider: openai
+defaults:
+  orchestrator: gpt-6-astra
+  complex_worker: gpt-5.6-sol
+  fast_worker: gpt-5.6-luna
 `;
-const claudeProfile = `schema_version: 1
-provider: claude
-defaults:
-  orchestrator: fable-5
-  complex_worker: opus-5
-  fast_worker: sonnet-5
+const claudeProfile = `schema_version: 1
+provider: claude
+defaults:
+  orchestrator: fable-5
+  complex_worker: opus-5
+  fast_worker: sonnet-5
 `;
-const codexAdapter = `# Codex Adapter
-
-- Root entrypoint: \`AGENTS.md\`
-- Canonical profile: \`.ai/model-profiles/openai.yaml\`
-- Prefer explicit task packets over full-history forks.
-- Select worker model tiers only when the host supports per-agent model selection.
-- If configured models or delegation are unavailable, stop and report the capability mismatch.
+const codexAdapter = `# Codex Adapter
+
+- Root entrypoint: \`AGENTS.md\`
+- Canonical profile: \`.ai/model-profiles/openai.yaml\`
+- Prefer explicit task packets over full-history forks.
+- Select worker model tiers only when the host supports per-agent model selection.
+- If configured models or delegation are unavailable, stop and report the capability mismatch.
 `;
-const claudeAdapter = `# Claude Code Adapter
-
-- Root entrypoint: \`CLAUDE.md\`
-- Canonical profile: \`.ai/model-profiles/claude.yaml\`
-- Prefer explicit task packets over copying the full conversation into subagents.
-- Select worker model tiers only when the host supports per-agent model selection.
-- If configured models or delegation are unavailable, stop and report the capability mismatch.
+const claudeAdapter = `# Claude Code Adapter
+
+- Root entrypoint: \`CLAUDE.md\`
+- Canonical profile: \`.ai/model-profiles/claude.yaml\`
+- Prefer explicit task packets over copying the full conversation into subagents.
+- Select worker model tiers only when the host supports per-agent model selection.
+- If configured models or delegation are unavailable, stop and report the capability mismatch.
 `;
 const contextPacketSchema = JSON.stringify({
     $schema: "https://json-schema.org/draft/2020-12/schema",
@@ -418,9 +453,14 @@ const contextPacketSchema = JSON.stringify({
         "task_id",
         "assigned_role",
         "model_tier",
+        "risk_tier",
         "objective",
         "scope",
         "acceptance_criteria",
+        "verification_commands",
+        "review_required",
+        "browser_policy",
+        "loaded_skills",
         "expected_report",
     ],
     properties: {
@@ -428,6 +468,10 @@ const contextPacketSchema = JSON.stringify({
         parent_task_id: { type: ["string", "null"] },
         assigned_role: { type: "string", minLength: 1 },
         model_tier: { enum: ["complex_worker", "fast_worker"] },
+        risk_tier: { enum: ["trivial", "standard", "high-risk"] },
+        review_required: { type: "boolean" },
+        browser_policy: { enum: ["disabled", "ask-first", "user-approved"] },
+        loaded_skills: { type: "array", items: { type: "string", minLength: 1 } },
         objective: { type: "string", minLength: 1 },
         rationale: { type: "string" },
         scope: {
@@ -455,7 +499,16 @@ const completionPacketSchema = JSON.stringify({
     title: "Worker Completion Packet",
     type: "object",
     additionalProperties: false,
-    required: ["task_id", "status", "summary", "changed_files", "commands_run", "unresolved_risks"],
+    required: [
+        "task_id",
+        "status",
+        "summary",
+        "changed_files",
+        "commands_run",
+        "checks_skipped",
+        "loaded_skills",
+        "unresolved_risks",
+    ],
     properties: {
         task_id: { type: "string", minLength: 1 },
         status: { enum: ["completed", "failed", "needs_context", "blocked"] },
@@ -463,6 +516,8 @@ const completionPacketSchema = JSON.stringify({
         root_cause: { type: ["string", "null"] },
         changed_files: { type: "array", items: { type: "string" } },
         commands_run: { type: "array", items: { type: "object" } },
+        checks_skipped: { type: "array", items: { type: "string" } },
+        loaded_skills: { type: "array", items: { type: "string", minLength: 1 } },
         decisions_made: { type: "array", items: { type: "string" } },
         unresolved_risks: { type: "array", items: { type: "string" } },
         recommended_context_updates: { type: "array", items: { type: "string" } },