claude-mcp-workflow 0.1.6 → 0.1.7

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "workflow",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Structured workflow orchestration for AI agents via finite-state machines. Dashboard: http://localhost:3100",
   "author": {
     "name": "AxGord",

package/README.md

@@ -23,12 +23,21 @@ A Claude Code plugin that drives agents through YAML-defined state machines. The
 - **Action states** — `exec` runs shell commands, `fetch` makes HTTP requests, with auto-routing by exit code or HTTP status
 - **Web dashboard** — real-time session monitoring with DAG graph visualization
 - **18 bundled workflows** — complete agent lifecycle from routing to reflection
-- **9 bundled skills** — reusable knowledge modules auto-provisioned on first run
+- **20 bundled skills** — reusable knowledge modules auto-provisioned on first run
 - **SessionStart hook** — auto-provisions missing skills and injects workflow context
 
 ## Quick Start
 
-### From npm (recommended)
+### From Community Plugins (recommended)
+
+The plugin is listed in the [claude-plugins-community](https://github.com/anthropics/claude-plugins-community/) catalog:
+
+```bash
+/plugin marketplace add https://github.com/anthropics/claude-plugins-community
+/plugin install workflow
+```
+
+### From npm
 
 Create a `marketplace.json` and add it as a source, or install directly:
 
@@ -208,19 +217,52 @@ A project workflow named `coding` overrides the bundled `coding` template. Same-
 
 ## Bundled Skills
 
-Skills are reusable knowledge modules loaded by workflows via `Skill()`. Auto-provisioned to `~/.claude/skills/` on first run if missing.
+Skills are reusable knowledge modules loaded by workflows via `Skill()`. Auto-provisioned to `~/.claude/skills/` on first run if missing. Edit your local copy to override the bundled version — the hook never overwrites existing files.
+
+**Methodology**
 
 | Skill | Description |
 |-------|-------------|
-| `preferences` | User's general coding preferences |
+| `preferences` | Template for personal coding preferences (fill in your own) |
 | `architecture` | Simplicity-first architecture decisions |
 | `task-delegation` | When and how to delegate to subagents |
 | `coding-skill-selector` | Select and load coding skills by file extensions and domains |
-| `lang-haxe` | Haxe language gotchas |
+| `workflow-authoring` | Reference for creating workflows with exec/fetch action states |
+
+**Languages**
+
+| Skill | Description |
+|-------|-------------|
+| `lang-haxe` | Haxe language gotchas (incl. macros, null safety, hxcpp) |
 | `lang-python` | Python language gotchas |
+| `lang-as3` | AS3 / AIR 51 language gotchas |
+
+**Domains**
+
+| Skill | Description |
+|-------|-------------|
+| `domain-yolo` | YOLO object detection model selection |
+| `domain-pixi` | Pixi.js v8 masking and graphics gotchas |
+| `domain-reid` | Person re-identification ML gotchas |
+| `domain-gamedev` | Game dev precision and physics gotchas |
+
+**Platforms & Tooling**
+
+| Skill | Description |
+|-------|-------------|
+| `target-openfl-native` | OpenFL/hxcpp native target gotchas |
+| `build-cmake` | CMake build system gotchas |
+| `ci-github-actions` | GitHub Actions workflow gotchas |
+| `aws-lambda` | AWS Lambda .NET deployment gotchas |
+| `mcp-setup` | MCP server setup and troubleshooting |
+| `claude-code-config` | Claude Code configuration gotchas |
+
+**Utility**
+
+| Skill | Description |
+|-------|-------------|
 | `math` | Math overflow boundary gotchas |
 | `web-reading` | Fetch web content via subagents |
-| `workflow-authoring` | Reference for creating workflows with exec/fetch action states |
 
 ## MCP Tools
 

package/build/index.js

@@ -34,6 +34,10 @@ const refErrors = loader.validateReferences();
 if (refErrors.length > 0) {
     console.error("Workflow reference warnings:", refErrors.join("; "));
 }
+const skillErrors = loader.validateSkillReferences();
+if (skillErrors.length > 0) {
+    console.error("Skill reference warnings:", skillErrors.join("; "));
+}
 // Start hot-reload
 loader.startWatching();
 const executor = new Executor();

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/loader.d.ts

@@ -25,5 +25,17 @@ export declare class Loader {
     private _loadDir;
     private _validate;
     validateReferences(): string[];
+    /**
+     * Validate that every required skill referenced in a state's `skills:` list exists
+     * in at least one skill directory (plugin bundle, user, or project). Optional skills
+     * (`?<name>` prefix) are skipped — they're allowed to be missing.
+     *
+     * Skill discovery order matches Claude Code's: plugin templates → user (~/.claude/skills/)
+     * → project (<cwd>/.claude/skills/). Existence is checked by SKILL.md presence.
+     *
+     * Returns a flat list of error strings; non-empty result means the workflow set
+     * references a non-existent required skill (typo or removed skill).
+     */
+    validateSkillReferences(): string[];
 }
 //# sourceMappingURL=loader.d.ts.map

package/build/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,eAAe,CAA6B;gBAExC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAS5E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAIzC,KAAK,IAAI,MAAM,EAAE;IAIxB,kDAAkD;IAC3C,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM;IAUxD,oCAAoC;IACpC,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAEM,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAOpB,MAAM,IAAI,IAAI;IAIrB,mCAAmC;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM;IAcjE,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,SAAS;IAkEV,kBAAkB,IAAI,MAAM,EAAE;CAUtC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,eAAe,CAA6B;gBAExC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAS5E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAIzC,KAAK,IAAI,MAAM,EAAE;IAIxB,kDAAkD;IAC3C,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM;IAUxD,oCAAoC;IACpC,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAEM,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAOpB,MAAM,IAAI,IAAI;IAIrB,mCAAmC;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM;IAcjE,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,SAAS;IAkEV,kBAAkB,IAAI,MAAM,EAAE;IAWrC;;;;;;;;;;OAUG;IACI,uBAAuB,IAAI,MAAM,EAAE;CAuB3C"}

package/build/loader.js

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import YAML from "yaml";
 import { WorkflowDefinitionSchema } from "./types.js";
@@ -195,5 +196,39 @@ export class Loader {
         }
         return errors;
     }
+    /**
+     * Validate that every required skill referenced in a state's `skills:` list exists
+     * in at least one skill directory (plugin bundle, user, or project). Optional skills
+     * (`?<name>` prefix) are skipped — they're allowed to be missing.
+     *
+     * Skill discovery order matches Claude Code's: plugin templates → user (~/.claude/skills/)
+     * → project (<cwd>/.claude/skills/). Existence is checked by SKILL.md presence.
+     *
+     * Returns a flat list of error strings; non-empty result means the workflow set
+     * references a non-existent required skill (typo or removed skill).
+     */
+    validateSkillReferences() {
+        const errors = [];
+        const skillDirs = [];
+        if (this._bundledDir)
+            skillDirs.push(path.join(this._bundledDir, "skills"));
+        skillDirs.push(path.join(os.homedir(), ".claude", "skills"));
+        if (this._projectDir)
+            skillDirs.push(path.resolve(this._projectDir, "..", "skills"));
+        const exists = (name) => skillDirs.some(d => fs.existsSync(path.join(d, name, "SKILL.md")));
+        for (const [wfName, wf] of this._workflows) {
+            for (const [stateName, state] of Object.entries(wf.states)) {
+                if (!state.skills)
+                    continue;
+                for (const ref of state.skills) {
+                    if (ref.startsWith("?"))
+                        continue;
+                    if (!exists(ref))
+                        errors.push(`${wfName}/${stateName}: required skill "${ref}" not found`);
+                }
+            }
+        }
+        return errors;
+    }
 }
 //# sourceMappingURL=loader.js.map

