Skip to content

hariharapanigrahy/layerkit / skills/layerkit-inventory-surfaces

layerkit-inventory-surfaces

Verified

Inventory package languages/surfaces for multi-lang heals; session file used by Layerkit to enforce all languages updated before PR.

FileKindSize
SKILL.mdskill md2.0 KB
---
name: layerkit-inventory-surfaces
description: Inventory package languages/surfaces for multi-lang heals; session file used by Layerkit to enforce all languages updated before PR.
---

# layerkit-inventory-surfaces

Before research/source-edit on a multi-language package, list **every language or surface** the package supports so Layerkit can block PR/handoff until each is `updated` or explicit `residual`.

This step is **required for heal and full**. Domain discover may be skipped on heal; **surfaces is never skipped**.

## Protocol

1. Walk the package (source:code): e.g. `**/server/node`, `server/python`, `server/ruby`, `server/php*`, `server/java`, `server/go`, `server/dotnet`, `server/nextjs`, client UIs.
2. Write session inventory:

```text
{projectDir}/memory/runbooks/surface-inventory.json
```

```json
{
  "schemaVersion": 1,
  "package": "org/repo",
  "languages": [
    {
      "id": "node",
      "roots": ["fixed-price-subscriptions/server/node"],
      "status": "pending"
    },
    {
      "id": "python",
      "roots": ["fixed-price-subscriptions/server/python"],
      "status": "pending"
    }
  ],
  "notes": "Inventoried from package layout; source:code"
}
```

3. Put the same JSON (or a pointer + summary) in mark-done `--evidence`.
4. Later, during **source-edit**, update each language:
   - `"status": "updated"` + `"paths": ["…/server.js"]` when production files for that language were changed, or
   - `"status": "residual"` + `"residual": "why not changed (SDK gap, out of scope, …)"`
5. Layerkit **rejects** source-edit complete / handoff while any language is still `pending`.

## Forbidden

- Listing only one language when the package clearly has more (freestyle single-lang heal)
- Marking `updated` without real paths
- Marking `residual` without a concrete residual reason
- Skipping this step on heal

## Success

- [ ] `surface-inventory.json` exists with ≥1 language and non-empty `roots[]`
- [ ] Evidence cites package layout (source:code)
- [ ] Agent understands that multi-lang completeness is enforced before PR
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall