@starci/skills 1.1.0

package/templates/kinds/frontend-direction-decision.skeleton.md

@@ -0,0 +1,68 @@
+# frontend-direction-decision — direction-id
+
+## Decision
+
+| Field | Value |
+| --- | --- |
+| Direction id | `direction-id` |
+| Target | `/route/or/target-id` |
+| Intent | `modify` |
+| Change level | `reconstruct` |
+| Owner ceiling | `surface-and-nested-layouts` |
+| Classification | `dominant` |
+| Selection policy | `automatic` |
+| Selected candidate | `candidate-id` |
+
+## Observed
+
+| Item | Evidence |
+| --- | --- |
+| what the target does today | `app/route/page.tsx:1-40@0f1e2d3` |
+
+## UI contract
+
+| Element | Kind | Responsibility |
+| --- | --- | --- |
+| `region-id` | region | what this region answers for the actor |
+| choose a plan | action | what the actor does and how the surface answers |
+| pending | state | what the surface says while the action settles |
+| narrow | responsive | what the layout does below the breakpoint |
+
+## Coverage
+
+| Concern | Enumerated |
+| --- | --- |
+| Actions | every action with its pointer route, keyboard route and settled pending paths |
+| Regions | every region with one idiom and one published composition |
+| States | every meaning with its own carrier |
+| Responsive | every branch with one owner |
+
+## References
+
+| Source | URL | Limitation |
+| --- | --- | --- |
+| what the reference showed | https://example.com/pattern | what it does not settle; no rows when the person supplied references or the change level is refine |
+
+## Images
+
+| Slot | Why | Claim | File |
+| --- | --- | --- | --- |
+| hero | the region reads empty without a subject | the one claim of the promise the image encodes | `response/artifacts/images/hero.png` |
+
+## Falsification
+
+| Attack | Candidate | Verdict | Evidence |
+| --- | --- | --- | --- |
+| content stress | `candidate-id` | holds | the widest plan name still fits the decision bar |
+
+## Why not the others
+
+| Candidate | Rejected because |
+| --- | --- |
+| `other-candidate-id` | which attack it failed; no rows when one candidate was formed |
+
+## Fallbacks taken
+
+| Code | Action |
+| --- | --- |
+| `CODE` | what the fallback did; no rows when none was taken |

package/templates/kinds/frontend-presentation-resolution.contract.json

@@ -0,0 +1,11 @@
+{
+  "kind": "frontend-presentation-resolution",
+  "title": "^# frontend-presentation-resolution — [a-z0-9][a-z0-9-]*$",
+  "sections": [
+    { "heading": "^## Owner map$", "table": "| Node | Property | Owner | Rule |", "minRows": 1, "cell": { "Node": "^`[^`]+`$", "Owner": "^(app|grammar)$", "Rule": "^`[A-Z][A-Z0-9-]*-[0-9]+`$" } },
+    { "heading": "^## Rules chosen$", "table": "| Node | Rule | Class | Condition |", "minRows": 1, "cell": { "Node": "^`[^`]+`$", "Rule": "^`[A-Z][A-Z0-9-]*-[0-9]+`$", "Class": "^`[^`]+`$", "Condition": "\\S" } },
+    { "heading": "^## Removed$", "table": "| Node | Class | Because |", "cell": { "Node": "^`[^`]+`$", "Because": "^(reimplements an owned relationship|overrides Grammar anatomy|off the closed scale)$" } },
+    { "heading": "^## Gaps$", "table": "| Node | Property | Missing path |", "cell": { "Node": "^`[^`]+`$", "Missing path": "\\S" } },
+    { "heading": "^## Fallbacks taken$", "table": "| Code | Action |", "cell": { "Code": "^`[A-Z][A-Z0-9_]+`$" } }
+  ]
+}

package/templates/kinds/frontend-presentation-resolution.skeleton.md

