@ikon85/agent-workflow-kit 0.44.2 → 0.45.0

package/.claude/skills/skill-manifest.json

@@ -4,29 +4,29 @@
   "readiness": {
     "contractVersion": 1,
     "capabilities": {
-      "issueTracker": { "evidence": { "type": "sentinel", "paths": ["docs/agents/issue-tracker.md"], "allowLegacy": true } },
-      "triageLabels": { "evidence": { "type": "sentinel", "paths": ["docs/agents/triage-labels.md"], "allowLegacy": true } },
-      "managedBoard": { "allowNotApplicable": true, "evidence": { "type": "board-profile", "paths": ["docs/agents/board-sync.md"] } },
-      "specCompleteness": { "evidence": { "type": "sentinel", "paths": ["docs/conventions/spec-completeness.md"], "allowLegacy": true } },
-      "localCiRecipe": { "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/local-ci.md"], "allowLegacy": true } },
-      "projectReleaseProfile": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "validator": "project-release" } },
-      "securityAuditRunbook": { "evidence": { "type": "runbook-reference", "paths": ["docs/agents/skills/security-audit.md"], "allowLegacy": true } },
-      "prodTarget": { "evidence": { "type": "prod-section", "paths": ["CLAUDE.md", "AGENTS.md"] } },
-      "orchestrateWaveRecipe": { "evidence": { "type": "project-extension", "skill": "orchestrate-wave", "paths": ["docs/agents/skills/orchestrate-wave.md"], "activation": { "mode": "all-sections-filled", "sections": ["§Setup", "§Builder Commands", "§Builder Hard Rules", "§Integration Suites", "§Verify Recipe", "§Headless Login", "§Landing"] } } },
-      "specCritiqueLayer": { "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/spec-self-critique.md"], "allowLegacy": true } },
-      "codeReviewLayer": { "evidence": { "type": "sentinel", "paths": ["docs/agents/code-review.md"], "allowLegacy": true } },
-      "verifySpikeLayer": { "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/verify-spike.md"], "allowLegacy": true } },
-      "auditSkillsLayer": { "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/audit-skills.md"], "allowLegacy": true } },
-      "worktreeRecoveryLayer": { "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/git-worktree-recover.md"], "allowLegacy": true } },
-      "domainDocs": { "evidence": { "type": "sentinel", "paths": ["docs/agents/domain.md"], "allowLegacy": true } },
-      "censusChoice": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["census"] } },
-      "memoryLifecycle": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["memoryLifecycle"] } },
-      "worktreeLifecycle": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["worktreeLifecycle"] } },
-      "workflowAdvisories": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["workflowAdvisories"] } },
-      "safetyGuardrails": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["safetyGuardrails"] } },
-      "workflowSummary": { "evidence": { "type": "nonempty", "paths": ["CLAUDE.md", "AGENTS.md"] } },
-      "locProfile": { "evidence": { "type": "json", "paths": ["max-lines-allowlist.json"] } },
-      "kitOriginHint": { "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["kitOriginHint"] } }
+      "issueTracker": { "title": "Issue tracker layer", "remedy": "Run `/setup-workflow` and record where issues live plus how to read and write them.", "evidence": { "type": "sentinel", "paths": ["docs/agents/issue-tracker.md"], "allowLegacy": true } },
+      "triageLabels": { "title": "Triage vocabulary", "remedy": "Run `/setup-workflow` and record the label or state vocabulary triage may set.", "evidence": { "type": "sentinel", "paths": ["docs/agents/triage-labels.md"], "allowLegacy": true } },
+      "managedBoard": { "title": "Managed board profile", "remedy": "Run `/setup-workflow` to fill the board profile block, or record the capability as not applicable when the project runs no managed board.", "allowNotApplicable": true, "evidence": { "type": "board-profile", "paths": ["docs/agents/board-sync.md"] } },
+      "specCompleteness": { "title": "Spec completeness convention", "remedy": "Run `/setup-workflow` and record what makes a spec complete in this project.", "evidence": { "type": "sentinel", "paths": ["docs/conventions/spec-completeness.md"], "allowLegacy": true } },
+      "localCiRecipe": { "title": "Local CI recipe", "remedy": "Fill the project layer with the exact commands that must pass before a pull request.", "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/local-ci.md"], "allowLegacy": true } },
+      "projectReleaseProfile": { "title": "Project release profile", "remedy": "Record a `projectRelease` section naming the files that carry the version and the release tag prefix.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "validator": "project-release" } },
+      "securityAuditRunbook": { "title": "Security audit runbook", "remedy": "Point the security-audit layer at a real project runbook instead of the placeholder.", "evidence": { "type": "runbook-reference", "paths": ["docs/agents/skills/security-audit.md"], "allowLegacy": true } },
+      "prodTarget": { "title": "Deploy target", "remedy": "Add a `## Prod` section describing where this project deploys; `/setup-workflow` seeds it on both agent surfaces.", "evidence": { "type": "prod-section", "paths": ["CLAUDE.md", "AGENTS.md"] } },
+      "orchestrateWaveRecipe": { "title": "Wave orchestration recipe", "remedy": "Fill every section of the orchestrate-wave project extension \u2014 one empty section keeps the recipe inactive.", "evidence": { "type": "project-extension", "skill": "orchestrate-wave", "paths": ["docs/agents/skills/orchestrate-wave.md"], "activation": { "mode": "all-sections-filled", "sections": ["§Setup", "§Builder Commands", "§Builder Hard Rules", "§Integration Suites", "§Verify Recipe", "§Headless Login", "§Landing"] } } },
+      "specCritiqueLayer": { "title": "Spec critique layer", "remedy": "Run `/setup-workflow` and record the project-specific checks a spec critique must apply.", "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/spec-self-critique.md"], "allowLegacy": true } },
+      "codeReviewLayer": { "title": "Code review layer", "remedy": "Run `/setup-workflow` and record this project's standards sources and review tooling.", "evidence": { "type": "sentinel", "paths": ["docs/agents/code-review.md"], "allowLegacy": true } },
+      "verifySpikeLayer": { "title": "Verify-spike layer", "remedy": "Fill the project layer with where throwaway verification harnesses may live and how they are removed.", "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/verify-spike.md"], "allowLegacy": true } },
+      "auditSkillsLayer": { "title": "Skill audit layer", "remedy": "Fill the project layer with the skill trees and extra checks an audit must cover.", "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/audit-skills.md"], "allowLegacy": true } },
+      "worktreeRecoveryLayer": { "title": "Worktree recovery layer", "remedy": "Fill the project layer with this project's branch and worktree recovery rules.", "evidence": { "type": "sentinel", "paths": ["docs/agents/skills/git-worktree-recover.md"], "allowLegacy": true } },
+      "domainDocs": { "title": "Domain documentation layout", "remedy": "Run `/setup-workflow` and record where domain context and decision records live.", "evidence": { "type": "sentinel", "paths": ["docs/agents/domain.md"], "allowLegacy": true } },
+      "censusChoice": { "title": "Project census choice", "remedy": "Run `/setup-workflow` and answer whether the optional project census is prepared now, deferred, or disabled.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["census"] } },
+      "memoryLifecycle": { "title": "Memory lifecycle choice", "remedy": "Run `/setup-workflow` and record the memory roots plus the archive and recovery rules.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["memoryLifecycle"] } },
+      "worktreeLifecycle": { "title": "Worktree lifecycle choice", "remedy": "Run `/setup-workflow` and record where worktrees are created and how they are cleaned up.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["worktreeLifecycle"] } },
+      "workflowAdvisories": { "title": "Workflow advisories choice", "remedy": "Run `/setup-workflow` and record which workflow advisories this project activates.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["workflowAdvisories"] } },
+      "safetyGuardrails": { "title": "Safety guardrails choice", "remedy": "Run `/setup-workflow` and record which guardrail commands agent hooks may run here.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["safetyGuardrails"] } },
+      "workflowSummary": { "title": "Workflow overview", "remedy": "Run `/setup-workflow` to write the workflow entry-point map into the agent instruction files.", "evidence": { "type": "nonempty", "paths": ["CLAUDE.md", "AGENTS.md"] } },
+      "locProfile": { "title": "File-size profile", "remedy": "Record the maximum file length plus the curated list of existing offenders.", "evidence": { "type": "json", "paths": ["max-lines-allowlist.json"] } },
+      "kitOriginHint": { "title": "Kit-origin edit hint", "remedy": "Run `/setup-workflow` and decide whether the advisory kit-origin edit hint is activated.", "evidence": { "type": "json", "paths": ["docs/agents/workflow-capabilities.json"], "required": ["kitOriginHint"] } }
     }
   },
   "skills": {
@@ -50,6 +50,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "writesIntent": ["SKILL.md"] },
       "provenance": "matt-pocock"
     },
     "grill-with-docs": {
@@ -130,6 +131,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "own"
     },
     "setup-workflow": {
@@ -210,6 +212,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "dispatch": ["INTERFACE-DESIGN.md", "SKILL.md"] },
       "provenance": "matt-pocock"
     },
     "prototype": {
@@ -240,6 +243,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "dispatch": ["DESIGN-IT-TWICE.md"] },
       "provenance": "matt-pocock"
     },
     "domain-modeling": {
@@ -305,6 +309,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "matt-pocock"
     },
     "git-guardrails-claude-code": {
@@ -329,6 +334,7 @@
       "surfaces": [
         "claude"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "chase"
     },
     "grill-with-docs-codex": {
@@ -337,6 +343,7 @@
       "surfaces": [
         "claude"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "chase"
     },
     "codex-review": {
@@ -345,6 +352,7 @@
       "surfaces": [
         "claude"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "chase"
     },
     "codex-build": {
@@ -353,6 +361,7 @@
       "surfaces": [
         "claude"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "chase"
     },
     "codex-adapter-sync": {
@@ -372,6 +381,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "dispatch": ["SKILL.md"] },
       "provenance": "own"
     },
     "local-ci": {
@@ -397,6 +407,7 @@
         "claude",
         "codex"
       ],
+      "routing": { "dispatch": ["SKILL.md", "references/dispatch-subagents.md", "references/dispatch-workflow.md"] },
       "provenance": "own"
     },
     "git-worktree-recover": {

package/.claude/skills/to-issues/SKILL.md

@@ -436,6 +436,20 @@ Reference the blocking ticket(s), or "None - can start immediately".
 **Decision:** <chosen option + why it wins on the criteria that matter + what was consciously traded off>
 **Verdict sink:** <ADR / this body / follow-up slice #N>
 
+## Routing intent
+<!-- Provider-neutral and durable: the dimensions of the WORK, never a model,
+     effort, or provider name. Written as ONE blank-line-delimited block so the
+     dispatching surface can read it as the explicit intent instead of guessing
+     from workflow signals; a second such block in the body makes it ambiguous
+     and unreadable. Keys and vocabularies are owned by the intent schema. -->
+intent-version: 2
+routing-intent: <judgment | development | mechanical>
+reasoning-intent: <deep | balanced | light>
+task-shape: <single-step | multi-step | long-horizon>
+risk: <low | moderate | high>
+autonomy-requirement: <supervised | afk>
+context-need: <focused | repository | long-context>
+
 ## Handoff Start Command
 <!-- SELF-CONTAINED: scope + live-verify live HERE, never as a "see anchor
      handoff" pointer — the anchor carries no per-slice handoff blocks anymore, and a
@@ -444,7 +458,7 @@ Reference the blocking ticket(s), or "None - can start immediately".
 ```
 Welle <N> · Slice <X> (<closes #x | refs #<prd#>, Parent #<prd#>>). Read #<prd#> for decisions.
 Start skill: 🧭 Design Grill → /grill-with-docs-codex · 🔬 Verify Spike → /verify-spike · 📐 Trade-off/Research → /decision-gate · AFK → /implement · HITL → /grill-me → /implement.
-Routing intent: `routing-intent: <judgment | development | mechanical>` · `reasoning-intent: <deep | balanced | light>`. The dispatching surface resolves the current executable route; never persist that provider route here.
+Routing intent: the body's `## Routing intent` block — read it as the explicit intent. The dispatching surface resolves the current executable route from it; never persist that provider route here.
 Worktree: your project's worktree helper, or `git worktree add`
 Scope (<N> files) — REQUIRED FIELD, blast-radius estimate at cut time; the build session checks it against its own recon findings, >2x deviation → STOP:
 - <concrete file + change>
@@ -453,10 +467,17 @@ PR: <closes #x | Part of #<prd#> — NEVER closes on the anchor>.
 ```
 <!-- mirror-xform:end -->
 
+Every published issue carries that block, gate slices included — an unstated
+intent forces the dispatching surface to classify from workflow signals, and a
+guess is what the block exists to replace. Fill each dimension from the slice
+itself: `autonomy-requirement: afk` only for the AFK bucket (§5c), `supervised`
+for every HITL slice.
+
 At execution time, consume that provider-neutral intent only through
-`src/lib/routeDispatcher.mjs` and its shared spawn guard. The active Claude or
-Codex adapter must produce Dispatch receipt v2 with requested/applied route,
-model/effort enforcement, precedence, and catalog/access/policy revisions
+`src/lib/routeDispatcher.mjs` and its shared spawn guard, under the Dispatch
+plan that authorized the run. The active Claude or Codex adapter must produce
+Dispatch receipt v2 with requested/applied route, model/effort enforcement,
+precedence, the plan's authorization id, and catalog/access/policy revisions
 before an AFK subagent starts; the durable issue never claims that proof.
 </issue-template>
 

package/README.md

@@ -579,6 +579,70 @@ the old way. Decision record:
 
 ## Release notes
 
+### 0.45.0
+
+- added: `scripts/doctrine-migration/index.mjs`
+- added: `src/commands/routing-status.mjs`
+- added: `src/lib/dispatchJournal.mjs`
+- added: `src/lib/dispatchPlan.mjs`
+- added: `src/lib/routingAccessGraphStore.mjs`
+- added: `src/lib/routingAdapters/hostBridge.mjs`
+- added: `src/lib/routingDispatchLease.mjs`
+- added: `src/lib/routingIntentClassifier.mjs`
+- added: `src/lib/routingInventory.mjs`
+- added: `src/lib/routingInventory/snapshots/claude.json`
+- added: `src/lib/routingInventory/snapshots/codex.json`
+- added: `src/lib/routingProfilePolicy.mjs`
+- added: `src/lib/routingProfileStorage.mjs`
+- changed: `.agents/skills/audit-skills/SKILL.md`
+- changed: `.agents/skills/code-review/SKILL.md`
+- changed: `.agents/skills/codebase-design/DESIGN-IT-TWICE.md`
+- changed: `.agents/skills/improve-codebase-architecture/INTERFACE-DESIGN.md`
+- changed: `.agents/skills/improve-codebase-architecture/SKILL.md`
+- changed: `.agents/skills/orchestrate-wave/SKILL.md`
+- changed: `.agents/skills/orchestrate-wave/references/dispatch-subagents.md`
+- changed: `.agents/skills/orchestrate-wave/references/dispatch-workflow.md`
+- changed: `.agents/skills/research/SKILL.md`
+- changed: `.agents/skills/to-issues/SKILL.md`
+- changed: `.claude/skills/audit-skills/SKILL.md`
+- changed: `.claude/skills/code-review/SKILL.md`
+- changed: `.claude/skills/codebase-design/DESIGN-IT-TWICE.md`
+- changed: `.claude/skills/codex-build/SKILL.md`
+- changed: `.claude/skills/codex-review/SKILL.md`
+- changed: `.claude/skills/grill-me-codex/SKILL.md`
+- changed: `.claude/skills/grill-with-docs-codex/SKILL.md`
+- changed: `.claude/skills/improve-codebase-architecture/INTERFACE-DESIGN.md`
+- changed: `.claude/skills/improve-codebase-architecture/SKILL.md`
+- changed: `.claude/skills/orchestrate-wave/SKILL.md`
+- changed: `.claude/skills/orchestrate-wave/references/dispatch-subagents.md`
+- changed: `.claude/skills/orchestrate-wave/references/dispatch-workflow.md`
+- changed: `.claude/skills/research/SKILL.md`
+- changed: `.claude/skills/skill-manifest.json`
+- changed: `.claude/skills/to-issues/SKILL.md`
+- changed: `agent-workflow-kit.package.json`
+- changed: `scripts/kit-release.mjs`
+- changed: `src/cli.mjs`
+- changed: `src/lib/bundle.mjs`
+- changed: `src/lib/dispatchReceipt.mjs`
+- changed: `src/lib/frontendWorkloads.mjs`
+- changed: `src/lib/routeDispatcher.mjs`
+- changed: `src/lib/routingAccessGraph.mjs`
+- changed: `src/lib/routingAdapters/claude.mjs`
+- changed: `src/lib/routingAdapters/codex.mjs`
+- changed: `src/lib/routingCatalog.mjs`
+- changed: `src/lib/routingEvidenceCache.mjs`
+- changed: `src/lib/routingIntent.mjs`
+- changed: `src/lib/routingPolicy.mjs`
+- changed: `src/lib/routingProfile.mjs`
+- changed: `src/lib/routingResolver.mjs`
+- changed: `src/lib/routingSources/artificialAnalysis.mjs`
+- changed: `src/lib/routingSources/benchlm.mjs`
+- changed: `src/lib/routingSources/codeArena.mjs`
+- changed: `src/lib/routingSources/deepswe.mjs`
+- changed: `src/lib/routingSources/openhands.mjs`
+- changed: `src/lib/routingSources/openhandsFrontend.mjs`
+- changed: `src/lib/updateCandidate.mjs`
+
 ### 0.44.2
 
 - changed: `src/cli.mjs`