package/build/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mcp-workflow",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Structured workflow orchestration for AI agents via finite-state machines",
   "author": "AxGord <axgord@gmail.com> (https://github.com/AxGord)",
   "license": "MIT",

package/templates/bug-fix.yaml

@@ -17,9 +17,17 @@ states:
       - `visual` → UI/layout bug — requires debug bridge, screenshots, visual reproduction
       - `logic` → data/logic bug — reproducible via unit tests or logs
     transitions:
-      visual: reproduce_visual
+      visual: load_skills_visual
       logic: reproduce_logic
 
+  load_skills_visual:
+    skills:
+      - coding-skill-selector
+      - ?debug-bridge
+      - ?project-skill-selector
+    transitions:
+      continue: reproduce_visual
+
   reproduce_visual:
     task: "Reproduce the bug visually"
     prompt: |
@@ -28,17 +36,23 @@ states:
       DO NOT fix the bug here. You may add trace/log statements to help reproduce,
       but do NOT modify production logic. The fix belongs in the `fix` state.
 
-      MANDATORY FIRST ACTION — read the skill descriptions in the system-reminder skills list
-      and call `Skill(name)` for EVERY skill whose description relates to debug bridges,
-      interactive debugging, UI interaction, or the current app's domain.
-      Do NOT skip this. Working without relevant skills leads to wasted time and errors.
+      REPRODUCTION TOOLING — find the right tool:
+      1. Check available MCP tools for browser/screenshot/debug-bridge capabilities.
+      2. Pick the tool matching the platform.
+      3. Persist the choice for verify_visual:
+         `context_set({ key: "chosen_tool", value: "<short name + how to launch>" })`
+
+      "No tooling available" is almost never true for a visual app. Verify the MCP
+      tool list before choosing `cant_reproduce`. Do NOT `abort()` to escape this
+      gate — use `cant_reproduce` if genuinely blocked.
 
       MANDATORY STEPS (all required, in order):
       1. Understand the exact user path that triggers the bug (which button, which file, which action)
