@event4u/agent-config 2.6.1 → 2.8.0

package/scripts/schemas/command.schema.json

@@ -12,6 +12,11 @@
       "pattern": "^[a-z][a-z0-9-]*(:[a-z][a-z0-9-]*)?$",
       "$comment": "Top-level commands use the bare slug (`commit`). Nested cluster commands under `commands/<cluster>/<sub>.md` use the colon form (`council:default`) to mirror Claude Code's `/cluster:sub` rendering. Directory slug for `.claude/skills/` is the hyphenated form (`council-default`), generated by compress.py."
     },
+    "tier": {
+      "type": "integer",
+      "enum": [0, 1, 2],
+      "description": "Command-surface tier per docs/contracts/command-surface-tiers.md. 0 = daily-driver (rendered in default `./agent-config --help`), 1 = power-user (rendered with `--tier=1`), 2 = maintenance/internal (rendered only with `--tier=all`). Default for new commands is 2 — promotion is gated by ADR criteria, never by author preference."
+    },
     "description": {
       "type": "string",
       "minLength": 1,

package/scripts/schemas/persona.schema.json

@@ -26,6 +26,11 @@
       "type": "string",
       "enum": ["core", "specialist"]
     },
+    "wing": {
+      "type": "integer",
+      "enum": [1, 2, 3, 4],
+      "description": "Cognition wing per docs/contracts/package-self-orientation.md § The four wings. Optional. Raises the specialist size cap (persona-schema § 4)."
+    },
     "mode": {
       "type": "string",
       "enum": ["developer", "reviewer", "tester", "product-owner", "incident", "planner"]

package/scripts/schemas/skill.schema.json

@@ -72,9 +72,9 @@
       "uniqueItems": true,
       "items": {
         "type": "string",
-        "enum": ["product", "team", "repo"]
+        "enum": ["product", "team", "repo", "channel-stage", "funnel-stage", "customer-segment"]
       },
-      "description": "Senior-skill opt-in for the tri-slot context spine. Declares which slots under agents/context-spine/ the skill expects to read (product, team, repo). Council Q1 (KEEP-3) locks the slot count at 3; additions require ≥ 2 citing skills + ADR per docs/contracts/context-spine.md § 5."
+      "description": "Senior-skill opt-in for the context spine. Declares which slots under agents/context-spine/ the skill expects to read. Cross-wing slots (product, team, repo) are locked at 3 by council Q1 (KEEP-3); wing-scoped slots (channel-stage, funnel-stage, customer-segment — Wing-3 GTM) follow the per-wing ADR track in docs/contracts/context-spine.md § 5. Wing-3 slots authorized by docs/contracts/adr-gtm-context-spine.md."
     },
     "execution": {
       "type": "object",

package/scripts/skill_linter.py

@@ -57,6 +57,15 @@ REQUIRED_PERSONA_SECTIONS = REQUIRED_PERSONA_SECTIONS_CORE
 VALID_PERSONA_TIERS = {"core", "specialist"}
 # Locked in docs/contracts/persona-schema.md § 4: core ≤ 120, specialist ≤ 100.
 PERSONA_LINE_BUDGETS = {"core": 120, "specialist": 100}
+# Wing-scoped overrides — Wing-3 (GTM) and Wing-4 (Money/Strategy/Ops) carry
+# denser cognition (funnel × channel × lifecycle, or finance × org × strategy)
+# than Wing-1/2 specialists, so the line cap rises to keep the seven-section
+# spine intact without amputating workflows. Persona-schema.md § 4 wing matrix.
+VALID_PERSONA_WINGS = {1, 2, 3, 4}
+PERSONA_LINE_BUDGETS_BY_WING = {
+    ("specialist", 3): 140,
+    ("specialist", 4): 140,
+}
 
 
 REQUIRED_SKILL_SECTIONS = [
@@ -161,6 +170,47 @@ VALID_EXECUTION_HANDLERS = {"none", "shell", "php", "node", "internal"}
 VALID_EXECUTION_SAFETY_MODES = {"strict"}
 VALID_EXECUTION_FIELDS = {"type", "handler", "timeout_seconds", "safety_mode", "allowed_tools", "command"}
 
+# --- Wing-3 GTM cognition-boundary patterns (council Q7 / iter-2 OQ3) ---
+# Triggered only when a skill's context_spine declares a Wing-3 slot.
+# See docs/contracts/adr-gtm-context-spine.md and
+# agents/roadmaps/road-to-gtm-and-growth.md § G2.
+WING3_SPINE_SLOTS = {"channel-stage", "funnel-stage", "customer-segment"}
+
+CONTEXT_SPINE_INLINE_PATTERN = re.compile(
+    r'^context_spine:\s*\[(.*?)\]\s*$', re.MULTILINE
+)
+
+# agent-operability: external SaaS URLs the agent would have to auth against
+WING3_SAAS_URL_PATTERN = re.compile(
+    r"https?://[\w.-]*\.(salesforce|hubspot|marketo|pardot|mailchimp|"
+    r"intercom|amplitude|mixpanel|segment|klaviyo|sendgrid|mailgun|"
+    r"pendo|gong|outreach|salesloft|apollo)\.(com|io)\b",
+    re.IGNORECASE,
+)
+
+# vendor-independence: brand / SDK / platform slugs that lock cognition
+WING3_VENDOR_BLACKLIST = re.compile(
+    r"\b(salesforce|hubspot|marketo|pardot|mailchimp|intercom|drift|"
+    r"klaviyo|sendgrid|mailgun|amplitude|mixpanel|pendo|gong|"
+    r"outreach\.io|salesloft|apollo\.io|zendesk|freshworks)\b",
+    re.IGNORECASE,
+)
+
+# transferability: stack-locked tooling instructions
+WING3_STACK_LOCKED_PATTERN = re.compile(
+    r"\b(npm install|pip install|composer require|gem install|"
+    r"cargo add|yarn add|pnpm add|bundle add)\s+[\w@/.-]+",
+    re.IGNORECASE,
+)
+
+# channel-agnosticism: channel-specific tactical prescriptions
+WING3_CHANNEL_TACTIC_PATTERN = re.compile(
+    r"\b(email subject line|tweet length|linkedin (post|ad)|"
+    r"facebook ad|google ads?|tiktok (post|video)|instagram (post|reel)|"
+    r"sms character limit|cold email template)\b",
+    re.IGNORECASE,
+)
+
 
 @dataclass
 class Issue:
@@ -605,6 +655,11 @@ def lint_skill(path: Path, text: str) -> LintResult:
         if tier_match and tier_match.group(1) == "senior":
             issues.extend(lint_senior_tier_blocks(text))
 
+        # --- Wing-3 GTM cognition-boundary check (council Q7 / adr-gtm-context-spine.md) ---
+        spine_slots = parse_context_spine(frontmatter)
+        if spine_slots and any(s in WING3_SPINE_SLOTS for s in spine_slots):
+            issues.extend(lint_wing3_boundaries(text))
+
     procedure_block = find_procedure_block(text)
     if procedure_block is not None:
         if not procedure_block:
@@ -993,6 +1048,98 @@ def lint_senior_tier_blocks(text: str) -> List[Issue]:
     return issues
 
 
+def parse_context_spine(frontmatter: str) -> Optional[List[str]]:
+    """Parse `context_spine:` from frontmatter.
+
+    Supports the inline form `context_spine: [a, b, c]` (most skills) and
+    the block form via `_parse_yaml_list`. Returns the slot list, ``[]``
+    for an explicitly empty array, or ``None`` if the key is absent.
+    """
+    match = CONTEXT_SPINE_INLINE_PATTERN.search(frontmatter)
+    if match is not None:
+        inner = match.group(1).strip()
+        if not inner:
+            return []
+        return [s.strip().strip('"').strip("'") for s in inner.split(",") if s.strip()]
+    block = _parse_yaml_list(frontmatter, "context_spine")
+    return block
+
+
+def _strip_wing3_carve_outs(text: str) -> str:
+    """Remove fenced code, inline backticks, the ``## Do NOT`` block, and
+    ``**WHEN NOT to use this**`` bullets so legitimate citations of vendor
+    names (as off-scope examples) do not trip Wing-3 boundary checks.
+    """
+    text = re.sub(r"```[^\n]*\n.*?```", "", text, flags=re.DOTALL)
+    text = re.sub(r"`[^`]+`", "", text)
+    text = re.sub(
+        r"^##\s+Do NOT\s*$.*?(?=^##\s+|\Z)",
+        "", text, flags=re.MULTILINE | re.DOTALL,
+    )
+    text = re.sub(
+        r"\*\*WHEN NOT to use this\*\*.*?(?=\*\*WHEN|^##\s+|\Z)",
+        "", text, flags=re.DOTALL | re.IGNORECASE,
+    )
+    return text
+
+
+def lint_wing3_boundaries(text: str) -> List[Issue]:
+    """Four Wing-3 GTM cognition-boundary checks.
+
+    Triggered when a skill's ``context_spine`` declares at least one
+    Wing-3 slot (channel-stage, funnel-stage, customer-segment). Enforces
+    council Q7 / iter-2 OQ3 verdict that GTM cognition stays:
+
+    - **agent-operability** — no external SaaS URLs the agent would auth against.
+    - **vendor-independence** — no platform / SDK / brand slugs.
+    - **transferability** — no stack-locked tooling instructions.
+    - **channel-agnosticism** — no channel-specific tactical prescriptions.
+
+    Carve-outs: fenced code, inline backticks, the ``## Do NOT`` block,
+    and ``**WHEN NOT to use this**`` lists — so authors can cite a vendor
+    as off-scope without tripping the linter.
+    """
+    issues: List[Issue] = []
+    body = _strip_wing3_carve_outs(text)
+
+    match = WING3_SAAS_URL_PATTERN.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing3_agent_operability",
+            f"Wing-3 skill cites external SaaS URL `{match.group(0)}` outside "
+            f"carve-outs — cognition skills must operate without SaaS auth "
+            f"(council Q7 boundary)",
+        ))
+
+    match = WING3_VENDOR_BLACKLIST.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing3_vendor_independence",
+            f"Wing-3 skill names vendor `{match.group(0)}` outside carve-outs "
+            f"— keep cognition vendor-agnostic (council Q7 boundary)",
+        ))
+
+    match = WING3_STACK_LOCKED_PATTERN.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing3_transferability",
+            f"Wing-3 skill includes stack-locked instruction `{match.group(0)}` "
+            f"outside carve-outs — cognition should transfer across stacks "
+            f"(council Q7 boundary)",
+        ))
+
+    match = WING3_CHANNEL_TACTIC_PATTERN.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing3_channel_agnosticism",
+            f"Wing-3 skill prescribes channel-specific tactic "
+            f"`{match.group(0)}` outside carve-outs — keep cognition "
+            f"channel-agnostic (council Q7 boundary)",
+        ))
+
+    return issues
+
+
 def lint_execution_metadata(execution: dict) -> List[Issue]:
     """Validate the execution block of a skill."""
     issues: List[Issue] = []