@@ -0,0 +1,32 @@
+# frontend-presentation-resolution — target-id
+
+## Owner map
+
+| Node | Property | Owner | Rule |
+| --- | --- | --- | --- |
+| `body>main>div[0]` | gap | app | `GAP-5` |
+| `body>main>div[0]>section` | padding | grammar | `PADDING-4` |
+
+## Rules chosen
+
+| Node | Rule | Class | Condition |
+| --- | --- | --- | --- |
+| `body>main>div[0]` | `GAP-5` | `gap-6` | the published case the observed condition matched |
+
+## Removed
+
+| Node | Class | Because |
+| --- | --- | --- |
+| `body>main>div[0]>section` | `p-4` | reimplements an owned relationship |
+
+## Gaps
+
+| Node | Property | Missing path |
+| --- | --- | --- |
+| `body>aside` | gap | Common exposes no public path for the compact identity pair; no rows when none was found |
+
+## Fallbacks taken
+
+| Code | Action |
+| --- | --- |
+| `CODE` | what the fallback did; no rows when none was taken |

package/templates/kinds/frontend-source-application.contract.json

@@ -0,0 +1,10 @@
+{
+  "kind": "frontend-source-application",
+  "title": "^# frontend-source-application — [a-z0-9][a-z0-9-]*$",
+  "sections": [
+    { "heading": "^## Binding$", "table": "| Field | Value |", "rows": ["Target", "Mode", "Branch", "Base", "Commit"], "cell": { "Value": "\\S" } },
+    { "heading": "^## Projection$", "table": "| Path | Change | Classes | Claims | Why |", "minRows": 1, "cell": { "Path": "^`[^`]+`$", "Change": "^(created|modified|deleted|unchanged)$", "Why": "\\S" } },
+    { "heading": "^## Rejections$", "table": "| Path | Value | Because |", "cell": { "Path": "^`[^`]+`$", "Because": "^(outside the declared write set|outside the owner root|absent from the resolution inventory|the committed tree is not the resolved tree)$" } },
+    { "heading": "^## Fallbacks taken$", "table": "| Code | Action |", "cell": { "Code": "^`[A-Z][A-Z0-9_]+`$" } }
+  ]
+}

package/templates/kinds/frontend-source-application.skeleton.md

@@ -0,0 +1,30 @@
+# frontend-source-application — target-id
+
+## Binding
+
+| Field | Value |
+| --- | --- |
+| Target | `target-id` |
+| Mode | `apply` |
+| Branch | `session/s-2026-09-03-1` |
+| Base | `0f1e2d3c4b5a69788796a5b4c3d2e1f009182736` |
+| Commit | `9a8b7c6d5e4f30211203344556677889900aabbc` |
+
+## Projection
+
+| Path | Change | Classes | Claims | Why |
+| --- | --- | --- | --- | --- |
+| `app/target/page.tsx` | modified | `gap-6` | `GAP-5` | the region stack takes the resolved gap |
+| `app/target/canvas.tsx` | created | — | — | an application-owned leaf carrying its contract, never its logic |
+
+## Rejections
+
+| Path | Value | Because |
+| --- | --- | --- |
+| `app/shell/layout.tsx` | `gap-8` | outside the declared write set |
+
+## Fallbacks taken
+
+| Code | Action |
+| --- | --- |
+| `CODE` | what the fallback did; no rows when none was taken |

package/templates/kinds/frontend-surface-audit.contract.json

