@windyroad/itil 1.2.0 → 2.0.0-preview.1111

package/skills/review-problems/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "WR ITIL: Review Problems"
+  short_description: "Reassess and reprioritise the problem backlog."

package/skills/scaffold-intake/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wr-itil:scaffold-intake
-description: Scaffold the four OSS intake surfaces (.github/ISSUE_TEMPLATE/, SECURITY.md, SUPPORT.md, CONTRIBUTING.md) for a downstream project that adopts @windyroad/itil. Idempotent, foreground-synchronous, and respects ADR-009 marker semantics. Implements the contract in ADR-036.
+description: Scaffold the four OSS intake surfaces (.github/ISSUE_TEMPLATE/, SECURITY.md, SUPPORT.md, CONTRIBUTING.md) for a downstream project that adopts @windyroad/itil. Idempotent, foreground-synchronous, and respects the "Gate Marker Lifecycle: TTL + Drift, Not Stop-Hook Reset" architecture rule marker semantics. Implements the contract in the "Scaffold downstream OSS intake — skill + layered triggers" architecture rule.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
 ---
 
@@ -14,13 +14,13 @@ Scaffold the five intake files every project in the Windy Road ecosystem needs t
 - `SUPPORT.md`
 - `CONTRIBUTING.md`
 
-Templates are seeded from this repo's P066-corrected problem-first intake set and are substituted with per-project values for project name, repository URL, plugin list, and security-contact path.
+Templates are seeded from this repo's the "Problem 066: Intake templates split bug / feature instead of a problem-first template — misaligned with ITIL problem management" problem-corrected problem-first intake set and are substituted with per-project values for project name, repository URL, plugin list, and security-contact path.
 
-This skill implements the contract in [ADR-036](../../../../docs/decisions/036-scaffold-downstream-oss-intake.proposed.md) (Scaffold downstream OSS intake — skill + layered triggers). It is the reciprocal of [`/wr-itil:report-upstream`](../report-upstream/SKILL.md) — that skill files reports against upstream intake; this skill creates the intake surface so a downstream project can be a target.
+This skill implements the contract in [the "Scaffold downstream OSS intake — skill + layered triggers" architecture rule](../../../../docs/decisions/036-scaffold-downstream-oss-intake.proposed.md) (Scaffold downstream OSS intake — skill + layered triggers). It is the reciprocal of [`/wr-itil:report-upstream`](../report-upstream/SKILL.md) — that skill files reports against upstream intake; this skill creates the intake surface so a downstream project can be a target.
 
 ## Pattern
 
-This skill is **foreground-synchronous** per [ADR-032](../../../../docs/decisions/032-governance-skill-invocation-patterns.proposed.md) (Governance skill invocation patterns). Scaffolding writes files into the project that the user normally wants to review before they commit; the wrapped-pattern subagent shape would defeat that review. The skill commits its own work per [ADR-014](../../../../docs/decisions/014-governance-skills-commit-their-own-work.proposed.md).
+This skill is **foreground-synchronous** per [the "Governance skill invocation patterns — foreground + background with deferred-question resumption" architecture rule](../../../../docs/decisions/032-governance-skill-invocation-patterns.proposed.md) (Governance skill invocation patterns). Scaffolding writes files into the project that the user normally wants to review before they commit; the wrapped-pattern subagent shape would defeat that review. The skill commits its own work per [the "Governance Skills Commit Their Own Completed Work" architecture rule](../../../../docs/decisions/014-governance-skills-commit-their-own-work.proposed.md).
 
 ## Invocation
 
@@ -56,7 +56,7 @@ Plugin list: enumerate installed `@windyroad/*` packages from `.claude-plugin/pl
 
 ### 2. Enumerate target paths
 
-Required intake files (per ADR-036 Detection step 5):
+Required intake files (per the "Scaffold downstream OSS intake — skill + layered triggers" architecture rule Detection step 5):
 
 ```
 .github/ISSUE_TEMPLATE/config.yml
