Skip to content

hani-q/qstack / skills/qstack-encode-lessons-in-structure

qstack-encode-lessons-in-structure

Verified

Turn a recurring correction or repeated instruction into the strongest practical structural guardrail. Use when the same mistake returns, prose is being repeated, or a rule could become a type, schema, lint, check, or script.

Encode lessons in structure

Text asks every future reader to notice, remember, and comply. A structural mechanism applies the lesson without relying on memory.

Route the lesson

  1. Identify the concrete correction and evidence that it recurs. Keep a true one-off as local context instead of turning it into a universal rule.
  2. Choose the strongest practical mechanism:
    • a state or type that cannot represent the invalid case;
    • a schema, lint, banned API, or CI check that fails before merge;
    • one canonical helper or generator that removes duplicate choices;
    • a runtime boundary check with a clear failure;
    • a written instruction only when human judgment is irreducible.
  3. Implement the mechanism only when the user's request authorizes that edit. Otherwise propose the exact target and expected failure behavior.
  4. Remove prose or duplicate paths that the new mechanism supersedes. Keep one source of truth, but only after proving the mechanism covers the old rule.
  5. Exercise the known failure and show that the mechanism catches it.

Route recurring fixes to a local skill or tool and systemic rules to the smallest shared layer that can enforce them. Recording a lesson without a mechanism that enforces it does not stop the next occurrence. Do not invent recurrence; cite the correction or failure that shows the pattern. Analysis alone does not authorize edits, commits, pushes, publishing, deployment, or external messages.

Adapted from Lauren Tan's PStack principle-encode-lessons-in-structure at commit 60c641e4fad674784b30abcf9f8915dea39df38d under the MIT License. See third-party notices.

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