@event4u/agent-config 2.25.0 → 2.26.0

package/scripts/lint_framework_leakage_allowlist.json

@@ -0,0 +1,476 @@
+{
+  "version": 1,
+  "_doc": "Each entry: { file: relative path from repo root, lines: [int,...] | \"*\" for whole file, reason: short justification }. Use sparingly \u2014 first ask whether the file should be neutralized instead.",
+  "entries": [
+    {
+      "file": ".agent-src.uncompressed/skills/using-git-worktrees/SKILL.md",
+      "lines": [
+        130,
+        131,
+        132,
+        152
+      ],
+      "reason": "Multi-stack package-manager comparison table"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/refine-prompt/SKILL.md",
+      "lines": [
+        88,
+        90,
+        92,
+        137,
+        180,
+        269
+      ],
+      "reason": "Project-detection enumeration listing all supported stacks"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/onboard.md",
+      "lines": [
+        220,
+        221,
+        224
+      ],
+      "reason": "Stack-detection enumeration in onboard flow"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/analyze-reference-repo.md",
+      "lines": [
+        62
+      ],
+      "reason": "Manifest-file enumeration across ecosystems"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/optimize/augmentignore.md",
+      "lines": "*",
+      "reason": "Per-stack augmentignore rules \u2014 by definition stack-aware"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/optimize/rtk.md",
+      "lines": "*",
+      "reason": "Per-tool rtk filter detection \u2014 by definition tool-aware"
+    },
+    {
+      "file": ".agent-src.uncompressed/rules/framework-neutrality-in-generic-skills.md",
+      "lines": "*",
+      "reason": "The neutrality rule itself enumerates the forbidden tokens to forbid them"
+    },
+    {
+      "file": ".agent-src.uncompressed/rules/roadmap-ci-steps-policy.md",
+      "lines": [
+        4,
+        11,
+        12,
+        66
+      ],
+      "reason": "Roadmap CI policy explicitly enumerates forbidden commands and trigger keywords"
+    },
+    {
+      "file": ".agent-src.uncompressed/rules/architecture.md",
+      "lines": [
+        19,
+        20,
+        26,
+        27,
+        62
+      ],
+      "reason": "Stack-routing pointers and cross-stack enumeration of validation/handler primitives"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/api-endpoint/SKILL.md",
+      "lines": [
+        41,
+        58
+      ],
+      "reason": "Cross-stack validation primitive enumeration and pointer to laravel-api-endpoint carve-out"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/code-review/SKILL.md",
+      "lines": [
+        40,
+        41,
+        42,
+        49,
+        62,
+        63,
+        74,
+        83,
+        85,
+        87,
+        219
+      ],
+      "reason": "Cross-stack code-review checklist enumerates handler shape, validation, authz, ORM, escaping per framework"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/security/SKILL.md",
+      "lines": [
+        16,
+        23,
+        27,
+        28,
+        37,
+        41,
+        48,
+        58,
+        76
+      ],
+      "reason": "Cross-stack security review enumerates auth primitives (Policies, voters, guards, middleware) and config paths"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/verify-completion-evidence/SKILL.md",
+      "lines": [
+        53,
+        54,
+        55,
+        100,
+        177
+      ],
+      "reason": "Evidence-mapping table enumerates the type-checker / linter / refactor tool per stack including PHPStan, Rector, ECS"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/tests/execute.md",
+      "lines": "*",
+      "reason": "Multi-stack test runner dispatch (Pest/PHPUnit/Jest/pytest/cargo-test) \u2014 enumerates per-stack commands by design"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/tests/create.md",
+      "lines": "*",
+      "reason": "Multi-stack test framework selection \u2014 enumerates Pest/PHPUnit/Jest/pytest options by design"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/module/explore.md",
+      "lines": "*",
+      "reason": "Multi-stack module detection (Laravel HMVC / Symfony bundles / DDD-lite) \u2014 enumerates per-stack patterns by design"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/package-test.md",
+      "lines": "*",
+      "reason": "Multi-stack package linking (composer/npm/pip/cargo/go) \u2014 declared in skills frontmatter"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/package-reset.md",
+      "lines": "*",
+      "reason": "Multi-stack package reset (composer/npm) \u2014 declared in skills frontmatter"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/dependency-upgrade/SKILL.md",
+      "lines": "*",
+      "reason": "Multi-stack dependency upgrade examples (composer/npm/pip) \u2014 declared stack-agnostic in description"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/fe-design/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack frontend design enumerates Blade/Livewire/Flux/React-shadcn for stack-routing dispatch"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/code-refactoring/SKILL.md",
+      "lines": "*",
+      "reason": "Multi-stack refactoring examples (Laravel app/Modules + Nx + mono-repo) per stack-detection"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/database/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack ORM enumeration (Eloquent/Doctrine) with carve-out pointers"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/project-analyze.md",
+      "lines": "*",
+      "reason": "Stack-detection templates show per-framework default outputs (Laravel/Standalone PHP/etc.) \u2014 multi-stack by design"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/commit.md",
+      "lines": "*",
+      "reason": "Example commit block uses Laravel paths from a reference project; the procedure itself is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/test-driven-development/SKILL.md",
+      "lines": "*",
+      "reason": "Multi-stack TDD examples \u2014 PHP/Pest and TypeScript/Jest sections both present"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/context-authoring/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack context examples enumerate per-stack auth/ORM primitives"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/migration-architect/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack migration architecture enumerates laravel-migration/Doctrine/Alembic/Prisma carve-outs"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/api-design/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack API design enumerates per-framework validation/handler primitives"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/error-handling-patterns/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack error handling enumerates exceptions/Result/Maybe per language"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/security-audit/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack security audit enumerates per-stack auth/ORM/escaping primitives"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/skill-writing/SKILL.md",
+      "lines": "*",
+      "reason": "Skill-writing references PHPStan/Pest as examples drawn from this package's own dogfooded skills"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/systematic-debugging/SKILL.md",
+      "lines": "*",
+      "reason": "Debugging examples drawn from PHP project; the procedure is stack-agnostic (reproduce \u2192 isolate \u2192 hypothesize \u2192 verify)"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "lines": "*",
+      "reason": "Anti-pattern examples drawn from Pest/PHPUnit; the iron laws apply to all test frameworks"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "lines": "*",
+      "reason": "Anti-pattern examples drawn from Pest; the rules apply to all test frameworks"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/api-testing/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack API testing enumerates Pest/PHPUnit/Jest/pytest"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/agent-docs-writing/SKILL.md",
+      "lines": "*",
+      "reason": "Agent-docs examples reference PHPStan/Pest as this package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/bug-analyzer/SKILL.md",
+      "lines": "*",
+      "reason": "Bug-analysis examples drawn from PHP project; the procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/defense-in-depth/SKILL.md",
+      "lines": "*",
+      "reason": "Defense-in-depth examples enumerate per-stack validation primitives"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/existing-ui-audit/SKILL.md",
+      "lines": "*",
+      "reason": "UI-audit references Blade/Livewire/Flux/React-shadcn as stack-routing options"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/form-handler/SKILL.md",
+      "lines": "*",
+      "reason": "Form-handling examples enumerate per-framework validation/submission primitives"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/learning-to-rule-or-skill/SKILL.md",
+      "lines": "*",
+      "reason": "Examples drawn from PHP/Pest as this package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/markitdown/SKILL.md",
+      "lines": "*",
+      "reason": "Markitdown skill references Composer/pip as install paths"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/mcp/SKILL.md",
+      "lines": "*",
+      "reason": "MCP examples enumerate Python/Node/PHP server implementations"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/mcp-builder/SKILL.md",
+      "lines": "*",
+      "reason": "MCP-builder enumerates Python FastMCP and Node TypeScript SDK with examples per language"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/readme-writing/SKILL.md",
+      "lines": "*",
+      "reason": "README examples reference composer.json/package.json/pyproject.toml per ecosystem"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/ui-component-architect/SKILL.md",
+      "lines": "*",
+      "reason": "Cross-stack UI component architecture enumerates Blade/Livewire/React"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/bug-investigate.md",
+      "lines": "*",
+      "reason": "Bug-investigate examples reference PHPStan/Pest from package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/commit/in-chunks.md",
+      "lines": "*",
+      "reason": "Commit-in-chunks examples drawn from Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/compress.md",
+      "lines": "*",
+      "reason": "Compress command references this package's own .agent-src.uncompressed Laravel-tooling examples"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/council/default.md",
+      "lines": "*",
+      "reason": "AI Council examples reference PHP/Laravel from package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/fix/pr-bot-comments.md",
+      "lines": "*",
+      "reason": "PR-comment fix examples reference Rector/PHPStan from package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/fix/pr-developer-comments.md",
+      "lines": "*",
+      "reason": "PR developer-comment fix examples reference PHP review patterns from package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/quality-fix.md",
+      "lines": "*",
+      "reason": "Quality-fix dispatches per stack (PHPStan/ECS/Rector for PHP, tsc/biome for JS) \u2014 multi-stack by design"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/roadmap/create.md",
+      "lines": "*",
+      "reason": "Roadmap creation examples drawn from this package's own Laravel-tooling work"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/rule-compliance-audit.md",
+      "lines": "*",
+      "reason": "Rule-audit examples reference this package's own rule corpus including PHP/Laravel rules"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/blast-radius-analyzer/SKILL.md",
+      "lines": "*",
+      "reason": "Blast-radius examples drawn from Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/data-flow-mapper/SKILL.md",
+      "lines": "*",
+      "reason": "Data-flow examples drawn from Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/file-editor/SKILL.md",
+      "lines": "*",
+      "reason": "File-editor references PHP filename heuristic for IDE detection"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/launch-readiness/SKILL.md",
+      "lines": "*",
+      "reason": "Launch-readiness checklist references Laravel Pulse/Horizon as monitoring options"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/logging-monitoring/SKILL.md",
+      "lines": "*",
+      "reason": "Logging-monitoring enumerates per-stack log shippers including Laravel channels"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/memory-consolidation/SKILL.md",
+      "lines": "*",
+      "reason": "Memory examples drawn from PHP/Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/performance/SKILL.md",
+      "lines": "*",
+      "reason": "Performance examples drawn from Laravel reference project; principles are stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/po-discovery/SKILL.md",
+      "lines": "*",
+      "reason": "PO-discovery examples drawn from Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/project-analyzer/SKILL.md",
+      "lines": "*",
+      "reason": "Project-analyzer skill enumerates vendor/ and node_modules/ as third-party paths to exclude"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/readme-reviewer/SKILL.md",
+      "lines": "*",
+      "reason": "README reviewer enumerates composer.json/package.json/pyproject.toml per ecosystem"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/repomix-packer/SKILL.md",
+      "lines": "*",
+      "reason": "Repomix examples drawn from package's own Laravel toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/roadmap-management/SKILL.md",
+      "lines": "*",
+      "reason": "Roadmap examples drawn from this package's own framework-neutrality work"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/rule-writing/SKILL.md",
+      "lines": "*",
+      "reason": "Rule-writing examples reference this package's own dogfooded PHP/Laravel rules"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/sentry-integration/SKILL.md",
+      "lines": "*",
+      "reason": "Sentry integration examples drawn from Laravel reference project"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/skill-reviewer/SKILL.md",
+      "lines": "*",
+      "reason": "Skill-reviewer references this package's own dogfooded PHP/Laravel skills"
+    },
+    {
+      "file": ".agent-src.uncompressed/skills/upstream-contribute/SKILL.md",
+      "lines": "*",
+      "reason": "Upstream-contribute examples drawn from this package's own Laravel-tooling contributions"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/agents/init.md",
+      "lines": "*",
+      "reason": "Agents-init references PHP/Laravel as one detected stack"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/challenge-me/vision.md",
+      "lines": "*",
+      "reason": "Challenge-me examples drawn from PHP/Laravel reference project"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/challenge-me/with-docs.md",
+      "lines": "*",
+      "reason": "Challenge-me examples drawn from PHP/Laravel reference project"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/feature/dev.md",
+      "lines": "*",
+      "reason": "Feature-dev examples drawn from Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/jira-ticket.md",
+      "lines": "*",
+      "reason": "Jira-ticket examples drawn from Laravel reference project; procedure is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/override/create.md",
+      "lines": "*",
+      "reason": "Override-create examples drawn from this package's own Laravel-rule overrides"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/project-health.md",
+      "lines": "*",
+      "reason": "Project-health examples drawn from Laravel reference project; check itself is stack-agnostic"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/sync-agent-settings.md",
+      "lines": "*",
+      "reason": "Sync-agent-settings references PHP/Laravel from package's dogfooded toolchain"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/sync-gitignore.md",
+      "lines": "*",
+      "reason": "Sync-gitignore enumerates per-stack ignore patterns including PHP/Composer"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/sync-gitignore/fix.md",
+      "lines": "*",
+      "reason": "Sync-gitignore-fix enumerates per-stack ignore patterns"
+    },
+    {
+      "file": ".agent-src.uncompressed/commands/upstream-contribute.md",
+      "lines": "*",
+      "reason": "Upstream-contribute examples drawn from this package's own Laravel-tooling contributions"
+    }
+  ]
+}