@@ -70,7 +70,7 @@ For each path: classify as **missing**, **present-and-current** (template-substi
 
 ### 3. AskUserQuestion: which files to scaffold (foreground only)
 
-In foreground (interactive) mode, fire `AskUserQuestion` per ADR-013 Rule 1 with options scoped to the missing set:
+In foreground (interactive) mode, fire `AskUserQuestion` per the "Structured User Interaction for Governance-Skill Decisions" architecture rule Rule 1 with options scoped to the missing set:
 
 - **Scaffold all missing** — write every absent template, skip present files.
 - **Scaffold with review** — preview each substituted template before writing.
@@ -118,16 +118,16 @@ mkdir -p .claude
 : > .claude/.intake-scaffold-done
 ```
 
-The marker suppresses Trigger-1 first-run prompts in subsequent `/wr-itil:manage-problem` and `/wr-itil:work-problems` invocations. ADR-009 marker semantics — persistent (no TTL), file-presence is the policy signal, deletable to reset.
+The marker suppresses Trigger-1 first-run prompts in subsequent `/wr-itil:manage-problem` and `/wr-itil:work-problems` invocations. the "Gate Marker Lifecycle: TTL + Drift, Not Stop-Hook Reset" architecture rule marker semantics — persistent (no TTL), file-presence is the policy signal, deletable to reset.
 
-### 6. Commit per ADR-014
+### 6. Commit per the "Governance Skills Commit Their Own Completed Work" architecture rule
 
 ```bash
 git add .github/ISSUE_TEMPLATE/ SECURITY.md SUPPORT.md CONTRIBUTING.md .claude/.intake-scaffold-done
 git -c commit.gpgsign=false commit -m "docs: scaffold OSS intake (ISSUE_TEMPLATE, SECURITY, SUPPORT, CONTRIBUTING)"
 ```
 
-Follow the project's existing commit-gate flow: the commit triggers `wr-risk-scorer:pipeline` per ADR-014; remediation suggestions are applied per ADR-042 if residual exceeds appetite.
+Follow the project's existing commit-gate flow: the commit triggers `wr-risk-scorer:pipeline` per the "Governance Skills Commit Their Own Completed Work" architecture rule; remediation suggestions are applied per the "Auto-apply scorer remediations to reach within appetite — open action-class vocabulary" architecture rule if residual exceeds appetite.
 
 ## Idempotency
 
@@ -137,20 +137,20 @@ The skill is idempotent by construction:
 - Re-running the skill on a fully-scaffolded project produces no diff.
 - The done marker prevents the host first-run prompt from re-firing.
 
-## Rule 6 audit (per ADR-032)
+## Rule 6 audit (per the "Governance skill invocation patterns — foreground + background with deferred-question resumption" architecture rule)
 
-Every `AskUserQuestion` branch this skill uses must enumerate its AFK fail-safe per ADR-013 Rule 6. The audit table below documents each branch:
+Every `AskUserQuestion` branch this skill uses must enumerate its AFK fail-safe per the "Structured User Interaction for Governance-Skill Decisions" architecture rule Rule 6. The audit table below documents each branch:
 
 | AskUserQuestion branch | Resolution |
 |---|---|
 | Step 3: "Which files to scaffold?" (foreground invocation) | Foreground-synchronous — user is in-session; `AskUserQuestion` fires normally. |
 | Step 4: "Overwrite outdated present file with updated template?" (with `--force`) | Foreground-synchronous; same as Step 3. |
 | First-run prompt fired from `/wr-itil:manage-problem` or `/wr-itil:work-problems` (foreground invocation) | Foreground-synchronous per the hosting skill's pattern. |
-| First-run prompt fired from an AFK orchestrator iteration | **Fail-safe (Rule 6)**: do NOT fire `AskUserQuestion` and do NOT auto-scaffold. Append a single one-line "pending intake scaffold" note to the orchestrator's iteration report; defer the prompt to the user's next interactive session. JTBD-006 forbids the agent from making this judgement call. |
+| First-run prompt fired from an AFK orchestrator iteration | **Fail-safe (Rule 6)**: do NOT fire `AskUserQuestion` and do NOT auto-scaffold. Append a single one-line "pending intake scaffold" note to the orchestrator's iteration report; defer the prompt to the user's next interactive session. the ": Progress the Backlog While I'm Away" user outcome forbids the agent from making this judgement call. |
 
 ## Trigger surfaces (layered)
 
-The skill is reachable via three trigger surfaces, layered so a soft prompt fires weeks before the hard publish stop. ADR-036 specifies the exact contract.
+The skill is reachable via three trigger surfaces, layered so a soft prompt fires weeks before the hard publish stop. the "Scaffold downstream OSS intake — skill + layered triggers" architecture rule specifies the exact contract.
 
 ### Trigger 1: First-run prompt from manage-problem / work-problems
 
@@ -164,7 +164,7 @@ When all three checks pass, the host emits a one-shot `AskUserQuestion` prompt w
 
 **AFK fail-safe**: when the host is invoked from an AFK orchestrator, do NOT fire the prompt. Append a one-line "pending intake scaffold" note to the iteration report and continue. The user catches up on next interactive session.
 
-**ADR-013 Rule 6 universal default (P352, 2026-06-06 amendment)**: this IS queue-and-continue — the iteration-report note is the queued surface; the loop advances. Persona-correct for JTBD-006 ("queued for my return, not guessed at"). Not a carve-out — this is the canonical default shape.
+**the "Structured User Interaction for Governance-Skill Decisions" architecture rule Rule 6 universal default (the "AFK iter default when a skill needs to ask a question and AskUserQuestion is unavailable — should queue the question and move to the next iteration (not halt, not silently skip)" problem, 2026-06-06 amendment)**: this IS queue-and-continue — the iteration-report note is the queued surface; the loop advances. Persona-correct for the ": Progress the Backlog While I'm Away" user outcome ("queued for my return, not guessed at"). Not a carve-out — this is the canonical default shape.
 
 ### Trigger 2: Pre-publish PreToolUse gate (hard stop)
 
@@ -181,18 +181,18 @@ When all three checks pass, the host emits a one-shot `AskUserQuestion` prompt w
 
 ## Idempotent re-runs and template drift
 
-When this repo's intake files evolve (e.g., a future P066-style reform), downstream adopters' previously-scaffolded files stay frozen. Re-running the skill at any time picks up the diff: the present-and-outdated branch reports each file's diff and, with `--force`, performs diff-and-replace. Template drift policy (when this should fire automatically) is out of scope for v1 — see ADR-036 Reassessment Criteria.
+When this repo's intake files evolve (e.g., a future the "Problem 066: Intake templates split bug / feature instead of a problem-first template — misaligned with ITIL problem management" problem-style reform), downstream adopters' previously-scaffolded files stay frozen. Re-running the skill at any time picks up the diff: the present-and-outdated branch reports each file's diff and, with `--force`, performs diff-and-replace. Template drift policy (when this should fire automatically) is out of scope for v1 — see the "Scaffold downstream OSS intake — skill + layered triggers" architecture rule Reassessment Criteria.
 
 ## Related
 
-- [ADR-036](../../../../docs/decisions/036-scaffold-downstream-oss-intake.proposed.md) — design record (driver decision).
-- [ADR-024](../../../../docs/decisions/024-cross-project-problem-reporting-contract.proposed.md) — sibling skill (`/wr-itil:report-upstream`); reciprocal pair.
-- [ADR-032](../../../../docs/decisions/032-governance-skill-invocation-patterns.proposed.md) — foreground-synchronous pattern + Rule 6 audit requirement.
-- [ADR-013](../../../../docs/decisions/013-structured-user-interaction-for-governance-decisions.proposed.md) — Rule 1 (interactive prompt) + Rule 6 (AFK fail-safe).
-- [ADR-009](../../../../docs/decisions/009-gate-marker-lifecycle.proposed.md) — marker lifecycle (the `.intake-scaffold-{done,declined}` markers).
-- [ADR-014](../../../../docs/decisions/014-governance-skills-commit-their-own-work.proposed.md) — commit discipline.
-- P065 — driver ticket.
-- P066 — parent (template seed source); the corrected problem-first intake shape this skill propagates.
-- JTBD-301 — primary persona; downstream-project intake coverage.
-- JTBD-101 — clear patterns for adopters extending the suite.
-- JTBD-006 — AFK fail-safe constraint.
+- [the "Scaffold downstream OSS intake — skill + layered triggers" architecture rule](../../../../docs/decisions/036-scaffold-downstream-oss-intake.proposed.md) — design record (driver decision).
+- [the "Cross-project problem-reporting contract — `report-upstream` skill in `@windyroad/itil`" architecture rule](../../../../docs/decisions/024-cross-project-problem-reporting-contract.proposed.md) — sibling skill (`/wr-itil:report-upstream`); reciprocal pair.
+- [the "Governance skill invocation patterns — foreground + background with deferred-question resumption" architecture rule](../../../../docs/decisions/032-governance-skill-invocation-patterns.proposed.md) — foreground-synchronous pattern + Rule 6 audit requirement.
+- [the "Structured User Interaction for Governance-Skill Decisions" architecture rule](../../../../docs/decisions/013-structured-user-interaction-for-governance-decisions.proposed.md) — Rule 1 (interactive prompt) + Rule 6 (AFK fail-safe).
+- [the "Gate Marker Lifecycle: TTL + Drift, Not Stop-Hook Reset" architecture rule](../../../../docs/decisions/009-gate-marker-lifecycle.proposed.md) — marker lifecycle (the `.intake-scaffold-{done,declined}` markers).
+- [the "Governance Skills Commit Their Own Completed Work" architecture rule](../../../../docs/decisions/014-governance-skills-commit-their-own-work.proposed.md) — commit discipline.
+- the "Problem 065: No skill scaffolds intake files (ISSUE_TEMPLATE, SECURITY.md, CONTRIBUTING.md, SUPPORT.md) in downstream projects" problem — driver ticket.
+- the "Problem 066: Intake templates split bug / feature instead of a problem-first template — misaligned with ITIL problem management" problem — parent (template seed source); the corrected problem-first intake shape this skill propagates.
+- the "Report a Problem Without Pre-Classifying It" user outcome — primary persona; downstream-project intake coverage.
+- the "Extend the Suite with New Plugins" user outcome — clear patterns for adopters extending the suite.
+- the ": Progress the Backlog While I'm Away" user outcome — AFK fail-safe constraint.

package/skills/scaffold-intake/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "WR ITIL: Scaffold Intake"
+  short_description: "Create ITIL intake and support surfaces."