-      2. Build and launch the app with debug bridge
-      3. Follow the SAME path the user described to trigger the bug
-      4. Take a screenshot and VERIFY the bug is visible
-      5. Describe what you see — compare with the user's report
+      2. Build (if applicable — native targets must be built before launch)
+      3. Launch the app and connect with the tool chosen above
+      4. Follow the SAME path the user described to trigger the bug
+      5. Take a screenshot and VERIFY the bug is visible
+      6. Describe what you see — compare with the user's report
 
       STOP — self-check before transitioning:
       - Did you LAUNCH the app and take a SCREENSHOT? If not, you haven't reproduced.
@@ -50,7 +64,9 @@ states:
       `cant_reproduce` = you tried but can't see it. This leads to asking the user for help.
       NEVER use `reproduced` when you haven't seen the bug yourself.
 
-      If the bug requires file operations, use the tm-interactive-debug skill recipes.
+      If the bug requires simulated input or file operations, use the chosen tool's
+      recipes: Playwright `browser_evaluate` / `browser_press_key` for web,
+      tm-interactive-debug for native.
     transitions:
       reproduced: diagnose
       cant_reproduce: clarify
@@ -86,7 +102,7 @@ states:
       transition `try_visual` to reproduce via debug bridge instead.
     transitions:
       reproduced: diagnose
-      try_visual: reproduce_visual
+      try_visual: load_skills_visual
       cant_reproduce: clarify
 
   diagnose:
@@ -279,19 +295,33 @@ states:
       - Visual bug → `visual` (needs screenshot verification)
       - Logic bug → `logic` (tests already passed in testing workflow)
     transitions:
-      visual: verify_visual
+      visual: load_skills_verify
       logic: done
 
+  load_skills_verify:
+    skills:
+      - coding-skill-selector
+      - ?debug-bridge
+      - ?project-skill-selector
+    transitions:
+      continue: verify_visual
+
   verify_visual:
     task: "Verify the fix visually"
     prompt: |
       Verify the original bug is fixed VISUALLY.
 
+      Tool chosen at reproduction: {{context.chosen_tool}}
+      (If empty — context was lost. Re-pick a tool now using the same approach
+      as reproduce_visual: check available MCP tools, pick the one matching the
+      platform.)
+
       MANDATORY STEPS:
-      1. Build and launch the app with debug bridge
-      2. Follow the SAME path used during reproduction
-      3. Take a screenshot and VERIFY the bug is gone
-      4. Compare before/after — describe the visual difference
+      1. Build (if applicable — native targets must be built before launch; rebuild after the fix)
+      2. Launch the app using the tool above
+      3. Follow the SAME path used during reproduction
+      4. Take a screenshot and VERIFY the bug is gone
+      5. Compare before/after — describe the visual difference
 
       DO NOT transition to `confirmed` without a screenshot proving the fix works.
     transitions:
@@ -302,7 +332,7 @@ states:
     task: "Clarify bug details"
     prompt: "Ask the user for more details about the bug."
     transitions:
-      got_info_visual: reproduce_visual
+      got_info_visual: load_skills_visual
       got_info_logic: reproduce_logic
 
   escalate:

package/templates/code-review.yaml

@@ -245,7 +245,7 @@ states:
       - No debatable concerns → `all_clear`
     transitions:
       has_concerns: discuss
-      all_clear: re_review
+      all_clear: done
 
   discuss:
     task: "Discuss debatable concerns"
@@ -269,65 +269,42 @@ states:
     transitions:
       plan: plan_changes
       code: code_changes
-      skip: re_review
+      skip: done
 
   plan_changes:
     task: "Plan agreed changes"
     sub_workflow: planning
