builder-conventions-k
Implementation practices — deviation protocol, progress tracking, code standards, codebase reflection
What this skill does
> **Knowledge skill** — Implementation practices: deviation protocol, progress tracking, code standards, codebase reflection.
# Build Conventions
## Resumption
Find the active plan, read it fully, check milestone progress markers, resume from the first incomplete step. Tell the user where you're picking up from.
## Deviation Protocol
Any deviation from the plan:
1. STOP — explain what differs from the plan
2. PROPOSE — how to handle it, with tradeoffs
3. CONFIRM — get user agreement
4. RECORD — update `{name}_decisions.md` with the deviation and rationale
5. CONTINUE
Never silently drift from the plan.
## Progress Tracking
After each milestone:
- Mark steps as `[x]` in the plan doc
- Add timestamped entry to the Progress section
- Record surprises in the Surprises section
- Record decisions in `{name}_decisions.md`
## Code Standards
- Write the simplest code that handles the full complex case
- No stubs, TODOs, or placeholders
- No try/catch unless actually handling the error meaningfully
- No copy-paste with minor modifications — extract shared logic
- Split files at ~200 lines, functions at ~30 lines
- Follow existing codebase patterns and naming conventions
## Codebase Reflection
As you write each file, pause:
- Does this follow patterns established in the codebase?
- Is naming consistent with surrounding code?
- Is there an existing utility I should use instead of writing new code?
- Could this be simpler?
- Surface observations to the user rather than silently deciding
Related in Data & Analytics
clawarr-suite
IncludedComprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr). Deep library exploration, analytics, dashboard generation, content management, request handling, subtitle management, indexer control, download monitoring, quality profile sync, library cleanup automation, notification routing, collection/overlay management, and media tracker integration (Trakt, Letterboxd, Simkl).
querying-soql
IncludedSOQL query generation, optimization, and analysis with 100-point scoring. Use this skill when the user needs SOQL/SOSL authoring or optimization: natural-language-to-query generation, relationship queries, aggregates, query-plan analysis, and performance or safety improvements for Salesforce queries. TRIGGER when: user writes, optimizes, or debugs SOQL/SOSL queries, touches .soql files, or asks about relationship queries, aggregates, or query performance. DO NOT TRIGGER when: bulk data operations (use handling-sf-data), Apex DML logic (use generating-apex), or report/dashboard queries.
app-store-optimization
IncludedApp Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
habit-flow
IncludedAI-powered atomic habit tracker with natural language logging, streak tracking, smart reminders, and coaching. Use for creating habits, logging completions naturally ("I meditated today"), viewing progress, and getting personalized coaching.
app-store-optimization
IncludedApp Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
visualizing-data
IncludedBuilds dashboards, reports, and data-driven interfaces requiring charts, graphs, or visual analytics. Provides systematic framework for selecting appropriate visualizations based on data characteristics and analytical purpose. Includes 24+ visualization types organized by purpose (trends, comparisons, distributions, relationships, flows, hierarchies, geospatial), accessibility patterns (WCAG 2.1 AA compliance), colorblind-safe palettes, and performance optimization strategies. Use when creating visualizations, choosing chart types, displaying data graphically, or designing data interfaces.