guides.json

{
    "hard-prohibition": {
        "moves": ["Name the action", "Explain the risk", "Give an alternative"],
        "projects": ["uv", "langflow", "pi"],
        "application": "Name the forbidden action, its consequence, and the permitted alternative. State any exceptions so the rule stays narrow."
    },
    "worked-examples": {
        "moves": ["Show the wrong case", "Show the right case", "Explain the difference"],
        "projects": ["better-auth", "hermes", "n8n"],
        "application": "Use a pair where prose leaves room for doubt. Put the unwanted and intended cases together, then name the difference."
    },
    "generated-file-guard": {
        "moves": ["Mark generated output", "Name its editable source", "Give the rebuild command"],
        "projects": ["effect", "pi", "anarlog"],
        "application": "Name the generated file, its editable source, and the rebuild command. Say whether to commit the output and which nearby files are still edited by hand."
    },
    "verification-matrix": {
        "moves": ["Identify the change", "Choose the matching checks", "Name gaps in coverage"],
        "projects": ["effect", "nextjs", "paperclip"],
        "application": "List the checks for each kind of change. Include required setup and anything the default command skips."
    },
    "nested-instructions": {
        "moves": ["Keep shared rules at root", "Put detail near the code", "State what takes precedence"],
        "projects": ["gitbutler", "openclaw"],
        "application": "Keep shared rules at the root and local rules beside the code. Explain how to find the applicable files and which one wins when they conflict."
    },
    "single-source": {
        "moves": ["Identify the authority", "Link to it", "Avoid copying its values"],
        "projects": ["workers-sdk", "omarchy", "pierre"],
        "application": "Point to the file that owns a changing fact instead of copying the value. Add only enough context to find and understand it."
    },
    "skill-routing": {
        "moves": ["Recognize the task", "Point to its guide", "Load it when needed"],
        "projects": ["nuqs", "pierre", "supabase"],
        "application": "Map common tasks to specific guides and say when to read them. Keep the entry file as an index; leave the detailed steps in the focused guides."
    },
    "behavioral-conditioning": {
        "moves": ["Name a recurring mistake", "Set a decision rule", "Make the action observable"],
        "projects": ["astro", "better-auth", "gitbutler"],
        "application": "Turn a recurring mistake into a decision the agent can act on: what to check before editing, when to stop expanding scope, or when a request should remain read-only."
    },
    "house-vocabulary": {
        "moves": ["Define the term", "Show where it applies", "Preserve literal identifiers"],
        "projects": ["airflow", "t3code", "voicestudio"],
        "application": "Define terms that are easy to confuse and say where the convention applies. Do not change literal identifiers or quoted source to match a prose rule."
    },
    "architecture-narrative": {
        "moves": ["Follow a request", "Name each owner", "Explain the boundaries"],
        "projects": ["humanlayer", "hunk", "supermemory"],
        "application": "Follow a request or piece of data through the system. Name who owns each step and why the boundaries exist."
    },
    "ratchet": {
        "moves": ["Name the baseline", "Set its allowed direction", "Check for regressions"],
        "projects": ["hunk", "n8n", "herdr"],
        "application": "Name the baseline and the only direction it may move. Include the enforcement command and any gaps that still need review."
    },
    "contribution-etiquette": {
        "moves": ["Identify the public action", "State who may take it", "Explain the review workflow"],
        "projects": ["deno", "turborepo", "varlock"],
        "application": "State who may open, post, or push something and what review steps come first. Include the rules for commit and pull-request text."
    },
    "scope-layering": {
        "moves": ["Identify the acting role", "Apply its permissions", "Define a fallback"],
        "projects": ["herdr", "nextjs", "turborepo"],
        "application": "Explain how to identify the contributor’s role before listing its permissions. Use the most restricted role when identity or access cannot be verified."
    },
    "context-budget": {
        "moves": ["Name the context owner", "Set a size limit", "Protect prompt stability"],
        "projects": ["codex", "hermes", "openclaw"],
        "application": "Give injected material an owner and a size limit. Say when it loads and which changes need extra review for cost or prompt stability."
    }
}