-    on_complete: verify_functional
+    on_complete: done
     on_fail: done
 
   code_changes:
     task: "Apply agreed changes"
     sub_workflow: coding
-    on_complete: verify_functional
+    on_complete: verify_impact
     on_fail: done
 
-  verify_functional:
-    task: "Verify build and test functional changes"
-    prompt: |
-      Code was changed after discussion — verify correctness.
-
-      1. Run the project's build/compile command. Check for errors.
-         - Build fails → fix errors, rebuild until it passes.
-
-      2. Check if any agreed changes modified functionality (not just cosmetic).
-         If yes → run tests for the changed behavior. Use the project's test
-         framework, or if no automated tests cover the change, describe what
-         manual testing is needed and ask the user to verify.
-         If all changes were cosmetic → build passing is sufficient.
-
-      After verification:
-      - `pass` → proceed to re-review
-      - `fail` → changes broke the build beyond repair, skip to re-review without the failed changes
-    transitions:
-      pass: re_review
-      fail: re_review
-
-  re_review:
-    task: "Re-review changed files for cascading issues"
+  verify_impact:
+    task: "Verify build, tests, and cross-file impact"
     prompt: |
-      Previous fixes may have unblocked new issues or introduced cascading problems.
-      Re-review ALL files that were modified in previous phases (apply_fixes, code_changes).
+      Code was changed after discussion — verify correctness and impact.
 
-      1. Get the list of files changed since the review started (git diff or track from context).
-      2. If no files were changed (e.g. discussion resulted in no changes) → `clean`.
-      3. Spawn file-review agents for changed files with `scope: diff`
-         (review only the new changes, not the entire file again).
-         Use the same agent spawning pattern as `review_delegate`.
-      4. Collect reports.
+      1. Run the project's build/compile command. Fix errors and rebuild until green.
 
-      If new issues found → `has_issues` (back to summarize for another cycle).
-      If clean pass (0 new findings) → `clean`.
+      2. Run tests for changed behavior. If no automated tests cover the change,
+         describe what manual testing is needed and ask the user to verify.
+         Cosmetic-only changes → build passing is sufficient.
 
-      **Iteration limit**: check context key `re_review_count`. If >= 3, transition
-      `clean` regardless — diminishing returns after 3 cycles. Otherwise, increment
-      the counter via `context_set(key: "re_review_count", value: "<N+1>")`.
+      3. Cross-file impact check: for each file modified during discussion,
+         identify other files in the original review set that use its changed
+         APIs/symbols. Quickly inspect those call sites for compile-time or
+         obvious behavior breakage. This is NOT a full re-review — only check
+         consumers of what changed.
 
-      The goal is to loop until a clean pass — fixes stabilize and no new issues appear.
+      After verification, transition `complete`. The coding sub-workflow already
+      reviewed the files it modified. Planning produces a plan only — review
+      happens later when the plan is executed via the coding workflow.
     transitions:
-      has_issues: summarize
-      clean: done
+      complete: done
 
   done:
     prompt: "Review complete."

package/templates/file-review.yaml

@@ -26,6 +26,30 @@ states:
          Check if similar code already exists elsewhere that could be reused or unified.
       4. Understand what changed and why.
 
+      Then → transition `done`.
+    transitions:
+      done: determine_authorship
+
+  determine_authorship:
+    task: "Determine code authorship"
+    prompt: |
+      Decide whether this file is user-authored or external/forked/vendored —
+      this gates which personal rules apply downstream (style + architecture).
+
+      Strong signals it is external / forked / vendored (set "false"):
+      - `git remote -v` points to a third-party upstream the user does not control.
+      - README/CLAUDE.md mentions "fork of X", "based on X", "vendored from X".
+      - Path lives under `node_modules/`, `vendor/`, `third_party/`, a haxelib
+        cache, or similar dependency location.
+
+      Save the verdict:
+      - ANY strong external signal present → `context_set({ key: "is_user_authored", value: "false" })`
+      - Otherwise → `context_set({ key: "is_user_authored", value: "true" })`
+
+      Default to "true" when signals are ambiguous — external markers are reliably
+      detectable; user-authored markers are not, so ambiguity falls on the
+      personal-rules side. Do not block on user input.
+
       Then → transition `done`.
     transitions:
       done: build_checklist
@@ -33,7 +57,14 @@ states:
   build_checklist:
     task: "Build style checklist from skills"
     prompt: |
