@event4u/agent-config 1.31.0 → 1.32.0

package/docs/contracts/file-ownership-matrix.json

@@ -2046,6 +2046,54 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge-two-stage.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-competitively.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-parallel.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-steps.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-worktrees.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/skills/subagent-orchestration/prompts/judge-with-debate.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/systematic-debugging/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2088,6 +2136,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/threat-modeling/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -6840,6 +6894,20 @@
       "via": "body_link",
       "depth": 1
     },
+    {
+      "source": ".agent-src.uncompressed/skills/judge-test-coverage/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/judge-test-coverage/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/laravel-horizon/SKILL.md",
       "target": ".agent-src.uncompressed/skills/jobs-events/SKILL.md",
@@ -7197,6 +7265,27 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/pest-testing/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/test-driven-development/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pest-testing/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pest-testing/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/php-coder/SKILL.md",
       "target": ".agent-src.uncompressed/skills/php-coder/SKILL.md",
@@ -7372,6 +7461,20 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/quality-tools/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/quality-tools/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/react-native-setup/SKILL.md",
       "target": ".agent-src.uncompressed/skills/react-native-setup/SKILL.md",
@@ -8060,11 +8163,186 @@
     },
     {
       "source": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/using-git-worktrees/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge-two-stage.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-competitively.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-parallel.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-steps.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-worktrees.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/README.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/judge-with-debate.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge-two-stage.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge-two-stage.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge-two-stage.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-and-judge.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-competitively.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-competitively.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-competitively.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-parallel.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-parallel.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-parallel.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-steps.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-steps.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-steps.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-worktrees.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-worktrees.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-worktrees.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/do-in-worktrees.md",
       "target": ".agent-src.uncompressed/skills/using-git-worktrees/SKILL.md",
       "type": "READ_ONLY",
       "via": "body_link",
       "depth": 1
     },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/judge-with-debate.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/judge-with-debate.md",
+      "target": ".agent-src.uncompressed/skills/subagent-orchestration/prompts/judge-with-debate.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/skills/systematic-debugging/SKILL.md",
       "target": ".agent-src.uncompressed/skills/blast-radius-analyzer/SKILL.md",
@@ -8177,6 +8455,20 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/test-driven-development/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/test-driven-development/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/test-performance/SKILL.md",
       "target": ".agent-src.uncompressed/skills/test-performance/SKILL.md",
@@ -8226,6 +8518,55 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "target": ".agent-src.uncompressed/skills/judge-test-coverage/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "target": ".agent-src.uncompressed/skills/pest-testing/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "target": ".agent-src.uncompressed/skills/quality-tools/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "target": ".agent-src.uncompressed/skills/test-driven-development/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "target": ".agent-src.uncompressed/skills/testing-anti-patterns/process-anti-patterns.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/skills/threat-modeling/SKILL.md",
       "target": ".agent-src.uncompressed/skills/authz-review/SKILL.md",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@event4u/agent-config",
-    "version": "1.31.0",
+    "version": "1.32.0",
     "description": "Shared agent configuration \u2014 skills, rules, commands, guidelines, and templates for AI coding tools",
     "license": "MIT",
     "private": false,

package/scripts/check_bite_sized_granularity.py

@@ -0,0 +1,99 @@
+#!/usr/bin/env python3
+"""Bite-sized task granularity gate for structural roadmaps (P1.5).
+
+Adopted from `obra/superpowers` `writing-plans/SKILL.md` § Task Structure +
+§ No Placeholders (v5.1.0). Complexity-gating is our addition (Council
+Round 1, Q4) — only roadmaps tagged `complexity: structural` in frontmatter
+are subject to the granularity rules; `complexity: lightweight` skips.
+
+Public API (stdlib-only):
+
+    read_complexity(text)            -> 'structural' | 'lightweight' | None
+    scan_placeholders(text)          -> list[Placeholder]
+    check_granularity(text)          -> Result(complexity, gated, violations)
+
+`gated` is True only when `complexity == 'structural'`. Violations are
+empty when the gate is not active, regardless of placeholder presence.
+
+The CI contract for P1.5 is the pytest harness in
+`tests/test_bite_sized_granularity.py`; this module is the test surface.
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass, field
+
+PLACEHOLDER_PATTERNS: tuple[tuple[str, re.Pattern[str]], ...] = (
+    ("angle-placeholder", re.compile(r"<[a-z][a-z0-9 _\-/]*>", re.IGNORECASE)),
+    ("todo", re.compile(r"\bTODO\b")),
+    ("fixme", re.compile(r"\bFIXME\b")),
+    ("xxx", re.compile(r"\bXXX\b")),
+    ("tbd", re.compile(r"\btbd\b", re.IGNORECASE)),
+    ("triple-question", re.compile(r"\?\?\?")),
+)
+
+COMPLEXITY_PAT = re.compile(
+    r"^complexity:\s*(lightweight|structural)\s*$", re.MULTILINE
+)
+
+
+@dataclass(frozen=True)
+class Placeholder:
+    kind: str
+    line: int
+    text: str
+
+
+@dataclass
+class Result:
+    complexity: str | None
+    gated: bool
+    violations: list[Placeholder] = field(default_factory=list)
+
+
+def _frontmatter(text: str) -> str:
+    if not text.startswith("---\n"):
+        return ""
+    end = text.find("\n---\n", 4)
+    return text[4:end] if end != -1 else ""
+
+
+def read_complexity(text: str) -> str | None:
+    """Return the `complexity:` value from the roadmap frontmatter, or None."""
+    fm = _frontmatter(text)
+    if not fm:
+        return None
+    m = COMPLEXITY_PAT.search(fm)
+    return m.group(1) if m else None
+
+
+def scan_placeholders(text: str) -> list[Placeholder]:
+    """Return every placeholder hit in task-bullet lines (`- [ ]` / `- [x]`)."""
+    hits: list[Placeholder] = []
+    for line_no, line in enumerate(text.splitlines(), start=1):
+        stripped = line.lstrip()
+        if not stripped.startswith(("- [ ]", "- [x]", "- [/]", "- [-]")):
+            continue
+        for kind, pat in PLACEHOLDER_PATTERNS:
+            if pat.search(line):
+                hits.append(Placeholder(kind=kind, line=line_no, text=line.rstrip()))
+                break
+    return hits
+
+
+def check_granularity(text: str) -> Result:
+    """Run the granularity gate.
+
+    Structural roadmaps fail on any placeholder hit in task bullets.
+    Lightweight or untagged roadmaps skip the gate (gated=False) and
+    return an empty violation list even when placeholders are present.
+    """
+    complexity = read_complexity(text)
+    gated = complexity == "structural"
+    if not gated:
+        return Result(complexity=complexity, gated=False, violations=[])
+    return Result(
+        complexity=complexity,
+        gated=True,
+        violations=scan_placeholders(text),
+    )