@@ -0,0 +1,52 @@
+{
+  "kind": "frontend-surface-audit",
+  "title": "^# frontend-surface-audit — [a-z0-9][a-z0-9-]*$",
+  "sections": [
+    {
+      "heading": "^## Matrix$",
+      "table": "| Matrix | Viewport | Scheme | State | Screenshot |",
+      "minRows": 1,
+      "cell": {
+        "Matrix": "^`[a-z0-9][a-z0-9-]*`$",
+        "Viewport": "^[0-9]{3,4}x[0-9]{3,4}$",
+        "Scheme": "^(light|dark)$",
+        "Screenshot": "^`response/artifacts/[A-Za-z0-9_.-]+[.]png`$"
+      }
+    },
+    {
+      "heading": "^## Verdicts by owner$",
+      "table": "| Matrix | Owner | Node | Rule | Measured | Verdict |",
+      "minRows": 1,
+      "cell": {
+        "Owner": "^(app|grammar)$",
+        "Node": "^`[^`]+`$",
+        "Rule": "^`[A-Z][A-Z0-9-]*-[0-9]+`$",
+        "Verdict": "^(pass|fail)$",
+        "Matrix": "^`[a-z0-9][a-z0-9-]*`$"
+      }
+    },
+    {
+      "heading": "^## Regressions$",
+      "table": "| Matrix | Node | Rule | Measured | Routes to |",
+      "cell": {
+        "Node": "^`[^`]+`$",
+        "Routes to": "^(resolve|grammar-gap)$",
+        "Matrix": "^`[a-z0-9][a-z0-9-]*`$"
+      }
+    },
+    {
+      "heading": "^## Grammar gaps$",
+      "table": "| Component | Rule | What the family lacks |",
+      "cell": {
+        "What the family lacks": "\\S"
+      }
+    },
+    {
+      "heading": "^## Fallbacks taken$",
+      "table": "| Code | Action |",
+      "cell": {
+        "Code": "^`[A-Z][A-Z0-9_]+`$"
+      }
+    }
+  ]
+}

package/templates/kinds/frontend-surface-audit.skeleton.md

@@ -0,0 +1,32 @@
+# frontend-surface-audit — target-id
+
+## Matrix
+
+| Matrix | Viewport | Scheme | State | Screenshot |
+| --- | --- | --- | --- | --- |
+| `wide-light-loaded` | 1440x900 | light | loaded | `response/artifacts/wide-light-loaded.png` |
+
+## Verdicts by owner
+
+| Matrix | Owner | Node | Rule | Measured | Verdict |
+| --- | --- | --- | --- | --- | --- |
+| `wide-light-loaded` | app | `body>main` | `GAP-5` | 1.5rem | pass |
+| `wide-light-loaded` | grammar | `body>main>section` | `PADDING-4` | 1rem | pass |
+
+## Regressions
+
+| Matrix | Node | Rule | Measured | Routes to |
+| --- | --- | --- | --- | --- |
+| `narrow-light-loaded` | `body>main` | `GAP-5` | 1rem | resolve |
+
+## Grammar gaps
+
+| Component | Rule | What the family lacks |
+| --- | --- | --- |
+| `SurfaceCard` | `PADDING-4` | the component renders its own inset one step low; no rows when the family holds |
+
+## Fallbacks taken
+
+| Code | Action |
+| --- | --- |
+| `CODE` | what the fallback did; no rows when none was taken |

package/templates/kinds/gate-result.schema.json

