Codebase Simplification Guide

Codebase Simplification & Maintenance Guide

This skill provides guidelines on how to keep the repository clean, avoid over-engineering, and maintain high developer velocity.

1. Branch-First Development

> [!IMPORTANT] > CREATE A LOCAL BRANCH FIRST: Always start by creating a local branch from main: > ``bash > git switch -c MishraShardendu22/main/ > ` > Never develop or modify code directly on main`.

---

2. Core Principles

1. No Unwanted Infrastructure:

• Do not add Dockerfiles, docker-compose, Kubernetes manifests, Nginx configs, Prometheus/Grafana server setups, or Terraform scripts.
• Everything runs on native Vercel (Next.js, Python FastAPI) and Render (Go Fiber).

1. No Speculative Abstractions:

• Do not create interfaces or wrapper layers that have only a single implementation unless required for mocking in tests.
• Prefer straightforward, readable standard library code over heavy external frameworks.

1. Centralized Configuration:

• Never call os.Getenv or process.env in arbitrary component files.
• All environment access must go through the dedicated central module (backend/config, agentic-observatory/config, frontend/src/config/env.ts).

1. Zero Dead Code:

• Remove unused functions, structs, imports, scripts, and commented-out code during every refactoring pass.

1. Safe Database Practices:

• Never drop or truncate production tables.
• Always write idempotent migrations (CREATE TABLE IF NOT EXISTS).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MishraShardendu22
• Source: MishraShardendu22/agent-skills
• License: MIT
• Homepage: https://github.mishrashardendu22.is-a.dev

Install and usage instructions live in the source repository linked above.