Think Different

  In an AI-native engineering architecture, the skills.md file acts as a centralized agent capability index and skill-routing table within the hidden system context directory ( .gemini/ , .cursor/ , or .windsurf/ ). Its primary purpose is to solve the context window expansion problem by decoupling task intent from heavy architectural definitions. Instead of injecting all project rules, schemas, linting standards, and tooling instructions into the system prompt simultaneously—which wastes context budget and degrades reasoning— skills.md maintains a lightweight semantic index mapping agent goals to specific rule files or external tools. Core Architecture & Responsibilities Plaintext ┌────────────────────────┐ │ User / Agent Task │ └───────────┬────────────┘                          │ Reads S...

When executing multi-file refactors, I manage, restrict, and structure my local codebase context using a strict hierarchical filtering system designed to maximize accuracy and minimize token waste. Here is exactly how I structure and execute that process: 1. Discovery and Map Generation Before reading or editing any files, I construct an abstract map of the codebase. I do not pull full source code at this stage. Directory Trees: I run a shallow directory listing to understand the project's layout. Symbols and Signatures: I search for class definitions, method signatures, and export statements across the target modules. Dependency Graphs: I map out how the target files import one another to identify the upstream and downstream impacts of the refactor. 2. Context Restriction (The "Need-to-Know" Filter) To prevent token bloat and LLM confusion, I categorize files into three strict isolation zones: The Edit Zone: These are the exact files that require code modifications....