@@ -0,0 +1,64 @@
+{
+  "$id": "kind:gate-result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "gate",
+    "required",
+    "sourceHead",
+    "sessionBranch",
+    "predecessorCommit",
+    "observedAt",
+    "commandRef",
+    "configRef",
+    "status",
+    "exitCode",
+    "evidenceRef",
+    "classification",
+    "sonarScope",
+    "debt",
+    "statement"
+  ],
+  "properties": {
+    "gate": { "$ref": "#/$defs/gate" },
+    "required": { "type": "boolean" },
+    "sourceHead": { "$ref": "#/$defs/gitHead" },
+    "sessionBranch": { "type": "string", "pattern": "^session/[A-Za-z0-9._-]+$" },
+    "predecessorCommit": { "$ref": "#/$defs/gitHead" },
+    "observedAt": { "type": "string", "format": "date-time" },
+    "commandRef": { "type": "string", "minLength": 1 },
+    "configRef": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["pass", "fail", "external-blocker", "skipped-not-requested"] },
+    "exitCode": { "oneOf": [{ "type": "integer" }, { "type": "null" }] },
+    "evidenceRef": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },
+    "classification": {
+      "oneOf": [
+        { "enum": ["in-boundary", "boundary-drift", "flaky", "external-blocker"] },
+        { "type": "null" }
+      ]
+    },
+    "sonarScope": { "oneOf": [{ "enum": ["new-code", "overall"] }, { "type": "null" }] },
+    "debt": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["debtId", "approvalRef", "ownerRef", "expiresAt", "statement"],
+          "properties": {
+            "debtId": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+            "approvalRef": { "type": "string", "minLength": 1 },
+            "ownerRef": { "type": "string", "minLength": 1 },
+            "expiresAt": { "type": "string", "format": "date-time" },
+            "statement": { "type": "string", "minLength": 1 }
+          }
+        }
+      ]
+    },
+    "statement": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "gate": { "enum": ["format", "lint", "typecheck", "build", "unit-coverage", "integration", "e2e", "sonar"] },
+    "gitHead": { "type": "string", "pattern": "^[0-9a-f]{40}$" }
+  }
+}

package/templates/kinds/git-publication.contract.json

@@ -0,0 +1,82 @@
+{
+  "kind": "git-publication",
+  "title": "^# git-publication — [a-z][a-z0-9.-]*$",
+  "sections": [
+    {
+      "heading": "^## Binding$",
+      "table": "| Field | Value |",
+      "rows": [
+        "Operator",
+        "Step",
+        "Project",
+        "Boundary",
+        "Approval",
+        "Route receipt",
+        "Worktree branches",
+        "Mutation branch",
+        "Frozen head"
+      ],
+      "cell": {
+        "Value": "\\S"
+      }
+    },
+    {
+      "heading": "^## Publication$",
+      "table": "| Field | Value |",
+      "rows": [
+        "Remote",
+        "Ref",
+        "Mode",
+        "Forced",
+        "Session branch",
+        "Target branch",
+        "Merge",
+        "Verified commit",
+        "Cleanup"
+      ],
+      "cell": {
+        "Value": "\\S"
+      }
+    },
+    {
+      "heading": "^## Published heads$",
+      "table": "| Checkout | Branch | Head | Previous remote head | Commits |",
+      "minRows": 1,
+      "cell": {
+        "Head": "^`[0-9a-f]{40}`$",
+        "Commits": "^[1-9][0-9]*$"
+      }
+    },
+    {
+      "heading": "^## Hooks$",
+      "table": "| Hook | Reference | Outcome |",
+      "minRows": 1,
+      "cell": {
+        "Hook": "^`(pre-commit|commit-msg|pre-push)`$",
+        "Outcome": "^(passed|failed)$"
+      }
+    },
+    {
+      "heading": "^## Continuation tag$",
+      "table": "| Field | Value |",
+      "rows": [
+        "Tag",
+        "Ref",
+        "Head"
+      ],
+      "cell": {
+        "Value": "\\S"
+      }
+    },
+    {
+      "heading": "^## Findings$",
+      "table": "| Code | Subject | Statement |",
+      "minRows": 1,
+      "cell": {
+        "Code": "^`(HOOK_ENFORCED|BOUNDARY_CLEAN|REMOTE_FAST_FORWARDED|REMOTE_REF_CREATED|CONTINUATION_TAG_PUBLISHED)`$",
+        "Subject": "\\S",
+        "Statement": "\\S"
+      }
+    }
+  ]
+}

package/templates/kinds/git-publication.skeleton.md