package/scripts/measure_augment_budget.py

@@ -42,6 +42,12 @@ RULES_DIR = REPO_ROOT / ".augment" / "rules"
 TREND_FILE = REPO_ROOT / "agents" / ".augment-budget-history.jsonl"
 
 # Augment workspace-guidelines ceiling — empirical 2026-05-08.
+# TOTAL_CAP is the hard ceiling Augment itself enforces. FAIL_THRESHOLD is the
+# soft safety-margin gate (0.95). When a branch breaches it, the discipline
+# is: DO NOT loosen the threshold — invoke the `rule-refactor` skill, which
+# audits all rules for merge / delete / move-to-context / promote-to-skill
+# candidates. Threshold-lift is explicitly rejected as a tool-shape anti-
+# pattern (see the validation-budget rule). Only an ADR may grow the cap.
 TOTAL_CAP = 49_512
 WARN_THRESHOLD = 0.85
 FAIL_THRESHOLD = 0.95

package/scripts/schemas/command.schema.json

@@ -67,6 +67,11 @@
       "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
       "description": "Semver release in which this command became a shim (e.g. '1.15.0')."
     },
+    "framework": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Framework carve-out marker. Set on commands that are 100% coupled to one stack (e.g. `framework: laravel` on update-form-request-messages). Generic, multi-stack commands MUST omit this key. Routed by .agent-src.uncompressed/rules/framework-neutrality-in-generic-skills.md (Tier 2)."
+    },
     "council_depth": {
       "type": "string",
       "enum": ["deep"],

package/scripts/schemas/skill.schema.json

@@ -35,6 +35,11 @@
       "type": "string",
       "pattern": "^[a-z][a-z0-9-]*$"
     },
