wicked-garden 12.27.0

package/.claude-plugin/archetypes.json

@@ -0,0 +1,166 @@
+{
+  "$schema_version": "v11.0.0",
+  "$comment": "Work-shape archetypes (v11). Each archetype is a complete unit with its own phases, produces, HITL discipline, and cost band. No universal pipeline. Detector classifies a prompt into one or more archetypes; steering emits per-archetype directives. v6.3 archetype detection (code-repo / docs-only / etc.) was about target *kind*; this is about work *shape*.",
+  "archetypes": {
+    "triage": {
+      "description": "Classify the work and route to the right archetype. The entry shape for any prompt that hasn't been routed yet.",
+      "phases": ["classify"],
+      "produces": ["routing-decision"],
+      "hitl": "none",
+      "cost_band": "negligible",
+      "maturity": "production",
+      "signals": {
+        "always_on": true
+      },
+      "next_archetypes": "any",
+      "min_complexity": 0
+    },
+    "explore": {
+      "description": "Diverge then converge on options when the problem space is open. Produces an option set or hypothesis, not a decision.",
+      "phases": ["frame", "diverge", "converge"],
+      "produces": ["option-set", "hypothesis"],
+      "hitl": "continuous",
+      "cost_band": "low",
+      "maturity": "research",
+      "signals": {
+        "phrases": ["what should we", "how might we", "explore options", "options for", "should we", "brainstorm", "approaches to", "not sure how", "ideas for", "could we"],
+        "novelty_high": true,
+        "ambiguity_high": true
+      },
+      "next_archetypes": ["specify", "decide", "build"],
+      "min_complexity": 0
+    },
+    "specify": {
+      "description": "Turn an ask into structured, testable acceptance criteria.",
+      "phases": ["elicit", "structure", "validate"],
+      "produces": ["smart-acceptance-criteria"],
+      "hitl": "discrete:validate-gate",
+      "cost_band": "low",
+      "maturity": "piloted",
+      "signals": {
+        "spec_ambiguity_high": true,
+        "phrases": ["acceptance criteria", "requirements", "user story", "spec"],
+        "scope_unclear": true
+      },
+      "next_archetypes": ["build", "decide"],
+      "min_complexity": 0
+    },
+    "decide": {
+      "description": "Pick between options with an ADR-shaped artifact. Used when 2+ paths are viable and the choice is load-bearing.",
+      "phases": ["brief", "options", "score", "record"],
+      "produces": ["adr", "decision-artifact"],
+      "hitl": "discrete:select-gate",
+      "cost_band": "medium",
+      "maturity": "piloted",
+      "signals": {
+        "phrases": ["should we use", "x or y", "adr", "decision", "trade-off", "pick a", "pick between", "choose between", "which database", "which queue", "which framework"],
+        "multiple_viable_options": true,
+        "reversibility_medium_or_low": true
+      },
+      "next_archetypes": ["build", "migrate", "ship"],
+      "min_complexity": 2
+    },
+    "ship": {
+      "description": "Roll out an already-built change with progressively widening blast radius.",
+      "phases": ["canary", "ramp", "full", "soak"],
+      "produces": ["rollout-verdict", "slo-snapshot"],
+      "hitl": "discrete:ramp-gates",
+      "cost_band": "medium",
+      "maturity": "piloted",
+      "signals": {
+        "phrases": ["deploy", "release", "rollout", "roll out", "ramp", "ship to", "ship the"],
+        "blast_radius_high": true,
+        "post_build": true
+      },
+      "next_archetypes": ["review"],
+      "min_complexity": 2
+    },
+    "review": {
+      "description": "Independent assessment of an artifact (code / spec / design / incident response). Hard verdict at the end — APPROVE / CONDITIONAL / REJECT — with a remediation list when not APPROVE.",
+      "phases": ["scope", "assess", "findings", "remediate-or-accept"],
+      "produces": ["verdict", "remediation-list"],
+      "hitl": "hard:final-verdict",
+      "cost_band": "medium",
+      "maturity": "piloted",
+      "signals": {
+        "phrases": ["review", "audit", "evaluate", "verdict", "code review", "design review", "take a look at", "look at this pr", "look at the pr"],
+        "independent_assessment_needed": true
+      },
+      "next_archetypes": ["build", "migrate", "ship", "incident"],
+      "min_complexity": 1
+    },
+    "incident": {
+      "description": "Live-fire response to a production failure. Mitigate first, RCA second, follow-up third.",
+      "phases": ["triage", "investigate", "mitigate", "resolve", "followup"],
+      "produces": ["mitigation", "rca", "followup-list"],
+      "hitl": "hard:mitigate",
+      "cost_band": "variable",
+      "maturity": "production",
+      "signals": {
+        "phrases": ["down", "outage", "incident", "broken in prod", "production is broken", "post-mortem", "postmortem", "5xx", "error rate", "memory leak", "paging us", "paged", "oncall paged"],
+        "production_impact": true
+      },
+      "next_archetypes": ["build", "migrate", "review"],
+      "min_complexity": 0
+    },
+    "build": {
+      "description": "Implement and ship a new feature or fix. The most common archetype. Test rigor scales with complexity / blast_radius / novelty.",
+      "phases": ["plan", "implement", "test", "review"],
+      "produces": ["shipped-code", "test-report"],
+      "hitl": "discrete:review-gate",
+      "cost_band": "high",
+      "maturity": "research",
+      "signals": {
+        "phrases": ["implement", "add", "build", "feature", "fix", "create", "refactor", "patch", "wire up", "wire in", "hook up", "update the"],
+        "code_change": true
+      },
+      "next_archetypes": ["ship", "review"],
+      "min_complexity": 0,
+      "test_rigor_scales_with": ["complexity", "blast_radius", "novelty"]
+    },
+    "migrate": {
+      "description": "Shape change that requires forward + rollback proof. Schema migrations, data backfills, breaking-API rollouts. Expand-contract pattern.",
+      "phases": ["plan", "expand", "backfill", "cutover", "contract"],
+      "produces": ["shape-change", "rollback-proof"],
+      "hitl": "hard:cutover-gate",
+      "cost_band": "high",
+      "maturity": "research",
+      "signals": {
+        "phrases": ["migration", "migrate", "schema change", "backfill", "cutover", "rename column", "rename the", "drop column", "breaking change", "expand the", "retire the", "take the", "column out"],
+        "state_complexity_high": true,
+        "reversibility_low": true
+      },
+      "next_archetypes": ["ship", "review"],
+      "min_complexity": 2
+    },
+    "modernize": {
+      "description": "Port a legacy codebase to a new stack: discover the estate, extract the business rules, blueprint the target, transform with leverage, prove parity, cut over. The factory phase shape, run as a GENERAL modernization steering shape that composes the general code-modernization skills — NOT in-place shape change (that is migrate).",
+      "phases": ["discover", "extract", "blueprint", "transform", "parity", "cutover"],
+      "produces": ["modernization-blueprint", "parity-proof"],
+      "hitl": "hard:cutover-gate",
+      "cost_band": "high",
+      "maturity": "research",
+      "signals": {
+        "phrases": ["modernize", "modernization", "port from", "port the", "rewrite the legacy", "legacy codebase", "lift and shift", "cobol", "angularjs", ".net framework", "rehost", "replatform", "new stack", "to a new stack"],
+        "novelty_high": true,
+        "state_complexity_high": true,
+        "reversibility_low": true
+      },
+      "next_archetypes": ["review", "ship"],
+      "min_complexity": 2
+    }
+  },
+  "$detector_notes": [
+    "Archetypes are NOT mutually exclusive. A schema-changing feature is build + migrate. A risky deploy is ship + review.",
+    "triage is the entry archetype — it always fires first to classify.",
+    "Signals come from the prompt text + the propose-process 9-factor scoring. The detector is allowed to be confident (>0.7) on a single archetype OR return a small set.",
+    "When no archetype scores > 0.5, return ['triage'] and ask a clarifying question.",
+    "The phase shapes are EACH archetype's own. There is no universal pipeline. A 'build' that needs a 'specify' first chains: specify -> build, NOT specify-as-build's-clarify-phase."
+  ],
+  "$hitl_levels": {
+    "none": "No human checkpoint. Fires and is done.",
+    "continuous": "Human is a participant throughout. Brainstorm-style.",
+    "discrete:<gate>": "Hard stop at the named gate; human approves before proceeding.",
+    "hard:<gate>": "Same as discrete but the gate cannot be auto-approved or bypassed without explicit override audit log."
+  }
+}