@@ -0,0 +1,61 @@
+# git-publication — api.core
+
+One paragraph: which boundary was published, from which heads, onto which ref, and under which
+hooks. Written by `git.publish` as `response/response.md`. It proves that exactly these heads reached
+exactly this ref; it carries no verdict about the change itself.
+
+## Binding
+
+| Field | Value |
+| --- | --- |
+| Operator | `git.publish` |
+| Step | `step-1/parallel-1` |
+| Project | `starci-academy` |
+| Boundary | `api.core` |
+| Approval | `@worktrees/businesses/features/api-core/model.json#approval` |
+| Route receipt | `step-1/parallel-1/response/response.md` |
+| Worktree branches | forbidden |
+| Mutation branch | `mtp` |
+| Frozen head | `1111111111111111111111111111111111111111` |
+
+## Publication
+
+| Field | Value |
+| --- | --- |
+| Remote | origin |
+| Ref | `refs/heads/mtp` |
+| Mode | fast-forward-only |
+| Forced | no |
+| Session branch | `session/s-2026-01-10` |
+| Target branch | `mtp` |
+| Merge | fast-forward |
+| Verified commit | `1111111111111111111111111111111111111111` |
+| Cleanup | worktree and session branch removed |
+
+## Published heads
+
+| Checkout | Branch | Head | Previous remote head | Commits |
+| --- | --- | --- | --- | --- |
+| `@workspaces/be` | `mtp` | `1111111111111111111111111111111111111111` | `2222222222222222222222222222222222222222` | 4 |
+
+## Hooks
+
+| Hook | Reference | Outcome |
+| --- | --- | --- |
+| `pre-push` | `.husky/pre-push` | passed |
+
+## Continuation tag
+
+| Field | Value |
+| --- | --- |
+| Tag | — |
+| Ref | — |
+| Head | — |
+
+## Findings
+
+| Code | Subject | Statement |
+| --- | --- | --- |
+| `HOOK_ENFORCED` | `pre-push` | the hook ran and was not bypassed |
+| `BOUNDARY_CLEAN` | `api.core` | nothing dirty lay outside the published boundary |
+| `REMOTE_FAST_FORWARDED` | `@workspaces/be` | the ref advanced from the remote head it carried |

package/templates/kinds/independent-critique.contract.json

@@ -0,0 +1,9 @@
+{
+  "kind": "independent-critique",
+  "title": "^# independent-critique — [a-z0-9][a-z0-9-]*$",
+  "sections": [
+    { "heading": "^## Execution$", "table": "| Field | Value |", "rows": ["Reviewer execution", "Inherited turns", "Given"], "cell": { "Value": "\\S" } },
+    { "heading": "^## Attacks$", "table": "| Adverse path | Attack | Resolution | Verdict |", "exactRows": 8, "rows": ["partial-failure", "retry-idempotency", "concurrency", "stale-state", "deletion", "recovery", "dependency-outage", "rollback"], "cell": { "Attack": "\\S", "Resolution": "\\S", "Verdict": "^(holds|fails)$" } },
+    { "heading": "^## Verdict$", "table": "| Field | Value |", "rows": ["Selection"], "cell": { "Value": "^(keep|return)$" } }
+  ]
+}

package/templates/kinds/independent-critique.skeleton.md

@@ -0,0 +1,28 @@
+# independent-critique — decision-id
+
+## Execution
+
+| Field | Value |
+| --- | --- |
+| Reviewer execution | the fresh execution's own reference, never the author's |
+| Inherited turns | none |
+| Given | `response/data/stack-model.json` and the claims it makes; no rationale |
+
+## Attacks
+
+| Adverse path | Attack | Resolution | Verdict |
+| --- | --- | --- | --- |
+| partial-failure | what breaks when one side completes | how the selected design survives it | holds |
+| retry-idempotency | what a repeated call does | how the design makes it idempotent | holds |
+| concurrency | what two writers do at once | how ownership serialises them | holds |
+| stale-state | what a reader sees after a change | how staleness is bounded | holds |
+| deletion | what deleting the owner's data leaves behind | how readers cope | holds |
+| recovery | what restoring from backup loses | what the restore path proves | holds |
+| dependency-outage | what an unavailable dependency does | how the boundary degrades | holds |
+| rollback | what undoing the migration costs | the rollback step and its proof | holds |
+
+## Verdict
+
+| Field | Value |
+| --- | --- |
+| Selection | keep |