+    "framework": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Framework carve-out marker. Set on skills that are 100% coupled to one stack (e.g. `framework: laravel` on laravel-* skills). Generic, multi-stack skills MUST omit this key. Routed by .agent-src.uncompressed/rules/framework-neutrality-in-generic-skills.md (Tier 2)."
+    },
     "personas": {
       "type": "array",
       "items": {

package/scripts/skill_linter.py

@@ -472,6 +472,21 @@ def _command_delegation_signal(text: str, frontmatter: Optional[str]) -> bool:
     return False
 
 
+def _strip_markdown_for_check(text: str) -> str:
+    """Strip fenced code, inline code spans, and markdown links so heuristic
+    regex matches operate on prose only.
+
+    Used by rule-body heuristics whose targets (e.g. ``procedural_rule``)
+    must not flip on legitimate skill pointers like ``[git-workflow](…)``
+    or ``` `skill:symfony-workflow` ```. Frontmatter is handled by the
+    caller via ``text.split("---", 2)[-1]``.
+    """
+    text = re.sub(r"```[^\n]*\n.*?```", "", text, flags=re.DOTALL)
+    text = re.sub(r"`[^`\n]+`", "", text)
+    text = re.sub(r"\[[^\]]*\]\([^)]*\)", "", text)
+    return text
+
+
 def _iron_law_blocks(text: str) -> int:
     """Count fenced blocks that look like verbatim Iron-Law imperatives.
 
@@ -575,10 +590,36 @@ def has_validation_step(procedure_block: str) -> bool:
     return any(signal in lowered for signal in good_signals)
 
 
+_INSPECT_VERB_PATTERN = re.compile(
+    r"\b(?:"
+    # Direct inspection
+    r"inspect|examine|audit|survey"
+    # Read / look
+    r"|read|look\s+at"
+    # Check (word-boundary — matches "check that", "check current", "check what")
+    r"|check"
+    # Review (broad — matches "review existing", "review the failures")
+    r"|review"
+    # Comprehension / orientation
+    r"|understand|identify|analyze|analyse"
+    # Discovery
+    r"|detect|gather|discover"
+    r")\b",
+    re.IGNORECASE,
+)
+
+
 def has_inspect_step(procedure_block: str) -> bool:
-    lowered = procedure_block.lower()
-    inspect_signals = ["inspect", "check current", "review existing", "identify", "analyze"]
-    return any(signal in lowered for signal in inspect_signals)
+    """Return True if the procedure block opens with an inspect / read step.
+
+    Corpus-driven verb list (see docs/contracts/linter-structural-model.md):
+    the first ordered step in a skill procedure should orient the agent in
+    the live system — read existing code, examine current state, detect
+    stack — before mutating anything. Regex uses word boundaries to avoid
+    substring matches inside unrelated words (e.g. ``read`` inside
+    ``already``).
+    """
+    return bool(_INSPECT_VERB_PATTERN.search(procedure_block))
 
 
 def find_vague_validation(text: str) -> list[str]:
@@ -678,8 +719,9 @@ def lint_skill(path: Path, text: str) -> LintResult:
     if skill_name and "-" not in skill_name and len(skill_name) >= 3:
         # Single word without qualifier — likely too generic
         ALLOWED_BARE_NOUNS = {"database", "devcontainer", "docker", "eloquent", "flux", "forecasting",
-                              "grafana", "laravel", "livewire", "mcp", "openapi", "performance",
-                              "security", "terraform", "terragrunt", "traefik", "websocket"}
+                              "grafana", "laravel", "livewire", "markitdown", "mcp", "openapi",
+                              "performance", "security", "terraform", "terragrunt", "traefik",
+                              "websocket"}
         if skill_name.lower() not in ALLOWED_BARE_NOUNS:
             issues.append(Issue("warning", "bare_noun_name",
                                 f"Bare-noun skill name `{skill_name}` — consider adding a qualifier (e.g., `{skill_name}-management`)"))
@@ -1504,9 +1546,20 @@ def lint_rule(path: Path, text: str) -> LintResult:
         if bad_sign in text:
             issues.append(Issue("error", "rule_looks_like_skill", f"Rule contains skill-like section: {bad_sign}"))
 
-    # Exclude frontmatter from procedural check (frontmatter may contain "type")
+    # Procedural-rule heuristic: a rule "looks procedural" only when its own
+    # prose AND its own structure both signal a procedure. We:
+    #   1. Exclude frontmatter (may contain "type", path strings, etc.).
+    #   2. Strip code spans, fenced blocks, and markdown links — so legitimate
+    #      pointers to procedural skills (e.g. `skill:git-workflow`,
+    #      [symfony-workflow](…)) do not flip the keyword count.
+    #   3. Require ≥ 2 keyword occurrences in stripped prose AND ≥ 3 ordered
+    #      steps AND no Iron-Law block — that combination distinguishes a
+    #      mis-classified procedure from a rule that merely references one.
     body = text.split("---", 2)[-1] if frontmatter else text
-    if re.search(r"\b(procedure|workflow)\b", body, re.IGNORECASE):
+    stripped_body = _strip_markdown_for_check(body)
+    kw_count = len(re.findall(r"\b(procedure|workflow)\b", stripped_body, re.IGNORECASE))
+    ordered_steps = len(re.findall(r"^\s*\d+\.\s+", body, re.MULTILINE))
+    if kw_count >= 2 and ordered_steps >= 3 and _iron_law_blocks(text) == 0:
         issues.append(Issue("warning", "procedural_rule", "Rule looks procedural; consider a skill instead"))
 
     return LintResult(

package/scripts/smoke/kernel.sh

@@ -2,9 +2,9 @@
 # scripts/smoke/kernel.sh — kernel-tier smoke (step-11 Phase 3 Step 2).
 #
 # Asserts:
-#   1. router.json lists exactly 9 kernel rules.
+#   1. router.json lists exactly 10 kernel rules.
 #   2. Every kernel rule file exists at .agent-src/rules/<id>.md.
-#   3. 8 of 9 carry at least one Iron-Law fenced block.
+#   3. 9 of 10 carry at least one Iron-Law fenced block.
 #      agent-authority is the dispatch index, exempt from the fence
 #      requirement (docs/contracts/smoke-contracts.md § 3.1).
 #   4. Kernel-bucket char budget breaches ≤ EXPECTED_BREACHES.
@@ -16,8 +16,8 @@
 
 set -euo pipefail
 
-EXPECTED_KERNEL_COUNT=9
-EXPECTED_FENCE_CARRIERS=8
+EXPECTED_KERNEL_COUNT=10
+EXPECTED_FENCE_CARRIERS=9
 EXPECTED_BREACHES=2
 EXEMPT_FROM_FENCE="agent-authority"
 

package/scripts/smoke/router.sh

@@ -2,7 +2,7 @@
 # scripts/smoke/router.sh — router-tier smoke (step-11 Phase 3 Step 3).
 #
 # Asserts router.json structural integrity:
-#   1. 75 ids = 9 kernel + 24 tier_1 + 42 tier_2 (locked count).
+#   1. 68 ids = 10 kernel + 23 tier_1 + 35 tier_2 (locked count).
 #   2. Every id resolves to .agent-src/rules/<id>.md (0 broken).
 #   3. Every routes_to ref resolves through its prefix
 #      (skill:, command:, guideline:, contract:); missing-contract
@@ -15,7 +15,7 @@
 
 set -euo pipefail
 
-EXPECTED_TOTAL_IDS=75
+EXPECTED_TOTAL_IDS=68
 EXPECTED_MISSING_CONTRACTS=2
 
 quiet="${SMOKE_QUIET:-0}"

package/.agent-src/rules/agent-docs.md

@@ -1,20 +0,0 @@
----
-type: "auto"
-tier: "2a"
-description: "Reading, creating, or updating agent documentation, module docs, roadmaps, or AGENTS.md"
-source: package
-triggers:
-  - path_prefix: "agents/"
-  - path_prefix: ".github/copilot-instructions"
-  - keyword: "AGENTS.md"
-  - keyword: "roadmap"
-routes_to:
-  - "skill:agent-docs-writing"
----
-
-# Agent Docs
-
-**Iron Law.** Read agent docs (`AGENTS.md`, `agents/`, module `agents/`) before work; update them after structural changes.
-
-Body migrated to `skill:agent-docs-writing` (per P4 of `road-to-kernel-and-router.md`).
-Trigger-set above activates this routing under the `balanced` and `full` profiles.