-      Build a concrete style checklist from loaded skills:
+      Check `{{context.is_user_authored}}`. Treat empty as `"true"` (default).
+
+      If `"false"` → personal style rules do not apply. Output:
+      "Skipping personal-style checklist — file is external/forked/vendored.
+      check_style will use only language-agnostic checks."
+      Then → transition `done`.
+
+      Otherwise (user-authored), build a concrete style checklist from loaded skills:
 
       Process each loaded `lang-*` and `preferences-*` skill ONE AT A TIME.
       For each skill:
@@ -123,27 +154,46 @@ states:
   check_style:
     task: "Check code style"
     prompt: |
+      Authorship: `{{context.is_user_authored}}` (set in determine_authorship).
+      Treat empty as `"true"` (default).
+
+      If `"false"` (external / forked / vendored):
+      Skip the personal-style checklist entirely. Match THAT codebase's existing
+      style — a one-line patch into a foreign project should look like it belongs.
+      Only flag issues from the language-agnostic checks below.
+
+      Otherwise (user-authored):
       Go through EVERY item in your style checklist from build_checklist.
+      Personal rules are authoritative — a neighboring file violating the same
+      rule is a bug replicated in both places, not a valid pattern. Flag it.
+      Never dismiss a checklist hit with "the sibling does it this way".
+
       Scope: `diff` = scan only lines in the diff; `full` = scan entire file.
       If a line appears in the diff, it is part of the change and must meet
       current style standards. Report with file:line.
 
-      Additionally check:
+      Language-agnostic checks (apply regardless of authorship):
       - [ ] Missing type annotations: if a variable/field/parameter has no explicit type
             and adding one would improve clarity, recommend it — but ONLY after you find
             the actual type definition in the codebase (via Grep/Read). Never guess types.
             Use short type names + import, not fully qualified paths (e.g. `MyClass`,
             not `com.package.MyClass`) — unless a name conflict or conditional compilation
             requires the full path (check loaded lang/preferences skills for specifics).
-      - [ ] Naming: consistent with conventions in neighboring files
+      - [ ] Naming: consistent with the conventions of THIS codebase (the user's own
+            for user-authored, the upstream's for external).
       - [ ] Member ordering: new fields and methods must respect class member order
             (constants → public vars → private vars → constructor → instance methods →
             static methods). Check that added code is in the right section, not just
             appended next to related code.
       - [ ] Duplication: does this duplicate existing code? Search the codebase.
-      - [ ] Dead code: unused imports, commented-out code (dead guards checked in check_correctness)
+      - [ ] Dead code: unused imports, commented-out code (dead guards checked in check_correctness).
+            Imports used only inside conditional-compilation blocks are dead in
+            the other branches — reference such symbols via fully qualified name
+            inside the conditional block instead of adding a top-level import.
       - [ ] Complexity: overly nested logic, functions doing too many things
-      - [ ] Consistency: does new code follow patterns in the same module?
+      - [ ] Consistency: does new code follow patterns in the same module of THIS
+            codebase? (For user-authored code, this means the user's own conventions —
+            not a license to replicate violations from sibling files.)
 
       Then → transition `done`.
     transitions:
@@ -152,17 +202,24 @@ states:
   check_architecture:
     task: "Check architecture"
     prompt: |
-      Check structural quality (scope: `diff` = changed code, `full` = entire file):
+      Authorship: `{{context.is_user_authored}}` (set in determine_authorship).
+      Treat empty as `"true"` (default).
+
+      Check structural quality (scope: `diff` = changed code, `full` = entire file).
+
+      Language-agnostic checks (apply regardless of authorship):
       - [ ] Unnecessary indirection: wrapper classes/methods that just forward calls
       - [ ] Dead abstractions: interface with one implementation, base class with one subclass
       - [ ] God class: file doing too many unrelated things — should it be split?
       - [ ] Overcomplicated: deep inheritance or nesting that could be flattened
       - [ ] Wrong level: logic placed in the wrong layer (UI doing data work, model doing display)
       - [ ] Stale patterns: old patterns that predate current codebase conventions
+      - [ ] Complexity without pain: abstractions, patterns, or layers added for hypothetical future needs
+
+      Architecture-skill checks (skip ONLY when `is_user_authored` is `"false"`):
       - [ ] Initialization in parent: parent manually triggers component's internal setup — should be inside the component
       - [ ] Serialization in runtime state: serialize/deserialize mixed into state classes — should be separate
       - [ ] Event re-dispatch duplication: re-dispatched event carries fields that duplicate event.target
-      - [ ] Complexity without pain: abstractions, patterns, or layers added for hypothetical future needs
 
       Only flag real simplification opportunities — don't invent hypothetical improvements.