package/.claude-plugin/components.json

@@ -0,0 +1,75 @@
+{
+  "_comment": "Issue #328: Component declarations for wicked-garden plugin. Claude Code plugin.json does not yet support inline component declarations beyond path overrides. This manifest documents all components for tooling, validation, and future schema support. When plugin.json gains a 'components' field, merge this data into plugin.json.",
+  "domains": ["agentic", "crew", "data", "engineering", "jam", "mem", "persona", "platform", "product", "qe", "search", "smaht"],
+  "summary": {
+    "commands": 77,
+    "agents": 23,
+    "skills": 67,
+    "hooks": 13,
+    "specialists": 7
+  },
+  "agents_by_domain": {
+    "agentic": ["architect", "performance-analyst", "safety-reviewer"],
+    "crew": ["implementer", "researcher", "reviewer"],
+    "data": ["data-engineer"],
+    "engineering": ["api-documentarian", "migration-engineer", "solution-architect"],
+    "jam": ["brainstorm-facilitator", "council", "quick-facilitator"],
+    "persona": ["persona-agent"],
+    "platform": ["compliance-officer", "privacy-expert", "security-engineer"],
+    "product": ["a11y-expert", "requirements-analyst", "ui-reviewer", "ux-designer", "value-strategist"],
+    "qe": ["semantic-reviewer"]
+  },
+  "skills_by_domain": {
+    "agentic": ["agentic-patterns", "context-engineering", "frameworks", "review-methodology", "trust-and-safety"],
+    "archetype": ["archetype"],
+    "classify": ["classify"],
+    "data": ["analysis", "data", "ml", "pipeline"],
+    "deliberate": ["deliberate"],
+    "engineering": ["architecture", "backend", "debugging", "docs", "engineering", "frontend", "integration", "large-scale-migration", "patch", "system-design", "unit-test-quality"],
+    "ground": ["ground"],
+    "integration-discovery": ["integration-discovery"],
+    "jam": ["jam"],
+    "multi-model": ["multi-model"],
+    "persona": ["persona"],
+    "platform": ["audit", "compliance", "errors", "gate-benchmark-rebaseline", "gh-cli", "github-actions", "gitlab-ci", "glab-cli", "health", "observability", "prereq-doctor"],
+    "product": ["acceptance-criteria", "accessibility", "analyze", "imagery", "listen", "mockup", "requirements-analysis", "requirements-graph", "requirements-migrate", "requirements-navigate", "screenshot", "strategy", "synthesize", "ux-review", "visual-review"],
+    "runtime-exec": ["runtime-exec"],
+    "search": ["codebase-narrator"],
+    "smaht": ["discovery", "intent", "propose-skills", "smaht"],
+    "swarm": ["swarm"],
+    "wickedizer": ["wickedizer"],
+    "workflow": ["workflow"],
+    "worktrees": ["worktrees"]
+  },
+  "hooks": ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PostToolUseFailure", "TaskCompleted", "SubagentStart", "SubagentStop", "PermissionRequest", "Notification", "PreCompact", "Stop", "SessionEnd"],
+  "specialists": [
+    {
+      "name": "engineering",
+      "role": "engineering"
+    },
+    {
+      "name": "platform",
+      "role": "devsecops"
+    },
+    {
+      "name": "product",
+      "role": "product"
+    },
+    {
+      "name": "qe",
+      "role": "quality-engineering"
+    },
+    {
+      "name": "data",
+      "role": "data-engineering"
+    },
+    {
+      "name": "jam",
+      "role": "brainstorming"
+    },
+    {
+      "name": "agentic",
+      "role": "agentic-architecture"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "wicked-garden",
+  "owner": {
+    "name": "Mike Parcewski"
+  },
+  "plugins": [
+    {
+      "name": "wicked-garden",
+      "source": "./",
+      "description": "Your coding agent already plans and swarms \u2014 Wicked Garden is the curated toolkit for what it can't: proof-not-claims gates, code links grep can't see, deterministic refactor, cross-session memory, real multi-model second opinions. Don't fight the harness; fill its gaps. The gate needs wicked-vault + wicked-loom; testing/brain/bus are opt-in layers.",
+      "version": "12.27.0"
+    }
+  ],
+  "version": "12.27.0"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,174 @@
+{
+  "name": "wicked-garden",
+  "version": "12.27.0",
+  "description": "Your coding agent's harness already plans and swarms; Wicked Garden is the curated toolkit for what it can't do alone. Proof, not claims \u2014 gates re-derive 'done' through the internal loom engine (fail-closed, independently attested via wicked-vault), so a self-asserted pass can't lie its way green. Relationships grep can't see \u2014 codegraph + injected bus/dispatch/capability edges power blast-radius & lineage. Plus deterministic multi-file refactor (wicked-patch), cross-session memory (wicked-brain), real multi-model second opinions (jam:council), portable expertise as on-demand skill-refs, and evidence-gated testing (wicked-testing). It reads the shape of your work to apply the right rigor \u2014 steering, not a pipeline \u2014 then gets out of the way. The compiler stamps a self-contained evidence gate into any repo that runs with no wicked-garden installed. Don't fight the harness; fill its gaps. The evidence gate requires wicked-vault (installed automatically via wicked-testing); wicked-testing, wicked-brain, wicked-understanding, and wicked-bus are opt-in layers \u2014 install what you'll use, the toolkit works without the rest.",
+  "wicked_testing_version": "^0.7.0",
+  "wicked_vault_version": "^0.4.0",
+  "wicked_brain_version": "^0.15.0",
+  "wicked_bus_version": "^2.0.0",
+  "author": {
+    "name": "Mike Parcewski"
+  },
+  "repository": "https://github.com/mikeparcewski/wicked-garden",
+  "license": "MIT",
+  "keywords": [
+    "coding-agent",
+    "harness",
+    "evidence-gate",
+    "code-graph",
+    "code-intelligence",
+    "refactoring",
+    "testing",
+    "memory",
+    "multi-model",
+    "agentic"
+  ],
+  "_future_userConfig": {
+    "_comment": "Issue #335, #346: userConfig is not yet supported in plugin.json schema. When Claude Code adds userConfig support, move these fields out of _future_userConfig and into a top-level userConfig block. This would replace the manual /wicked-garden:setup flow.",
+    "storage_mode": {
+      "type": "string",
+      "default": "local",
+      "enum": [
+        "local",
+        "sqlite"
+      ],
+      "description": "Where to persist plugin state: local JSON files or SQLite with FTS5"
+    },
+    "onboarding_preference": {
+      "type": "string",
+      "default": "auto",
+      "enum": [
+        "auto",
+        "manual",
+        "skip"
+      ],
+      "description": "How to handle first-run onboarding: auto-detect and configure, prompt user, or skip"
+    },
+    "log_level": {
+      "type": "string",
+      "default": "info",
+      "enum": [
+        "debug",
+        "info",
+        "warn",
+        "error"
+      ],
+      "description": "Verbosity level for operational logs"
+    },
+    "jira_api_token": {
+      "_comment": "Issue #346: When userConfig supports sensitive:true, this field should use it to store the token in the OS keychain rather than plaintext.",
+      "type": "string",
+      "sensitive": true,
+      "description": "Jira API token for issue sync (stored in OS keychain when sensitive flag is supported)"
+    },
+    "linear_api_token": {
+      "type": "string",
+      "sensitive": true,
+      "description": "Linear API token for issue sync (stored in OS keychain when sensitive flag is supported)"
+    },
+    "slack_webhook_url": {
+      "type": "string",
+      "sensitive": true,
+      "description": "Slack webhook URL for notifications (stored in OS keychain when sensitive flag is supported)"
+    }
+  },
+  "_future_channels": {
+    "_comment": "Issue #348: channels field is not yet supported in plugin.json schema. When Claude Code adds channel support, move these declarations to a top-level channels block. Channels formalize external service connections with discovery and auth.",
+    "jira": {
+      "type": "rest-api",
+      "description": "Jira issue tracker for bi-directional sync with native Claude Code tasks",
+      "auth": "oauth2",
+      "capabilities": [
+        "read-issues",
+        "write-issues",
+        "webhooks"
+      ]
+    },
+    "linear": {
+      "type": "rest-api",
+      "description": "Linear issue tracker for bi-directional sync with native Claude Code tasks",
+      "auth": "api-key",
+      "capabilities": [
+        "read-issues",
+        "write-issues",
+        "webhooks"
+      ]
+    },
+    "slack": {
+      "type": "webhook",
+      "description": "Slack notifications for crew phase completions and gate failures",
+      "auth": "webhook-url",
+      "capabilities": [
+        "send-messages"
+      ]
+    },
+    "github": {
+      "type": "rest-api",
+      "description": "GitHub for issue triage, PR creation, and CI status",
+      "auth": "token",
+      "capabilities": [
+        "read-issues",
+        "write-issues",
+        "read-prs",
+        "write-prs",
+        "read-checks"
+      ]
+    }
+  },
+  "_future_lspServers": {
+    "_comment": "Issue #347: lspServers field enables Language Server Protocol integration for richer code intelligence (go-to-definition, find-references, hover, diagnostics). When Claude Code adds lspServers support to plugins, investigate integrating with the search/CIQ domain for enhanced symbol resolution. Candidate servers: TypeScript (typescript-language-server), Python (pyright), Rust (rust-analyzer)."
+  },
+  "_future_outputStyles": {
+    "_comment": "Issue #338: outputStyles field is not yet supported as a configuration block in plugin.json. When Claude Code adds outputStyles support, move these declarations to a top-level outputStyles block or the ./styles/ directory. These define domain-specific formatting for different work modes.",
+    "crew-phase": {
+      "description": "Structured output for crew workflow phases with phase headers, gate results, and evidence summaries",
+      "format": "markdown",
+      "sections": [
+        "phase-header",
+        "deliverables",
+        "gate-result",
+        "evidence-summary"
+      ]
+    },
+    "engineering-review": {
+      "description": "Code review output with severity-tagged findings, file annotations, and action items",
+      "format": "markdown",
+      "sections": [
+        "summary",
+        "findings-by-severity",
+        "file-annotations",
+        "action-items"
+      ]
+    },
+    "delivery-report": {
+      "description": "Delivery metrics report with velocity charts, risk indicators, and forecast",
+      "format": "markdown",
+      "sections": [
+        "velocity",
+        "risks",
+        "forecast",
+        "recommendations"
+      ]
+    },
+    "qe-results": {
+      "description": "Test execution results with pass/fail counts, coverage, and failure analysis",
+      "format": "markdown",
+      "sections": [
+        "summary",
+        "results-table",
+        "failure-analysis",
+        "coverage"
+      ]
+    },
+    "brainstorm-synthesis": {
+      "description": "Jam session output with perspectives, convergence points, and actionable next steps",
+      "format": "markdown",
+      "sections": [
+        "perspectives",
+        "convergence",
+        "divergence",
+        "next-steps"
+      ]
+    }
+  }
+}

package/.claude-plugin/specialist.json

@@ -0,0 +1,48 @@
+{
+  "plugin": "wicked-garden",
+  "_comment": "Specialist roles listed here are user-facing disciplines surfaced by crew for phase routing. Internal infrastructure domains (crew, mem, persona, smaht, search, jam) are NOT listed as specialists — they are invoked directly via their commands, not routed through the specialist dispatch system.",
+  "specialists": [
+    {
+      "name": "engineering",
+      "role": "engineering",
+      "description": "Full-stack engineering expertise spanning code quality, architecture, debugging, documentation, and implementation patterns.",
+      "enhances": ["design", "build", "review"]
+    },
+    {
+      "name": "platform",
+      "role": "devsecops",
+      "description": "DevSecOps specialist for security scanning, CI/CD pipelines, infrastructure, compliance, and incident response.",
+      "enhances": ["build", "review", "operate", "*"]
+    },
+    {
+      "name": "product",
+      "role": "product",
+      "description": "Product and design expertise spanning requirements, UX, customer voice, business strategy, accessibility, visual design review, mockups, and user flow analysis.",
+      "enhances": ["clarify", "design", "review"]
+    },
+    {
+      "name": "qe",
+      "role": "quality-engineering",
+      "description": "Quality Engineering specialist powered by wicked-testing peer plugin. Crew dispatches QE agents by their wicked-testing:* subagent_type names. Covers test strategy, scenario generation, testability review, semantic alignment, risk assessment, test automation, and shift-left quality practices. Requires wicked-testing ^0.2 installed.",
+      "enhances": ["clarify", "design", "qe", "build", "review", "operate", "*"]
+    },
+    {
+      "name": "data",
+      "role": "data-engineering",
+      "description": "Data engineering specialist providing expertise in pipeline design, data analysis, ML model guidance, and analytics architecture.",
+      "enhances": ["design", "build", "*"]
+    },
+    {
+      "name": "jam",
+      "role": "brainstorming",
+      "description": "Multi-perspective brainstorming with dynamic focus groups. Explores ideas through persona-based discussion rounds and synthesis.",
+      "enhances": ["clarify", "design", "build"]
+    },
+    {
+      "name": "agentic",
+      "role": "agentic-architecture",
+      "description": "Validates agentic application architecture, patterns, and design. Reviews agent implementations for safety, performance, and best practices.",
+      "enhances": ["design", "build", "review"]
+    }
+  ]
+}

package/.claude-plugin/stack-registry.json

@@ -0,0 +1,96 @@
+{
+  "$schema_version": "v1.0.0",
+  "$comment": "Legacy-stack-class -> {blueprint, fixes, transform, validate, status} dispatch truth, read by the `modernize` archetype's `discover` phase (scripts/crew/stack_registry.py). The `status` field is the load-bearing honesty contract: this registry NEVER fabricates a migration for `planned`/`none`/unknown stacks — the reader emits a capability-gap task and STOPS, matching garden's fail-closed ETHOS ('we do not silently degrade ... never invent a pass'). Dispatch is strictly wired-only: any status other than `wired` (including a typo/unknown value) fails closed to a gap-task. The `planned` rows double as the modernization roadmap (each is a backlog item, not a capability). `blueprint`/`fixes`/`transform`/`validate` name the GENERAL code-modernization assets/skills that handle the class (`fixes` is the optional list of hardening skills applied post-transform); this registry is stack-agnostic content, not an engine. status: wired = transform+validate exist and run; planned = on the roadmap, gap-task emitted; none = out of scope, gap-task emitted.",
+  "$status_levels": {
+    "wired": "blueprint + transform + validate all resolvable and runnable now. Dispatch proceeds.",
+    "planned": "on the modernization roadmap but not yet runnable. Reader emits a capability-gap task and stops — never fabricates.",
+    "none": "explicitly out of scope. Reader emits a capability-gap task and stops."
+  },
+  "stacks": {
+    "generic-cross-stack": {
+      "id": "generic-cross-stack",
+      "label": "Generic legacy -> modern port (language/framework-agnostic)",
+      "detect": {
+        "legacyMarkers": [],
+        "manifests": []
+      },
+      "blueprint": "code-modernization:modernize-reimagine",
+      "fixes": ["code-modernization:modernize-harden"],
+      "transform": {
+        "skills": ["code-modernization:modernize-map", "code-modernization:modernize-transform"]
+      },
+      "validate": {
+        "gate": "produces:parity-proof"
+      },
+      "status": "wired"
+    },
+    "node-legacy-to-modern": {
+      "id": "node-legacy-to-modern",
+      "label": "Legacy Node/JS (callbacks, CommonJS, old framework) -> modern TS/ESM",
+      "detect": {
+        "legacyMarkers": ["require(", "module.exports", "var self = this"],
+        "manifests": ["package.json"]
+      },
+      "blueprint": "code-modernization:modernize-reimagine",
+      "fixes": ["code-modernization:modernize-harden"],
+      "transform": {
+        "skills": ["code-modernization:modernize-map", "code-modernization:modernize-transform"]
+      },
+      "validate": {
+        "gate": "produces:parity-proof"
+      },
+      "status": "wired"
+    },
+    "angularjs-to-angular": {
+      "id": "angularjs-to-angular",
+      "label": "AngularJS (1.x) -> modern Angular",
+      "detect": {
+        "legacyMarkers": ["angular.module", "ng-controller", "$scope"],
+        "manifests": ["bower.json", "package.json"]
+      },
+      "blueprint": "code-modernization:modernize-reimagine",
+      "fixes": [],
+      "transform": {
+        "planned": "AngularJS->Angular component/codemod wave not yet curated as a wired transform"
+      },
+      "validate": {
+        "planned": "differential-equivalence harness for the AngularJS->Angular boundary not yet wired"
+      },
+      "status": "planned"
+    },
+    "cobol-to-java": {
+      "id": "cobol-to-java",
+      "label": "COBOL batch/online -> Java",
+      "detect": {
+        "legacyMarkers": ["IDENTIFICATION DIVISION", "PROCEDURE DIVISION", "PIC X"],
+        "manifests": ["*.cbl", "*.cob"]
+      },
+      "blueprint": "code-modernization:modernize-reimagine",
+      "fixes": [],
+      "transform": {
+        "planned": "COBOL->Java rule-extraction + transform pipeline not yet wired as a runnable transform"
+      },
+      "validate": {
+        "planned": "record/replay parity harness for batch outputs not yet wired"
+      },
+      "status": "planned"
+    },
+    "dotnet-framework-to-core": {
+      "id": "dotnet-framework-to-core",
+      "label": ".NET Framework -> .NET (Core) cross-platform",
+      "detect": {
+        "legacyMarkers": ["System.Web", "<TargetFrameworkVersion>", "global.asax"],
+        "manifests": ["*.csproj", "packages.config", "web.config"]
+      },
+      "blueprint": "code-modernization:modernize-reimagine",
+      "fixes": [],
+      "transform": {
+        "planned": ".NET Framework->Core upgrade-assistant-class transform not yet wired"
+      },
+      "validate": {
+        "planned": "parity harness for the .NET boundary not yet wired"
+      },
+      "status": "planned"
+    }
+  }
+}

package/AGENTS.md

@@ -0,0 +1,13 @@
+# Agent Instructions
+
+**The canonical agent instructions for this repository live in [`.claude/CLAUDE.md`](.claude/CLAUDE.md).**
+Read that file — it is the single source of truth for how to work in wicked-garden:
+conventions, v11/v12 architecture, evidence-re-derivation, delegation, code search,
+memory, storage, and security.
+
+> **Why (identity):** see [`ETHOS.md`](ETHOS.md) for what wicked-garden believes / refuses /
+> optimizes for. `CLAUDE.md` is *how to act*; `ETHOS.md` is *why*.
+
+This file is intentionally a thin pointer so there is exactly one source of truth.
+Other AI coding tools (Codex, Cursor, Aider, OpenCode, Zed/ACP, …) that read `AGENTS.md`:
+follow the link above to `.claude/CLAUDE.md`.