@@ -1436,6 +1583,27 @@ def lint_persona(path: Path, text: str) -> LintResult:
             f"Persona tier `{parsed['tier']}` must be one of {sorted(VALID_PERSONA_TIERS)}",
         ))
 
+    # wing — optional; when present must be one of {1,2,3,4} (per
+    # docs/contracts/package-self-orientation.md § The four wings).
+    wing_match = re.search(r'^wing:\s*"?(\d+)"?\s*$', frontmatter, re.MULTILINE)
+    if wing_match:
+        try:
+            wing_value = int(wing_match.group(1))
+            if wing_value in VALID_PERSONA_WINGS:
+                parsed["wing"] = wing_value
+            else:
+                issues.append(Issue(
+                    "error",
+                    "invalid_wing",
+                    f"Persona wing `{wing_value}` must be one of {sorted(VALID_PERSONA_WINGS)}",
+                ))
+        except ValueError:
+            issues.append(Issue(
+                "error",
+                "invalid_wing",
+                f"Persona wing `{wing_match.group(1)}` must be an integer 1–4",
+            ))
+
     # description length
     if "description" in parsed and len(parsed["description"]) > 160:
         issues.append(Issue(
@@ -1473,15 +1641,21 @@ def lint_persona(path: Path, text: str) -> LintResult:
                 f"Persona has {bullet_count} unique questions (target ≥ 3)",
             ))
 
-    # Size budget by tier
+    # Size budget by tier — wing-overrides apply when the persona declares a
+    # `wing:` field; defaults to the tier baseline otherwise.
     if "tier" in parsed and parsed["tier"] in PERSONA_LINE_BUDGETS:
-        budget = PERSONA_LINE_BUDGETS[parsed["tier"]]
+        tier_value = parsed["tier"]
+        wing_value = parsed.get("wing")
+        budget = PERSONA_LINE_BUDGETS_BY_WING.get(
+            (tier_value, wing_value), PERSONA_LINE_BUDGETS[tier_value]
+        )
         line_count = len(text.splitlines())
         if line_count > budget:
+            scope = f"{tier_value}" if wing_value is None else f"{tier_value}, wing {wing_value}"
             issues.append(Issue(
                 "warning",
                 "size_budget",
-                f"Persona has {line_count} lines ({parsed['tier']} budget ≤ {budget})",
+                f"Persona has {line_count} lines ({scope} budget ≤ {budget})",
             ))
 
     # H1 heading