package/templates/kinds/inventory.schema.json

@@ -0,0 +1,35 @@
+{
+  "$id": "kind:inventory",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["treeFingerprint", "classNames", "ruleIds", "gaps"],
+  "properties": {
+    "treeFingerprint": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "classNames": {
+      "type": "array",
+      "maxItems": 512,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_:./>\\[\\]-]+$" }
+    },
+    "ruleIds": {
+      "type": "array",
+      "maxItems": 256,
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9-]*-[0-9]+$" }
+    },
+    "gaps": {
+      "type": "array",
+      "maxItems": 128,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["nodePath", "property", "missingPath"],
+        "properties": {
+          "nodePath": { "type": "string", "minLength": 1 },
+          "property": { "type": "string", "minLength": 1 },
+          "missingPath": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/templates/kinds/model.schema.json

@@ -0,0 +1,99 @@
+{
+  "$id": "kind:model",
+  "title": "The one published head of one feature: the promise, its lineage, and the fingerprints the head is frozen behind.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "featureId",
+    "mode",
+    "headRef",
+    "headFingerprint",
+    "state",
+    "promise",
+    "lineage",
+    "claimsFingerprint",
+    "coverageFingerprint",
+    "reconciliation"
+  ],
+  "properties": {
+    "featureId": { "$ref": "#/$defs/identifier" },
+    "mode": { "enum": ["model", "reconcile"] },
+    "headRef": { "type": "string", "minLength": 1, "maxLength": 1024 },
+    "headFingerprint": { "$ref": "#/$defs/fingerprint" },
+    "state": { "$ref": "#/$defs/authorityState" },
+    "promise": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["statement", "actorStatement", "eligibilityStatement"],
+      "properties": {
+        "statement": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "actorStatement": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "eligibilityStatement": { "type": "string", "minLength": 1, "maxLength": 4096 }
+      }
+    },
+    "lineage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["previousHeadRef", "previousState", "transition"],
+      "properties": {
+        "previousHeadRef": {
+          "oneOf": [{ "type": "string", "minLength": 1, "maxLength": 1024 }, { "type": "null" }]
+        },
+        "previousState": {
+          "oneOf": [{ "$ref": "#/$defs/authorityState" }, { "type": "null" }]
+        },
+        "transition": {
+          "enum": [
+            "absent->pending",
+            "pending->in-progress",
+            "pending->rejected",
+            "in-progress->implemented",
+            "in-progress->rejected",
+            "implemented->in-progress",
+            "implemented->rejected",
+            "rejected->pending"
+          ]
+        }
+      }
+    },
+    "claimsFingerprint": { "$ref": "#/$defs/fingerprint" },
+    "coverageFingerprint": {
+      "oneOf": [{ "$ref": "#/$defs/fingerprint" }, { "type": "null" }]
+    },
+    "reconciliation": {
+      "oneOf": [{ "$ref": "#/$defs/reconciliation" }, { "type": "null" }]
+    }
+  },
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+    "fingerprint": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "authorityState": { "enum": ["pending", "in-progress", "implemented", "rejected"] },
+    "reconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["deliveredEvidenceRefs", "discrepancies"],
+      "properties": {
+        "deliveredEvidenceRefs": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 256,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 1024 }
+        },
+        "discrepancies": {
+          "type": "array",
+          "maxItems": 128,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["dimension", "statement"],
+            "properties": {
+              "dimension": { "$ref": "#/$defs/identifier" },
+              "statement": { "type": "string", "minLength": 1, "maxLength": 4096 }
+            }
+          }
+        }
+      }
+    }
+  }
+}