@event4u/agent-config 2.7.0 → 2.9.0

package/scripts/agent-config

@@ -62,17 +62,6 @@ Tier 0 — daily-driver (init → sync → validate → work):
                              (Option-A loop; called by the /work command)
   implement-ticket           Drive the work_engine Python engine on a ticket envelope
                              (Option-A loop; called by the /implement-ticket command)
-  first-run                  Guided first-run setup — cost profile, settings, tooling
-  keys:install-anthropic     Install the Anthropic API key for the AI Council
-                             (interactive, /dev/tty only, writes ~/.config/agent-config/anthropic.key 0600)
-  keys:install-openai        Install the OpenAI API key for the AI Council
-                             (interactive, /dev/tty only, writes ~/.config/agent-config/openai.key 0600)
-  council:estimate           Pre-call council cost preview (no API call, no spend)
-                             Usage: council:estimate <question> [--input-mode prompt|roadmap]
-  council:run                Run the council. Requires --confirm to spend.
-                             Usage: council:run <question> --output <path> --confirm
-  council:render             Re-render a saved council responses JSON to markdown
-                             Usage: council:render <responses.json>
   help                       Show this help (default Tier-0; --tier=1|all expands)
   --version, -V              Print package version
 EOF
@@ -110,6 +99,17 @@ Tier 1 — power-user (release shape, audit, migration):
                              Flags: --json | --project=<path>
   migrate                    One-shot migration off legacy composer / npm install paths
                              Flags: --dry-run (detect only)
+  first-run                  Guided first-run setup — cost profile, settings, tooling
+  keys:install-anthropic     Install the Anthropic API key for the AI Council
+                             (interactive, /dev/tty only, writes ~/.config/agent-config/anthropic.key 0600)
+  keys:install-openai        Install the OpenAI API key for the AI Council
+                             (interactive, /dev/tty only, writes ~/.config/agent-config/openai.key 0600)
+  council:estimate           Pre-call council cost preview (no API call, no spend)
+                             Usage: council:estimate <question> [--input-mode prompt|roadmap]
+  council:run                Run the council. Requires --confirm to spend.
+                             Usage: council:run <question> --output <path> --confirm
+  council:render             Re-render a saved council responses JSON to markdown
+                             Usage: council:render <responses.json>
 EOF
   fi
 
@@ -124,6 +124,7 @@ Tier 2 — maintenance / internal (hooks, MCP, memory, telemetry):
                              (one-line MCP server onboarding; idempotent)
   mcp:run                    Run the built-in MCP server over stdio
                              (requires `mcp:setup` first; see docs/mcp-server.md)
+                             (experimental — beta gates: docs/contracts/mcp-beta-criteria.md)
   roadmap:progress           Regenerate agents/roadmaps-progress.md from open roadmaps
   roadmap:progress-check     Fail if agents/roadmaps-progress.md is stale (for CI)
   hooks:install              Install the pre-commit roadmap-progress hook
@@ -161,7 +162,7 @@ EOF
   if [[ "$tier" == "0" ]]; then
     cat <<'EOF'
 
-(Hidden: 9 Tier-1 + 26 Tier-2 commands. Run `./agent-config --help --tier=1`
+(Hidden: 15 Tier-1 + 26 Tier-2 commands. Run `./agent-config --help --tier=1`
 or `--tier=all` to see them. Tier criteria: docs/contracts/command-surface-tiers.md.)
 EOF
   fi
@@ -173,14 +174,8 @@ Examples (Tier 0):
   ./agent-config sync --dry-run
   ./agent-config sync
   ./agent-config validate
-  ./agent-config first-run
   ./agent-config work --state-file .work-state.json --prompt-file prompt.txt
   ./agent-config implement-ticket --state-file .work-state.json
-  ./agent-config keys:install-anthropic
-  ./agent-config keys:install-openai
-  ./agent-config council:estimate prompt.txt
-  ./agent-config council:run prompt.txt --output agents/council-sessions/out.json --confirm
-  ./agent-config council:render agents/council-sessions/out.json
 EOF
 
   if [[ "$tier" == "1" || "$tier" == "all" ]]; then
@@ -203,6 +198,12 @@ Examples (Tier 1):
   ./agent-config versions --json
   ./agent-config init --offline --tools=claude-code,cursor --yes
   ./agent-config update --offline --to=2.2.0
+  ./agent-config first-run
+  ./agent-config keys:install-anthropic
+  ./agent-config keys:install-openai
+  ./agent-config council:estimate prompt.txt
+  ./agent-config council:run prompt.txt --output agents/council-sessions/out.json --confirm
+  ./agent-config council:render agents/council-sessions/out.json
 EOF
   fi
 

package/scripts/install.py

@@ -105,6 +105,11 @@ def warn(msg: str) -> None:
 
 def fail(msg: str) -> "None":
     print(f"  ❌  {msg}", file=sys.stderr)
+    print(
+        "      Diagnose: `./agent-config doctor` "
+        "(or `--check <id>` for a single category)",
+        file=sys.stderr,
+    )
     sys.exit(1)
 
 

package/scripts/lint_context_spine_usage.py

@@ -31,7 +31,11 @@ SKILL_GLOBS = (
     ".agent-src.uncompressed/skills/**/SKILL.md",
     ".agent-src/skills/**/SKILL.md",
 )
-VALID_SLOTS = ("product", "team", "repo")
+VALID_SLOTS = (
+    "product", "team", "repo",
+    "channel-stage", "funnel-stage", "customer-segment",
+    "fiscal-period", "org-stage", "regulatory-regime",
+)
 
 CONTEXT_SPINE_PAT = re.compile(
     r"^context_spine:\s*\[([^\]]*)\]\s*$", re.MULTILINE

package/scripts/mcp_server/__init__.py

@@ -11,6 +11,7 @@ boundary in `agents/roadmaps/road-to-mcp-server.md`. No `tools`
 primitive, no engine spawn, no shell execution.
 
 Stability: experimental. Contract: `docs/contracts/mcp-phase-1-scope.md`.
+Promotion to beta gated on `docs/contracts/mcp-beta-criteria.md`.
 """
 from __future__ import annotations
 

package/scripts/mcp_server/server.py

@@ -125,9 +125,10 @@ def build_server(
         name=SERVER_NAME,
         version=__version__,
         instructions=(
-            "agent-config MCP server (Phase 3, experimental). Exposes "
-            "all skills + commands as instructional prompts, plus "
-            "rules + guidelines + contexts as read-only resources."
+            "agent-config MCP server (Phase 3, experimental; beta gates "
+            "in docs/contracts/mcp-beta-criteria.md). Exposes all skills "
+            "+ commands as instructional prompts, plus rules + guidelines "
+            "+ contexts as read-only resources."
         ),
     )
 

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", "fiscal-period", "org-stage", "regulatory-regime"]
       },
-      "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 follow the per-wing ADR track in docs/contracts/context-spine.md § 5. Wing-3 (channel-stage, funnel-stage, customer-segment) authorized by docs/contracts/adr-gtm-context-spine.md; Wing-4 (fiscal-period, org-stage, regulatory-regime) authorized by docs/contracts/adr-wing4-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,89 @@ 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,
+)
+
+# --- Wing-4 Money/Strategy/Ops cognition-boundary patterns (council Q7 / J2) ---
+# Triggered only when a skill's context_spine declares a Wing-4 slot.
+# See docs/contracts/adr-wing4-context-spine.md and
+# agents/roadmaps/road-to-money-strategy-ops.md § J2.
+WING4_SPINE_SLOTS = {"fiscal-period", "org-stage", "regulatory-regime"}
+
+# agent-operability: external finance / HR / legal SaaS URLs
+WING4_SAAS_URL_PATTERN = re.compile(
+    r"https?://[\w.-]*\.(quickbooks|intuit|netsuite|xero|sage|"
+    r"carta|pulley|gusto|bamboohr|lattice|15five|justworks|"
+    r"docusign|ironclad|onetrust|rippling|workday|deel|"
+    r"namely|adp|paychex|trinet|hibob|cultureamp)\.(com|io|co)\b",
+    re.IGNORECASE,
+)
+
+# vendor-independence: finance / HR / legal brand / SDK slugs
+WING4_VENDOR_BLACKLIST = re.compile(
+    r"\b(quickbooks|netsuite|xero|sage intacct|"
+    r"carta|pulley|gusto|bamboohr|lattice|15five|justworks|"
+    r"docusign|ironclad|onetrust|rippling|workday|deel|"
+    r"namely|adp|paychex|trinet|hibob|culture amp)\b",
+    re.IGNORECASE,
+)
+
+# stage-agnosticism: prescriptive stage-specific thresholds that lock cognition
+# Catches hardcoded runway / ARR / burn / team-size prescriptions tied to a
+# specific funding stage. Framework-style framing ("read the org-stage slot",
+# "applies across seed and public") passes; hard prescriptions ("18 months of
+# runway", "Series A teams must hire") fire.
+WING4_STAGE_AGNOSTIC_PATTERN = re.compile(
+    r"(?:"
+    r"\b\d+\s+months?\s+of\s+runway\b"
+    r"|\brunway\s+of\s+at\s+least\s+\d+\s+months?\b"
+    r"|\bminimum\s+runway\s+of\s+\d+\b"
+    r"|\b(?:seed|series\s+[a-d]|growth|pre-?ipo|post-?ipo)[-\s]stage\s+"
+    r"(?:companies|startups|teams|founders|orgs)\s+(?:must|should|always|never)\b"
+    r"|\bteam\s+of\s+\d+\s+(?:or\s+more|or\s+fewer)\b"
+    r"|\b(?:arr|mrr|burn\s+rate)\s+(?:of|over|under|above|below)\s+\$\d+"
+    r")",
+    re.IGNORECASE,
+)
+
 
 @dataclass
 class Issue:
@@ -569,9 +661,9 @@ def lint_skill(path: Path, text: str) -> LintResult:
     skill_name = path.parent.name if path.name == "SKILL.md" else path.stem
     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", "grafana",
-                              "laravel", "livewire", "mcp", "openapi", "performance", "security",
-                              "terraform", "terragrunt", "traefik", "websocket"}
+        ALLOWED_BARE_NOUNS = {"database", "devcontainer", "docker", "eloquent", "flux", "forecasting",
+                              "grafana", "laravel", "livewire", "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`)"))
@@ -605,6 +697,15 @@ 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))
+
+        # --- Wing-4 Money/Strategy/Ops cognition-boundary check (council Q7 / J2) ---
+        if spine_slots and any(s in WING4_SPINE_SLOTS for s in spine_slots):
+            issues.extend(lint_wing4_boundaries(text))
+
     procedure_block = find_procedure_block(text)
     if procedure_block is not None:
         if not procedure_block:
@@ -993,6 +1094,156 @@ 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_wing4_boundaries(text: str) -> List[Issue]:
+    """Four Wing-4 Money/Strategy/Ops cognition-boundary checks.
+
+    Triggered when a skill's ``context_spine`` declares at least one
+    Wing-4 slot (fiscal-period, org-stage, regulatory-regime). Enforces
+    council Q7 / J2 verdict that Money/Strategy/Ops cognition stays:
+
+    - **agent-operability** — no external finance/HR/legal SaaS URLs.
+    - **vendor-independence** — no QuickBooks/Carta/Gusto-class brand slugs.
+    - **transferability** — no stack-locked tooling instructions.
+    - **stage-agnosticism** — no prescriptive stage-specific thresholds.
+
+    Carve-outs are identical to Wing-3: fenced code, inline backticks,
+    the ``## Do NOT`` block, and ``**WHEN NOT to use this**`` lists.
+    Regulatory regime names (GDPR / HIPAA / SOC2 / PCI / CCPA) are
+    cognition-relevant constraints, not vendors — they pass.
+    """
+    issues: List[Issue] = []
+    body = _strip_wing3_carve_outs(text)
+
+    match = WING4_SAAS_URL_PATTERN.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing4_agent_operability",
+            f"Wing-4 skill cites external SaaS URL `{match.group(0)}` outside "
+            f"carve-outs — cognition skills must operate without SaaS auth "
+            f"(council Q7 boundary)",
+        ))
+
+    match = WING4_VENDOR_BLACKLIST.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing4_vendor_independence",
+            f"Wing-4 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", "wing4_transferability",
+            f"Wing-4 skill includes stack-locked instruction `{match.group(0)}` "
+            f"outside carve-outs — cognition should transfer across stacks "
+            f"(council Q7 boundary)",
+        ))
+
+    match = WING4_STAGE_AGNOSTIC_PATTERN.search(body)
+    if match:
+        issues.append(Issue(
+            "warning", "wing4_stage_agnosticism",
+            f"Wing-4 skill prescribes stage-locked threshold "
+            f"`{match.group(0)}` outside carve-outs — cognition must "
+            f"transfer across seed and public (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 +1687,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 +1745,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