environments

Solid

Adding a variable or secret, 'set up production', a domain or a provider token, 'which database is this', a leaked key: dev and production for an AI-built app, backups, incidents.

AI & Automation 633 stars 85 forks Updated today MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
93
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Environments — development, production, and what moves between them **Keep two of everything, never mixed.** Record every claim about which is which with the date checked. This skill covers separating environments, moving configuration and secrets, and changing schema while code still serves. It also covers leaks, failures and rebuilding. **Keep the principle and swap the mechanism on another stack.** These rules use Next.js (App Router), Supabase, Clerk and Netlify mechanisms after stating the principle. **The product's own instructions come first.** Follow its names for the environments doc, variables doc and branches. **Write to the product's records, whatever it calls them.** They hold: - The environments doc: which resource each environment uses, verified and dated, ending in the environment log, one row per environment event; - The variables doc: one row per variable, and where every copy of each secret lives; - The env schema: the one module that validates configuration, at build and at boot; - `.env`, the local configuration, never committed, and `.env.example`, its committed list of placeholders; - The backlog: deferred work, each item with its reason and the trigger that reopens it. ## What binds - **The target is stated, never inferred.** Every command that reads or writes an environment names it (a project ref, a URL, an instance) rather than inheriting it from whatever a config file was last left pointing at. A per-machine, gitignored config (an MCP serv...

Details

Author
phuryn
Repository
phuryn/product-engineering
Created
2 weeks ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category