gotchas

Index project-specific production pitfalls with stable anchor lookup and pre-build checklists.

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/dain-agency/mood-tracker --skill gotchas-dain-agency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gotchas
Source: https://github.com/dain-agency/mood-tracker/tree/main/.claude/skills/gotchas
Command: npx skills add https://github.com/dain-agency/mood-tracker --skill gotchas-dain-agency

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of repeated, time-consuming debugging of avoidable production issues, loss of institutional knowledge about known project pitfalls, and overlooked mistakes during code writing, review, and planning by providing a centralized, section-aware reference of hard-won production lessons.

Core Features & Use Cases

  • Section-Aware Fast Lookup: Gotchas are indexed with stable anchor comments, so you can pull only the relevant section instead of loading the entire document, saving context space.
  • Role-Specific Workflow Support: Includes pre-build checklists for common frontend and backend tasks, plus integration guidance for plan writers, builders, and reviewers to embed pitfall awareness into every stage of development.
  • Living Reference Maintenance: Provides clear instructions for adding new gotchas as they are discovered, ensuring the reference stays aligned with the project's evolving codebase and lessons learned.

Quick Start

Invoke the gotchas skill to retrieve the relevant production pitfalls for the backend API route you are building to ensure you follow required validation and tenant isolation rules.

Frequently Asked Questions about gotchas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I avoid common production pitfalls during code review?

To avoid common production pitfalls during code review, use a centralized gotchas reference with stable anchor lookup to check for known project issues, required zod validation, and tenant isolation rules. This preserves institutional knowledge and prevents repeated debugging.

What is the best way to maintain a pre-build checklist for frontend and backend tasks?

The best way to maintain a pre-build checklist for frontend and backend tasks is to use a living reference that provides role-specific workflow support, ensuring pitfall awareness is embedded into every stage of development and aligned with the evolving codebase.

How do I preserve institutional knowledge of known project issues in a shared codebase?

Preserve institutional knowledge of known project issues in a shared codebase by maintaining a section-aware index of curated gotchas, which provides clear instructions for adding newly discovered production lessons as the project evolves.

Can I retrieve specific gotchas for a backend API route without loading the entire reference document?

Yes, you can retrieve specific gotchas for a backend API route without loading the entire reference document because the gotchas are indexed with stable anchor comments, allowing you to pull only relevant sections and save context space.

Does pipeline integration guidance support cross-functional development roles like plan writers and reviewers?

Yes, pipeline integration guidance supports cross-functional development roles by providing integration instructions for plan writers, builders, and reviewers to embed pitfall awareness into code writing, review, and project planning.

When do I need to check zod validation and tenant isolation rules before building?

You need to check zod validation and tenant isolation rules before building whenever you are developing backend API routes, invoking a gotchas reference to retrieve relevant production pitfalls and ensure compliance with required validation standards.